映射器是MyBatis最強大的工具匹耕，也是我們使用MyBatis時用得最多的工具聚请，因此熟練掌握它十分必要。
1.映射器的主要元素
- 1.cache
給定命名空間的緩存配置
- 2.cache-ref
其他命名空間緩存配置的引用
- 3.resultMap
用來描述從數(shù)據(jù)庫結(jié)果集中來加載對象稳其，也是最復(fù)雜最強大的
- 4.sql
可被其他語句引用的可重用語句塊
- 5.增刪改查
insert\delete\update\select
6.parameterMap（參數(shù)映射關(guān)系）
2.select元素
select元素幫助我們從數(shù)據(jù)庫中讀出數(shù)據(jù)驶赏，把結(jié)果集組裝成我們需要的pojo對象。
2.1 select元素的配置屬性
- 1.id（必填）
命名空間的唯一標識既鞠，可以在通過此id來引用它煤傍。并且與mapper的namespace進行組合成包中唯一的標識，提供給MyBatis調(diào)用嘱蛋，如果不唯一蚯姆，則會報錯。
-
2.parameterMap（廢棄）
- 3.parameterType（可選）
傳入SQL語句的參數(shù)類型洒敏×淞担可以是類型的完全限定名，也可以是自定義的typeAliases別名凶伙。
- 4.resultType
定義類的全路徑郭毕，在允許自動匹配的情況下，結(jié)果集將通過JavaBean的規(guī)范映射函荣。也可以使用別名显押。但是不能與resultMap一起使用。
- 5.resultMap
它是映射集的引用傻挂，將執(zhí)行強大的映射功能乘碑，我們可以使用resultType或者resultMap其中的一個。但是通過resultMap我們可以自定義映射規(guī)范金拒。
- 6.flushCache
boolean屬性兽肤，默認值為false。它的作用是在調(diào)用SQL后殖蚕，要求MyBatis清空之前查詢的本地緩存和二級緩存轿衔。
- 7.useCache
boolean屬性，默認值為true睦疫。啟動二級緩存的開關(guān)，要求MyBatis將此次結(jié)果緩存鞭呕。
- 8.timeout
設(shè)置超時時間蛤育，等超時的時候?qū)伋霎惓！挝粸槊搿?/p>
- 9.fetchSize
獲取記錄總條數(shù)設(shè)定
- 10.statementType
枚舉屬性，三個枚舉值：statement瓦糕、preparedstatement底洗、callablestatement。默認值為preparedstatement咕娄。告訴MyBatis使用哪個JDBC的statement工作亥揖。
- 11.resultSetType
這是對JDBC的resultSet接口而言。兩個屬性：Forward_only(游標允許向前訪問)圣勒、Scroll_sensitive(雙向滾動费变，但是不及時更新，就是如果數(shù)據(jù)庫里的數(shù)據(jù)修改過圣贸，并不在resultSet總反應(yīng)出來)挚歧、Scroll_insensitive(雙向滾動，及時跟蹤數(shù)據(jù)庫的更新吁峻，以便更新resultSet數(shù)據(jù))
- 12.databseId
設(shè)置數(shù)據(jù)庫廠商的標識滑负。
- 13.resultOrdered
boolean屬性，默認值為false用含。這個設(shè)置僅僅適用嵌套結(jié)果集select語句矮慕。
- 14.resultSets（很少使用）
適合于多個結(jié)果集的情況，它將列出執(zhí)行SQL后每個結(jié)果集的名稱，每個名稱之間用逗號分隔企锌。
2.2 小例子
- 1.創(chuàng)建表
CREATE TABLE `user` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`name` varchar(45) DEFAULT NULL,
`age` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
- 2.創(chuàng)建POJO
public class User {
private int id;
private String name;
private int age;
//省略getter粪糙、setter
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", age=" + age +
'}';
}
}
- 3.定義Dao接口定義
package dao;
import model.User;
public interface IUserDao {
/**
* 通過主鍵查詢用戶
* @param id
* @return
*/
User getUserById(int id);
}
- 4.定義User對應(yīng)的Mapper文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="dao.IUserDao">
<select id="getUserById" parameterType="int" resultType="model.User">
select * from user where id=#{id};
</select>
</mapper>
這個語句被稱作getUserById，接受一個int或者Integer類型參數(shù)夏跷。返回model.User類型對象。
2.3 自動映射POJO屬性
從上面的小例子明未，可以看到槽华，我們數(shù)據(jù)庫定義的列名與POJO的屬性名稱是一樣的。那么趟妥，MyBatis會幫助我們自動將數(shù)據(jù)庫的列名與POJO屬性映射起來猫态。（PS:因為MyBatis.xml里面的setting屬性里面的autoMappingBehavior的默認值是Partial）
2.4 傳遞多個參數(shù)方式
上面的例子，我們的查詢的參數(shù)只有一個披摄，我們可以在select標簽內(nèi)定義查詢參數(shù)類型亲雪。但是如果超過2個以及2個以上，就需要換種方式處理疚膊。
- 1.使用注解方式傳參
使用MyBatis的參數(shù)注解@Param(org.apache.ibatis.annotations.Param)來實現(xiàn)义辕。使用此方式的好處就是無需在mapper的select標簽內(nèi)定義請求參數(shù)的類型。
public interface IUserDao {
/**
* 通過主鍵查詢用戶
* @param id
* @return
*/
User getUserById(@Param("id") int id);
}
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="dao.IUserDao">
<select id="getUserById" resultType="model.User">
select * from user where id=#{id};
</select>
</mapper>
缺點：如果參數(shù)超過5個寓盗，甚至以上灌砖。這時候璧函，就顯的比較麻煩，就可以換成JavaBean傳遞參數(shù)
- 2.使用JavaBean傳遞參數(shù)
MyBatis允許組織一個JavaBean基显，通過簡單的setter和getter方法設(shè)置參數(shù)蘸吓，這樣就可以提高的代碼的可讀性。
以重寫上面的例子撩幽。請求參數(shù)還是User類型
public interface IUserDao {
/**
* 通過主鍵查詢用戶
* @param user
* @return
*/
User getUserById(User user);
}
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="dao.IUserDao">
<select id="getUserById" parameterType="model.User" resultType="model.User">
select * from user where id=#{id};
</select>
</mapper>
2.5 resultMap映射結(jié)果集
有些時候库继，我們通過resultType不能完全處理一些復(fù)雜的映射屬性。這時候就需要手動設(shè)置映射關(guān)系窜醉。那么就通過resultMap設(shè)置宪萄。
注意：resultType與resultMap不能一起使用。
只需要修改mapper.xml的代碼
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="dao.IUserDao">
<resultMap id="userResultMap" type="model.User">
<id property="id" column="id"></id>
<result property="name" column="name"></result>
<result property="age" column="age"></result>
</resultMap>
<select id="getUserById" parameterType="model.User" resultMap="userResultMap">
select * from user where id=#{id};
</select>
</mapper>
resultMap標簽的id酱虎，代表定義了唯一一個的resultMap雨膨。
resultMap標簽的type，代表最終數(shù)據(jù)庫需要映射到哪個POJO上读串。
id元素聊记，代表的使用哪個屬性作為其主鍵。
result元素恢暖，定義普通的列的映射關(guān)系排监。
