MyBatis持久層框架使用總結html
MyBatis 本是apache的一個開源項目iBatis, 2010年這個項目由apache software foundation 遷移到了google code,而且更名爲MyBatis 。java
2013年11月遷移到Github,MyBatis的Github地址:https://github.com/mybatis/mybatis-3。mysql
iBATIS一詞來源於「internet」和「abatis」的組合,是一個基於Java的持久層框架。iBATIS提供的持久層框架包括SQL Maps和Data Access Objects(DAO)。git
MyBatis 是支持普通 SQL查詢,存儲過程和高級映射的優秀持久層框架。MyBatis 消除了幾乎全部的JDBC代碼和參數的手工設置以及結果集的檢索。MyBatis 使用簡單的 XML或註解用於配置和原始映射,將接口和 Java 的POJOs(Plain Old Java Objects,普通的 Java對象)映射成數據庫中的記錄。github
每一個MyBatis應用程序主要都是使用SqlSessionFactory實例的,一個SqlSessionFactory實例能夠經過SqlSessionFactoryBuilder得到。SqlSessionFactoryBuilder能夠從一個xml配置文件或者一個預約義的配置類的實例得到。sql
MyBatis Generator下載地址:http://www.mybatis.org/generator/ 數據庫
MyBatis Generator中文介紹:http://generator.sturgeon.mopaas.com/ apache
如下用mybatis-generator-core-1.3.2.jar插件加jdbc數據庫鏈接包自動導出持久層dao包,model包和mapper包。api
須要用到的Java包有: 緩存
mybatis-generator-core-1.3.2.jar,
mysql-connector-java-5.1.34.jar,
ojdbc14-10.2.0.1.0.jar,
sqljdbc4-4.0.jar。
配置文件: generator.xml
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE generatorConfiguration PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN" "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd"> 3 <generatorConfiguration> 4 <!-- 配置屬性文件 用來在配置文件中引入變量 El表達式 --> 5 <!-- 若是是用cmd方式運行 這裏應該寫url方式寫全路徑 由於找不到classpath 對於resource來講 --> 6 <!-- 7 <properties url="file:///D:/workspaces/mybatisGen/bin/generatorConfig.properties"/> 8 --> 9 10 <!-- 數據庫驅動包位置 --> 11 12 <!-- SQL Server數據驅動包 --> 13 14 <classPathEntry location="D:\JavaProject\generator\sqljdbc4-4.0.jar" /> 15 16 <!-- Oracle數據驅動包 --> 17 <!-- 18 <classPathEntry location="D:\Java\m2\repository\com\oracle\ojdbc14\10.2.0.1.0\ojdbc14-10.2.0.1.0.jar" /> 19 --> 20 21 <!-- MySQL數據驅動包 --> 22 <!-- 23 <classPathEntry location="D:\JavaProject\generator\mysql-connector-java-5.1.34.jar" /> 24 --> 25 26 <!-- 此處指定生成針對MyBatis3的DAO--> 27 <!-- 28 id: 必須配置。這個上下文的唯一標識符。該值將被用在一些錯誤消息。 29 defaultModelType:用來定義生成模型類型策略。 30 1.conditional 默認策略,爲每一個表生成一個Model class 31 2.flat:將全部的表中生成一個Model class,即這個類將保存全部表中字段 32 3.hierarchical :若是表有一個主鍵,該模型將生成一個主鍵類,另外一個類,用於容納任何BLOB列在表中,和另外一個類,用於容納其他的字段。這個是一個適當的繼承類之間的關係。 33 34 targetRuntime:此屬性用於指定運行時目標生成的代碼。 35 1.MyBatis3 默認值 將生成對象兼容MyBatis版本3.0和更高版本,和JSE 5.0和更高版本 36 (例如Java模型和mapper接口將使用泛型類型)。 37 「by example」方法在這些生成的對象支持幾乎無限的動態where子句。 38 此外,Java對象與這些生成器生成支持許多JSE 5.0特性包括參數化的類型和註釋。 39 2.Ibatis2Java2 40 3.Ibatis2Java5 41 --> 42 43 <context id="MySQLTables" targetRuntime="MyBatis3" defaultModelType="conditional"> 44 45 <!-- 46 <plugin type="org.mybatis.generator.plugins.EqualsHashCodePlugin" /> 47 --> 48 49 <!-- 50 用來生成註釋 51 1. suppressAllComments 默認是false 此屬性用於指定在生成的代碼是否將包括任何註釋。若是設置爲true 則不生成註釋 52 2. suppressDate 默認是false 此屬性用於指定在生成的註釋是否將包括MBG代時間戳。 53 --> 54 55 <commentGenerator> 56 <property name="suppressAllComments" value="true" /> 57 </commentGenerator> 58 59 <!-- 數據庫連接URL、用戶名、密碼 --> 60 61 <!-- MySQL數據庫連接URL、用戶名、密碼 --> 62 <!-- 63 <jdbcConnection driverClass="com.mysql.jdbc.Driver" connectionURL="jdbc:mysql://127.0.0.1:3310/test" userId="test" password="1234"> 64 </jdbcConnection> 65 --> 66 67 <!-- Oracle數據庫連接URL、用戶名、密碼 --> 68 <!-- 69 <jdbcConnection driverClass="oracle.jdbc.driver.OracleDriver" connectionURL="jdbc:oracle:thin:@127.0.0.1:1521:orcl" userId="test" password="1234"> 70 </jdbcConnection> 71 --> 72 73 <!-- SQL Server數據庫連接URL、用戶名、密碼 --> 74 <jdbcConnection driverClass="com.microsoft.sqlserver.jdbc.SQLServerDriver" connectionURL="jdbc:sqlserver://127.0.0.1:1433;DatabaseName=test" userId="test" password="1234"> 75 </jdbcConnection> 76 77 <!-- H2 78 <entry key="jdbc.url">jdbc:h2:tcp://localhost/test</entry> 79 <entry key="jdbc.driver">org.h2.Driver</entry> 80 --> 81 82 <!-- SQLServer2000 83 <entry key="jdbc.url">jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=[database]</entry> 84 <entry key="jdbc.driver">com.microsoft.jdbc.sqlserver.SQLServerDriver</entry> 85 --> 86 87 <!-- SQLServer2005 88 <entry key="jdbc.url">jdbc:sqlserver://192.168.0.98:1433;DatabaseName=[database]</entry> 89 <entry key="jdbc.driver">com.microsoft.sqlserver.jdbc.SQLServerDriver</entry> 90 --> 91 92 <!-- JTDs for SQLServer 93 <entry key="jdbc.url">jdbc:jtds:sqlserver://192.168.0.102:1433/[database];tds=8.0;lastupdatecount=true</entry> 94 <entry key="jdbc.driver">net.sourceforge.jtds.jdbc.Driver</entry> 95 --> 96 97 <!-- PostgreSql 98 <entry key="jdbc.url">jdbc:postgresql://localhost/[database]</entry> 99 <entry key="jdbc.driver">org.postgresql.Driver</entry> 100 --> 101 102 <!-- Sybase 103 <entry key="jdbc.url">jdbc:sybase:Tds:localhost:5007/[database]</entry> 104 <entry key="jdbc.driver">com.sybase.jdbc.SybDriver</entry> 105 --> 106 107 <!-- DB2 108 <entry key="jdbc.url">jdbc:db2://localhost:5000/[database]</entry> 109 <entry key="jdbc.driver">com.ibm.db2.jdbc.app.DB2Driver</entry> 110 --> 111 112 <!-- HsqlDB 113 <entry key="jdbc.url">jdbc:hsqldb:mem:generatorDB</entry> 114 <entry key="jdbc.driver">org.hsqldb.jdbcDriver</entry> 115 --> 116 117 <!-- Derby 118 <entry key="jdbc.url">jdbc:derby://localhost/databaseName</entry> 119 <entry key="jdbc.driver">org.apache.derby.jdbc.ClientDriver</entry> 120 --> 121 122 <!-- java類型解析器 可選配置 --> 123 <!-- 124 <javaTypeResolver type=""> 125 type屬性: 這可用於指定一個用戶提供的Java類型解析器。這個類必須實現接口org.mybatis.generator.api。 126 JavaTypeResolver,必須有一個公共的默認構造函數。屬性還能夠接受特殊的值默認在這種狀況下,將使用默認的實現(這一樣的效果不指定類型)。 127 該標籤支持的屬性: 128 forceBigDecimals:默認是false 是否強制使用BigDecimal來表示全部的十進制和數值字段。 129 •若是規模很大,長度大於18,將使用BigDecimal類型。 130 •若是其長度爲10到18,則Java類型解析器將java.lang.Long來代替了。 131 •若是長度爲5到9,而後Java類型解析器將替換爲一個Java.lang.integer。 132 •若是其長度小於5,則Java類型解析器將以java.lang.Short替代。 133 --> 134 135 <javaTypeResolver> 136 <property name="forceBigDecimals" value="false" /> 137 </javaTypeResolver> 138 139 <!-- 生成vo對象 --> 140 <!-- 141 < javaModelGenerator >元素用於定義Java模型生成的屬性。 142 Java模型生成器創建主鍵類,記錄類,和查詢示例類相匹配的表進行自省。這個元素是所需的子元素<上下文>元素。 143 支持的屬性: 144 constructorBased: 145 此屬性用於選擇是否MyBatis生成器將生成一個類的構造函數,它接受一個值類中的每一個字段。同時,SQL結果地圖將建成投入使用構造函數而不是「setter」每一個字段。 146 這個屬性是隻適用於MyBatis3和將被忽略了iBATIS2。 147 默認值是false。 148 immutable: 149 不可變,此屬性用於選擇是否MyBatis生成器將產生不可變模型類——這意味着類不會有「setter」方法和構造函數會接受類中每一個字段的值。默認爲false。 150 trimStrings: 151 此屬性用於選擇MyBatis生成器是否添加代碼來修剪的字符字段從數據庫返回的空白空間。 152 這頗有用,若是您的數據庫將數據存儲在字符字段而不是VARCHAR字段。MyBatis生成器將插入代碼來削減字符字段。 153 默認值是false。 154 --> 155 <!-- 生成實體類的包名和位置,這裏配置將生成的實體類放在com.ouc.model這個包下 --> 156 <javaModelGenerator targetPackage="com.ouc.model" targetProject="D:\JavaProject\generator\src"> 157 <property name="enableSubPackages" value="true" /> 158 <property name="trimStrings" value="true" /> 159 </javaModelGenerator> 160 161 <!-- 生成用於查詢的mapping對象 --> 162 <!-- 生成的SQL映射文件包名和位置,這裏配置將生成的SQL映射文件放在com.ouc.mapping這個包下 --> 163 <sqlMapGenerator targetPackage="com.ouc.mapping" targetProject="D:\JavaProject\generator\src"> 164 <property name="enableSubPackages" value="true" /> 165 </sqlMapGenerator> 166 167 <!-- 生成DAO的類文件以及配置文件 --> 168 <!-- 169 < javaClientGenerator >元素是用來定義Java客戶機代碼生成器的屬性。 170 Java客戶機生成器用來創建Java接口和類,以即可以方便地使用生成的Java模型和XML映射文件。 171 對於iBATIS2目標環境,這些生成的對象採用形式的DAO接口和實現類。 172 對於MyBatis,生成的對象採用mapper形式的接口。 173 這個元素是一個可選的子元素。 174 若是你不指定這個元素,MyBatis生成器(MBG)不會生成Java客戶端接口和類。 175 其中的type屬性: 176 若是targetRuntime 爲MyBatis3 177 XMLMAPPER:生成的對象將Java接口MyBatis 3.x mapper基礎設施。接口將會依賴生成的XML映射器文件。通常都是使用這個XMLMAPPER. 178 --> 179 <!-- 生成DAO的包名和位置,這裏配置將生成的dao類放在com.ouc.dao這個包下 --> 180 <javaClientGenerator type="XMLMAPPER" targetPackage="com.ouc.dao" targetProject="D:\JavaProject\generator\src"> 181 <property name="enableSubPackages" value="true" /> 182 </javaClientGenerator> 183 184 <!-- 185 <table>元素用於選擇數據庫中的一個表。選擇的表將致使爲每一個表生成如下對象: 186 •一個MyBatis / iBATIS•格式化的SQL的映射文件 187 •一組類,造成了「模型」表包括: 188 •一個類來匹配•表的主鍵(若是表有一個主鍵)。 189 •表中字段匹配的,不是在主鍵,而非BLOB字段。這個類將擴展主鍵,若是有一個。 190 •一個類來持有任何表中的BLOB字段(若是有的話)。這個類將擴展其中一個的前面兩個類取決於表的配置。 191 •一個類,用於生成動態where子句,在不一樣的「by Example」方法(selectByExample,deleteByExample)。 192 •(可選)DAO接口和類 193 194 tableName:必須配置 指定表的名稱 195 domainObjectName:生成javabean對象的基本名稱。若是未指定,MBG將自動基於表名生成。 196 這個名字(不管是在這裏指定,或自動生成)將被用來做爲域類名和DAO類的名字。 197 enableInsert:是否生成插入語句。默認是true 198 enableSelectByPrimaryKey:是否經過主鍵生成選擇語句。不論是否有這種設置,若是該表沒有一個主鍵將不會生成。 199 enableUpdateByPrimaryKey:是否經過主鍵生成更新語句。若是該表沒有主鍵,不論是否設置該屬性,語句將不會生成。 200 enableDeleteByPrimaryKey:是否經過主鍵生成刪除語句。若是該表沒有主鍵,無論這種設置該屬性,語句將不會生成。 201 enableDeleteByExample:是否經過example對象生成刪除語句。這個聲明使得許多不一樣的動態刪除在運行時生成。 202 enableCountByExample:是否經過example對象生成計算行數語句。該語句將返回一個表中的行數相匹配的example。 203 enableUpdateByExample:是否經過example對象生成更新語句。該語句將更新一個表中相匹配的記錄。 204 205 selectByPrimaryKeyQueryId:這個值將被添加到選擇列表中選擇經過主鍵的聲明在本表格:「' <值>做爲QUERYID」。這能夠用於識別查詢在DBA在運行時跟蹤工具。若是你需使用,你應該指定一個惟一的id爲每一個不一樣的查詢生成MBG。 206 selectByExampleQueryId:這個值將被添加到選擇列表中選擇經過例子的聲明在本表格:「' <值>做爲QUERYID」。這能夠用於識別查詢在DBA在運行時跟蹤工具。若是你需使用,你應該指定一個惟一的id爲每一個不一樣的查詢生成MBG。 207 enableSelectByExample:是否應該生成經過example的選擇語句。這個聲明使得許多不一樣的動態查詢是在運行時生成。 208 209 modelType:此屬性用於覆蓋默認的模型類型,若是你想對這張表這麼作。若是未指定,MBG將生成的域對象基於上下文默認的模型類型。 210 該模型類型定義瞭如何將生成MBG域類。 211 一些模型類型MBG將生成一個單一的域類爲每一個表,和其餘可能產生不一樣的類MBG取決於表的結構。 212 escapeWildcards:排除通配符。這意味着不管SQL通配符(' _ '和' % ')的模式和表名都應該避免在搜尋列。 213 這是一些驅動要求若是模式或表包含一個SQL通配符(例如,若是一個表的名字是MY_TABLE,一些驅動要求的下劃線字符進行轉義)。 214 --> 215 216 <!-- 要生成那些表(更改tableName和domainObjectName就能夠) --> 217 <table tableName="V_SupplyUser" domainObjectName="VSupplyUser" enableCountByExample="false" enableUpdateByExample="false" enableDeleteByExample="false" enableSelectByExample="false" selectByExampleQueryId="false" /> 218 <table tableName="WJ_GateList" domainObjectName="WJGateList" enableCountByExample="false" enableUpdateByExample="false" enableDeleteByExample="false" enableSelectByExample="false" selectByExampleQueryId="false" /> 219 </context> 220 </generatorConfiguration>
打開cmd命令行,轉到配置文件所在的文件下,執行以下生成語句:
java -jar mybatis-generator-core-1.3.2.jar -configfile generator.xml -overwrite
命令執行完畢,能夠看到對應路徑下生成dao包,model包和mapper包文件。
① 緩存配置(Cache):cacheEnabled:全局開關:默認是true,若是它配成false,其他各個Mapper XML文件配成支持cache也沒用。
② 延遲加載:
lazyLoadingEnabled:true使用延遲加載,false禁用延遲加載,默認爲true,當禁用時, 全部關聯對象都會即時加載。
aggressiveLazyLoading:true啓用時,當延遲加載開啓時訪問對象中一個懶對象屬性時,將徹底加載這個對象的全部懶對象屬性。false,當延遲加載時,按需加載對象屬性(即訪問對象中一個懶對象屬性,不會加載對象中其餘的懶對象屬性)。默認爲true。
③ multipleResultSetsEnabled:容許和不容許單條語句返回多個數據集(取決於驅動需求)。默認爲true。
④ useColumnLabel:使用列標籤代替列名稱。不一樣的驅動器有不一樣的作法。參考一下驅動器文檔,或者用這兩個不一樣的選項進行測試一下。
⑤ useGeneratedKeys:容許JDBC生成主鍵。須要驅動器支持。若是設爲了true,這個設置將強制使用被生成的主鍵,有一些驅動器不兼容不過仍然能夠執行。
⑥ autoMappingBehavior:指定MyBatis 是否而且如何來自動映射數據表字段與對象的屬性。PARTIAL將只自動映射簡單的,沒有嵌套的結果。FULL 將自動映射全部複雜的結果。
⑦ defaultExecutorType:配置和設定執行器,SIMPLE執行器執行其它語句。REUSE執行器可能重複使用prepared statements語句,BATCH執行器能夠重複執行語句和批量更新。
⑧ defaultStatementTimeout:設置一個時限,以決定讓驅動器等待數據庫迴應的多長時間爲超時。
完整sqlMapConfig.xml配置文件以下:
1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE configuration 3 PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 4 "http://mybatis.org/dtd/mybatis-3-config.dtd"> 5 6 <configuration> 7 <settings> 8 <setting name="cacheEnabled" value="true" /> 9 <setting name="lazyLoadingEnabled" value="true" /> 10 <setting name="multipleResultSetsEnabled" value="true" /> 11 <setting name="useColumnLabel" value="true" /> 12 <setting name="useGeneratedKeys" value="false" /> 13 <setting name="autoMappingBehavior" value="PARTIAL" /> 14 <setting name="defaultExecutorType" value="SIMPLE" /><!-- SIMPLE REUSE BATCH --> 15 <!-- <setting name="defaultExecutorType" value="BATCH" /> --> 16 <setting name="defaultStatementTimeout" value="25000" /> 17 <setting name="safeRowBoundsEnabled" value="false" /> 18 <setting name="mapUnderscoreToCamelCase" value="false" /> 19 <setting name="localCacheScope" value="SESSION" /> 20 <!-- <setting name="jdbcTypeForNull" value="OTHER" /> --> 21 <setting name="jdbcTypeForNull" value="NULL" /> 22 <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString" /> 23 </settings> 24 <typeAliases> 26 <!-- 模塊 --> 37 <typeAlias alias="User" type="com.ouc.mkhl.platform.authority.model.User"/> 39 <typeAlias alias="Role" type="com.ouc.mkhl.platform.authority.model.Role"/> 73 <typeAlias alias="Equipment" type="com.ouc.mkhl.platform.basedata.model.Equipment"/> 74 <typeAlias alias="Factory" type="com.ouc.mkhl.platform.basedata.model.Factory"/> 152 </typeAliases> 153 154 <typeHandlers> 155 <typeHandler handler="com.ouc.openplatform.dao.mybatis.SerializableTypeHandler"/> 156 </typeHandlers> 157 </configuration>
序列化特殊值處理:SerializableTypeHandler
1 package com.ouc.openplatform.dao.mybatis; 2 3 import java.io.Serializable; 4 import java.sql.CallableStatement; 5 import java.sql.PreparedStatement; 6 import java.sql.ResultSet; 7 import java.sql.SQLException; 8 9 import org.apache.ibatis.type.BaseTypeHandler; 10 import org.apache.ibatis.type.JdbcType; 11 12 /** 13 * @author WuPing 14 */ 15 public class SerializableTypeHandler extends BaseTypeHandler<Serializable> { 16 17 @Override 18 public void setNonNullParameter(PreparedStatement ps, int i, Serializable parameter, JdbcType jdbcType) 19 throws SQLException { 20 ps.setObject(i, parameter); 21 } 22 23 @Override 24 public Serializable getNullableResult(ResultSet rs, String columnName) 25 throws SQLException { 26 return (Serializable)rs.getObject(columnName); 27 } 28 29 @Override 30 public Serializable getNullableResult(ResultSet rs, int columnIndex) 31 throws SQLException { 32 return (Serializable)rs.getObject(columnIndex); 33 } 34 35 @Override 36 public Serializable getNullableResult(CallableStatement cs, int columnIndex) 37 throws SQLException { 38 return (Serializable)cs.getObject(columnIndex); 39 } 40 41 }
MyBatis中在查詢進行select映射的時候,返回類型能夠用resultType,也能夠用resultMap,resultType是直接表示返回類型的,而resultMap則是對外部ResultMap的引用,可是resultType跟resultMap不能同時存在。在MyBatis進行查詢映射的時候,其實查詢出來的每個屬性都是放在一個對應的Map裏面的,其中鍵是屬性名,值則是其對應的值。當提供的返回類型屬性是resultType的時候,MyBatis會將Map裏面的鍵值對取出賦給resultType所指定的對象對應的屬性。因此其實MyBatis的每個查詢映射的返回類型都是ResultMap,只是當咱們提供的返回類型屬性是resultType的時候,MyBatis對自動的給咱們把對應的值賦給resultType所指定對象的屬性,而當咱們提供的返回類型是resultMap的時候,由於Map不能很好表示領域模型,咱們就須要本身再進一步的把它轉化爲對應的對象,這經常在複雜查詢中頗有做用。
示例:UserBaseResultMap
<resultMap id="UserBaseResultMap" type="User" > <id column="id" property="id" jdbcType="INTEGER" /> <result column="userName" property="userName" jdbcType="VARCHAR" /> <result column="password" property="password" jdbcType="VARCHAR" /> <result column="email" property="email" jdbcType="VARCHAR" /> <result column="trueName" property="trueName" jdbcType="VARCHAR" /> <result column="sex" property="sex" jdbcType="VARCHAR" /> <result column="age" property="age" jdbcType="INTEGER" /> <result column="telephone" property="telephone" jdbcType="VARCHAR" /> </resultMap>
model類:User
1 package com.ouc.mkhl.platform.authority.model; 2 3 import java.io.Serializable; 4 5 //用戶信息 6 public class User implements Serializable { 7 8 private static final long serialVersionUID = 1098321123L; 9 10 private Integer id; //用戶Id 11 12 private String userName; //用戶名 13 14 private String password; //未加密密碼 15 16 private String email; //郵箱 17 18 private String trueName; //真實姓名 19 20 private String sex; //性別 21 22 private Integer age; //年齡 23 24 private String telephone; //手機 25 26 public Integer getId() { 27 return id; 28 } 29 30 public void setId(Integer id) { 31 this.id = id; 32 } 33 34 public String getUserName() { 35 return userName; 36 } 37 38 public void setUserName(String userName) { 39 this.userName = userName == null ? null : userName.trim(); 40 } 41 42 public String getPassword() { 43 return password; 44 } 45 46 public void setPassword(String password) { 47 this.password = password == null ? null : password.trim(); 48 } 49 50 public String getEmail() { 51 return email; 52 } 53 54 public void setEmail(String email) { 55 this.email = email == null ? null : email.trim(); 56 } 57 58 public String getTrueName() { 59 return trueName; 60 } 61 62 public void setTrueName(String trueName) { 63 this.trueName = trueName == null ? null : trueName.trim(); 64 } 65 66 public String getSex() { 67 return sex; 68 } 69 70 public void setSex(String sex) { 71 this.sex = sex == null ? null : sex.trim(); 72 } 73 74 public Integer getAge() { 75 return age; 76 } 77 78 public void setAge(Integer age) { 79 this.age = age; 80 } 81 82 public String getTelephone() { 83 return telephone; 84 } 85 86 public void setTelephone(String telephone) { 87 this.telephone = telephone == null ? null : telephone.trim(); 88 } 89 90 }
(1)select查詢:
① id:在這個模式下惟一的標識符,可被其它語句引用。
② parameterType:傳給此語句的參數的完整類名或別名。
③ resultType:語句返回值類型的整類名或別名。注意,若是是集合,那麼這裏填寫的是集合的項的整類名或別名,而不是集合自己的類名。(resultType 與resultMap 不能並用)
④ resultMap:引用的外部resultMap名。結果集映射是MyBatis 中最強大的特性。許多複雜的映射均可以輕鬆解決。(resultType 與resultMap 不能並用)
⑤ flushCache:若是設爲true,則會在每次語句調用的時候就會清空緩存。select語句默認設爲false。
⑥ useCache:若是設爲true,則語句的結果集將被緩存。select語句默認設爲false。
⑦ timeout :設置驅動器在拋出異常前等待迴應的最長時間,默認爲不設值,由驅動器本身決定。
示例:查詢全部用戶信息:selectUsers
<select id="selectUsers" resultMap="UserBaseResultMap"> select id,userName,email from user </select>
(2) insert插入:saveUser
此處數據庫表使用主鍵自增,主鍵爲id。
① fetchSize:設置一個值後,驅動器會在結果集數目達到此數值後,激發返回,默認爲不設值,由驅動器本身決定。
② statementType:statement,preparedstatement,callablestatement。預準備語句、可調用語句。
③ useGeneratedKeys:使用JDBC的getGeneratedKeys方法來獲取數據庫本身生成的主鍵(MySQL、SQLSERVER等關係型數據庫會有自動生成的字段)。
④ keyProperty:標識一個將要被MyBatis設置進getGeneratedKeys的key所返回的值,或者爲insert語句使用一個selectKey子元素。
<insert id="saveUser" parameterType="User" > insert into user (userName, password, email, trueName, sex, age, telephone) values (#{userName,jdbcType=VARCHAR}, #{password,jdbcType=VARCHAR}, #{email,jdbcType=VARCHAR}, #{trueName,jdbcType=VARCHAR}, #{sex,jdbcType=VARCHAR}, #{age,jdbcType=INTEGER}, #{telephone,jdbcType=VARCHAR}) </insert>
(3)update更新:動態更新SQL:updateUser
<update id="updateUser" parameterType="User" > update user <set > <if test="userName != null" > userName = #{userName,jdbcType=VARCHAR}, </if> <if test="password != null" > password = #{password,jdbcType=VARCHAR}, </if> <if test="email != null" > email = #{email,jdbcType=VARCHAR}, </if> <if test="trueName != null" > trueName = #{trueName,jdbcType=VARCHAR}, </if> <if test="sex != null" > sex = #{sex,jdbcType=VARCHAR}, </if> <if test="age != null" > age = #{age,jdbcType=INTEGER}, </if> <if test="telephone != null" > telephone = #{telephone,jdbcType=VARCHAR}, </if> </set> where id = #{id,jdbcType=INTEGER} </update>
(4)delete刪除:deleteUser
<delete id="deleteUser" parameterType="Integer"> delete from user where id = #{id,jdbcType=INTEGER} </delete>
(5)sql: Sql元素用來定義一個能夠複用的SQL語句段,供其它語句調用。
<sql id="UserBaseColumnList" > userName, password, email, telephone </sql> <select id="getUsers" resultMap="UserBaseResultMap"> select <include refid="UserBaseColumnList" /> from user </select>
(6)參數:parameters:MyBatis可使用基本數據類型和Java的複雜數據類型。
基本數據類型,String,int,date等。
使用基本數據類型,只能提供一個參數,因此須要使用Java實體類,或Map類型作參數類型。經過#{}能夠直接獲得其屬性。
① 基本數據類型參數:String
<select id="getUserByName" resultType="User" parameterType="String" > select id, userName, email from user where userName = #{userName,jdbcType=VARCHAR} </select>
Java代碼:
public User getUserByName(String name); // 根據用戶名獲取用戶信息
② Java實體類型參數:User
<insert id="saveUser" parameterType="User" > insert into user (userName, password, email, trueName, sex, age, telephone) values (#{userName,jdbcType=VARCHAR}, #{password,jdbcType=VARCHAR}, #{email,jdbcType=VARCHAR}, #{trueName,jdbcType=VARCHAR}, #{sex,jdbcType=VARCHAR}, #{age,jdbcType=INTEGER}, #{telephone,jdbcType=VARCHAR}) </insert>
Java代碼:
public int saveUser(User user); // 插入用戶信息
③ Map參數:Map<String, Object> recordMap
<select id="selectChildGroupTotalNum" resultType="Integer" > select count(*) from groupinfo <trim prefix="WHERE" prefixOverrides="AND|OR"> and id in <foreach collection="idStr" item="ids" open="(" separator="," close=")"> #{ids} </foreach> <if test="name!= null and name!='' " > and name LIKE CONCAT(CONCAT('%', #{name}),'%') </if> <if test="description!= null and description!='' " > AND description LIKE CONCAT(CONCAT('%', #{description}),'%') </if> <if test="type != null and type!=-1 " > AND type = #{type,jdbcType=INTEGER} </if> <if test="category != null and category!=-1 " > AND category = #{category,jdbcType=INTEGER} </if> </trim> </select>
Java代碼:
//獲取子組總記錄數 public int selectChildGroupTotalNum(Map<String, Object> recordMap);
Map<String, Object> recordMap = new HashMap<String, Object>(); recordMap.put("idStr", group.getChildgroupids().split(",")); recordMap.put("name", name); recordMap.put("description", description); recordMap.put("type", -1); recordMap.put("category", -1); childGroupTotalNum = groupDao.selectChildGroupTotalNum(recordMap);
④ 多參數:
方法一:按順序傳遞參數。
<!-- 根據參數名查詢參數 --> <select id="selectSensorNobySensorName" resultType="Integer" useCache="false" flushCache="true"> select SensorNo from sensorconfig where Name = #{0} and TestunitNo = #{1} and LABCODE = #{2} </select>
Java代碼:
//根據參數名查詢參數ID public int selectSensorNobySensorName(String sensorName, int testUnitNo, String labCode);
方法二:接口參數上添加@Param註解。
<select id="selectByUserNameAndVCode" resultMap="UserBaseResultMap"> select id, userName from user <trim prefix="WHERE" prefixOverrides="AND|OR"> <if test="userName!= null and userName!='' "> and userName LIKE CONCAT(CONCAT('%', #{userName}),'%') </if> <if test="supplierno!= null and supplierno!='' "> and supplierNo LIKE CONCAT(CONCAT('%', #{supplierno}),'%') </if> and supplierNo != 'test' </trim> LIMIT #{startIndex},#{pageSize} </select>
Java代碼:
// 根據用戶名和V碼查詢用戶信息 public List<User> selectByUserNameAndVCode( @Param("userName") String userName, @Param("supplierno") String supplierno, @Param("startIndex") int startIndex, @Param("pageSize") int pageSize);
selectKey標籤,if標籤,if + where的條件判斷,if + set的更新語句,if + trim代替where/set標籤,trim代替set,choose (when, otherwise),foreach標籤。動態SQL語句算是MyBatis最靈活的部分吧,用好了很是方便。
示例:selectTotalNumByAccountType
<select id="selectTotalNumByAccountType" resultType="Integer" > select count(*) from user <trim prefix="WHERE" prefixOverrides="AND|OR"> and id not in <foreach collection="idStr" item="ids" open="(" separator="," close=")"> #{ids} </foreach> <if test="userName!= null and userName!='' "> and userName LIKE CONCAT(CONCAT('%', #{userName}),'%') </if> <if test="supplierno!= null and supplierno!='' "> and supplierNo LIKE CONCAT(CONCAT('%', #{supplierno}),'%') </if> <if test="trueName!= null and trueName!='' "> and trueName LIKE CONCAT(CONCAT('%', #{trueName}),'%') </if> AND accountType = #{accountType} </trim>
</select>
能夠查看的文章:
1. MyBatis學習 之 3、動態SQL語句:http://limingnihao.iteye.com/blog/782190
2.MyBatis和Hibernate相比,優點在哪裏? https://www.zhihu.com/question/21104468
3.【持久化框架】Mybatis簡介與原理: http://blog.csdn.net/jiuqiyuliang/article/details/45286191
4.MyBatis學習總結(一)——MyBatis快速入門: http://www.cnblogs.com/xdp-gacl/p/4261895.html
5.利用mybatis-generator自動生成代碼: http://www.cnblogs.com/yjmyzz/p/4210554.html
6.MyBatis Generator介紹: http://generator.sturgeon.mopaas.com/