MyBatis 本是apache的一個開源項目iBatis, 2010年這個項目由apache software foundation 遷移到了 code，并且改名為MyBatis 。
2013年11月遷移到Github，MyBatis的Github地址：https://github.com/mybatis/mybatis-3。
iBATIS一詞來源于“internet”和“abatis”的組合，是一個基于Java的持久層框架。iBATIS提供的持久層框架包括SQL Maps和Data Access Objects（DAO）。
MyBatis 是支持普通 SQL查詢，存儲過程和高級映射的持久層框架。MyBatis 消除了幾乎所有的JDBC代碼和參數的手工設置以及結果集的檢索。MyBatis 使用簡單的 XML或注解用于配置和原始映射，將接口和 Java 的POJOs（Plain Old Java Objects，普通的 Java對象）映射成數據庫中的記錄。
每個MyBatis應用程序主要都是使用SqlSessionFactory實例的，一個SqlSessionFactory實例可以通過SqlSessionFactoryBuilder獲得。SqlSessionFactoryBuilder可以從一個xml配置文件或者一個預定義的配置類的實例獲得。
1.使用Generator自動生成Dao層，Model層和Mapper層。
MyBatis Generator下載地址：http://www.mybatis.org/generator/
MyBatis Generator中文介紹：http://generator.sturgeon.mopaas.com/
以下用mybatis-generator-core-1.3.2.jar插件加jdbc數據庫連接包自動導出持久層dao包，model包和mapper包。
需要用到的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
View Code
打開cmd命令行，轉到配置文件所在的文件下，執行如下生成語句：
java -jar mybatis-generator-core-1.3.2.jar -configfile generator.xml -overwrite
命令執行完畢，可以看到對應路徑下生成dao包，model包和mapper包文件。
2.MyBatis框架整合
1）MyBatis使用參數配置：sqlMapConfig.xml。
① 緩存配置(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
View Code
2）結果集resultMap：
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
View Code
3）增刪改查：
（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);
4）動態SQL語句：
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>
