緊接上文所述，在這篇文章中我將對Mapper映射文件進行詳細的說明。

Mapper映射文件是一個xml格式文件，必須遵循相應的dtd文件規(guī)范，如ibatis-3-mapper.dtd。我們先大體上看看支持哪些配置？如下所示，從Eclipse里截了個屏：

從上圖可以看出，映射文件是以<mapper>作為根節(jié)點，在根節(jié)點中支持9個元素，分別為insert、update、delete、select（增刪改查）;cache、cache-ref、resultMap、parameterMap、sql。

下文中，我們將首先對增刪改進行描述，然后對查進行詳細說明，最后對其他五個元素進行簡單說明。

（1）insert、update、delete

我們先從配置文件看起：

<?xml version='1.0' encoding='UTF-8' ?> <!DOCTYPE mapper PUBLIC '-//ibatis.apache.org//DTD Mapper 3.0//EN' 'http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd'> <!-- mapper 為根元素節(jié)點， 一個namespace對應一個dao --><mapper namespace='com.dy.dao.UserDao'> <insert <!-- 1. id （必須配置） id是命名空間中的唯一標識符，可被用來代表這條語句。 一個命名空間（namespace） 對應一個dao接口, 這個id也應該對應dao里面的某個方法（相當于方法的實現(xiàn)），因此id 應該與方法名一致 --> <!-- 2. parameterType （可選配置, 默認為mybatis自動選擇處理） 將要傳入語句的參數(shù)的完全限定類名或別名， 如果不配置，mybatis會通過ParameterHandler 根據參數(shù)類型默認選擇合適的typeHandler進行處理 parameterType 主要指定參數(shù)類型，可以是int, short, long, string等類型，也可以是復雜類型（如對象） --> parameterType='user' <!-- 3. flushCache （可選配置，默認配置為true） 將其設置為 true，任何時候只要語句被調用，都會導致本地緩存和二級緩存都會被清空，默認值：true（對應插入、更新和刪除語句） --> flushCache='true' <!-- 4. statementType （可選配置，默認配置為PREPARED） STATEMENT，PREPARED 或 CALLABLE 的一個。這會讓 MyBatis 分別使用 Statement，PreparedStatement 或 CallableStatement，默認值：PREPARED。 --> statementType='PREPARED' <!-- 5. keyProperty (可選配置， 默認為unset) （僅對 insert 和 update 有用）唯一標記一個屬性，MyBatis 會通過 getGeneratedKeys 的返回值或者通過 insert 語句的 selectKey 子元素設置它的鍵值，默認：unset。如果希望得到多個生成的列，也可以是逗號分隔的屬性名稱列表。 --> keyProperty='' <!-- 6. keyColumn (可選配置) （僅對 insert 和 update 有用）通過生成的鍵值設置表中的列名，這個設置僅在某些數(shù)據庫（像 PostgreSQL）是必須的，當主鍵列不是表中的第一列的時候需要設置。如果希望得到多個生成的列，也可以是逗號分隔的屬性名稱列表。 --> keyColumn='' <!-- 7. useGeneratedKeys (可選配置， 默認為false) （僅對 insert 和 update 有用）這會令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法來取出由數(shù)據庫內部生成的主鍵（比如：像 MySQL 和 SQL Server 這樣的關系數(shù)據庫管理系統(tǒng)的自動遞增字段），默認值：false。 --> useGeneratedKeys='false' <!-- 8. timeout (可選配置， 默認為unset, 依賴驅動) 這個設置是在拋出異常之前，驅動程序等待數(shù)據庫返回請求結果的秒數(shù)。默認值為 unset（依賴驅動）。 --> timeout='20'> <update parameterType='user' flushCache='true' statementType='PREPARED' timeout='20'> <delete parameterType='user' flushCache='true' statementType='PREPARED' timeout='20'></mapper>

上面給出了一個比較全面的配置說明，但是在實際使用過程中并不需要都進行配置，可根據自己的需要刪除部分配置項。

在這里，我列舉出我自己的配置文件，精簡之后是這樣的：

<?xml version='1.0' encoding='UTF-8' ?> <!DOCTYPE mapper PUBLIC '-//ibatis.apache.org//DTD Mapper 3.0//EN' 'http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd'><mapper namespace='com.majing.learning.mybatis.dao.UserDao'><insert parameterType='user' useGeneratedKeys='true' keyProperty='id'>insert into user(name,password,age) values(#{name},#{password},#{age})</insert><delete parameterType='int'>delete from user where id = #{id}</delete><update parameterType='user' >update user set name = #{name}, password = #{password}, age = #{age} where id = #{id}</update> </mapper>

這里的parameterType設置成user是因為如果不設置的情況下，會自動將類名首字母小寫后的名稱，原來的類名為User。不過，建議大家還是使用typeAlias進行配置吧。唯一需要說明的就是<insert>元素里面的useGeneratedKeys和keyProperties屬性，這兩個屬性是用來獲取數(shù)據庫中的主鍵的。

在數(shù)據庫里面經常性的會給數(shù)據庫表設置一個自增長的列作為主鍵，如果我們操作數(shù)據庫后希望能夠獲取這個主鍵該怎么弄呢？正如上面所述，如果是支持自增長的數(shù)據庫，如mysql數(shù)據庫，那么只需要設置useGeneratedKeys和keyProperties屬性便可以了，但是對于不支持自增長的數(shù)據庫（如oracle）該怎么辦呢？

mybatis里面在<insert>元素下面提供了<selectKey>子元素用于幫助解決這個問題。來看下配置：

<selectKey <!-- selectKey 語句結果應該被設置的目標屬性。如果希望得到多個生成的列，也可以是逗號分隔的屬性名稱列表。 --> keyProperty='id' <!-- 結果的類型。MyBatis 通常可以推算出來，但是為了更加確定寫上也不會有什么問題。MyBatis 允許任何簡單類型用作主鍵的類型，包括字符串。如果希望作用于多個生成的列，則可以使用一個包含期望屬性的 Object 或一個 Map。 --> resultType='int' <!-- 這可以被設置為 BEFORE 或 AFTER。如果設置為 BEFORE，那么它會首先選擇主鍵，設置 keyProperty 然后執(zhí)行插入語句。如果設置為 AFTER，那么先執(zhí)行插入語句，然后是 selectKey 元素 - 這和像 Oracle 的數(shù)據庫相似，在插入語句內部可能有嵌入索引調用。 --> order='BEFORE' <!-- 與前面相同，MyBatis 支持 STATEMENT，PREPARED 和 CALLABLE 語句的映射類型，分別代表 PreparedStatement 和 CallableStatement 類型。 --> statementType='PREPARED'></selectKey>

針對不能使用自增長特性的數(shù)據庫，可以使用下面的配置來實現(xiàn)相同的功能：

<insert parameterType='com.dy.entity.User'> <!-- oracle等不支持id自增長的，可根據其id生成策略，先獲取id --> <selectKey resultType='int' order='BEFORE' keyProperty='id'> select seq_user_id.nextval as id from dual </selectKey> insert into user(id, name, password, age, deleteFlag) values(#{id}, #{name}, #{password}, #{age}, #{deleteFlag}) </insert>

講完了insert、update、delete，接下來我們看看用的比較多的select。

（2）select、resultType、resultMap

我們先來看看select元素都有哪些配置可以設置：

<select <!-- 1. id （必須配置） id是命名空間中的唯一標識符，可被用來代表這條語句。 一個命名空間（namespace） 對應一個dao接口, 這個id也應該對應dao里面的某個方法（相當于方法的實現(xiàn)），因此id 應該與方法名一致 --> <!-- 2. parameterType （可選配置, 默認為mybatis自動選擇處理） 將要傳入語句的參數(shù)的完全限定類名或別名， 如果不配置，mybatis會通過ParameterHandler 根據參數(shù)類型默認選擇合適的typeHandler進行處理 parameterType 主要指定參數(shù)類型，可以是int, short, long, string等類型，也可以是復雜類型（如對象） --> parameterType='int' <!-- 3. resultType (resultType 與 resultMap 二選一配置) resultType用以指定返回類型，指定的類型可以是基本類型，可以是java容器，也可以是javabean --> resultType='User' <!-- 4. resultMap (resultType 與 resultMap 二選一配置) resultMap用于引用我們通過 resultMap標簽定義的映射類型，這也是mybatis組件高級復雜映射的關鍵 --> resultMap='userResultMap' <!-- 5. flushCache (可選配置) 將其設置為 true，任何時候只要語句被調用，都會導致本地緩存和二級緩存都會被清空，默認值：false --> flushCache='false' <!-- 6. useCache (可選配置) 將其設置為 true，將會導致本條語句的結果被二級緩存，默認值：對 select 元素為 true --> useCache='true' <!-- 7. timeout (可選配置) 這個設置是在拋出異常之前，驅動程序等待數(shù)據庫返回請求結果的秒數(shù)。默認值為 unset（依賴驅動）--> timeout='10000' <!-- 8. fetchSize (可選配置) 這是嘗試影響驅動程序每次批量返回的結果行數(shù)和這個設置值相等。默認值為 unset（依賴驅動)--> fetchSize='256' <!-- 9. statementType (可選配置) STATEMENT，PREPARED 或 CALLABLE 的一個。這會讓 MyBatis 分別使用 Statement，PreparedStatement 或 CallableStatement，默認值：PREPARED--> statementType='PREPARED' <!-- 10. resultSetType (可選配置) FORWARD_ONLY，SCROLL_SENSITIVE 或 SCROLL_INSENSITIVE 中的一個，默認值為 unset （依賴驅動）--> resultSetType='FORWARD_ONLY'>

我們還是從具體的示例來看看，

<select resultType='User'>select * from user where id = #{id}</select>

這里我們根據用戶id去查詢這個用戶的信息，resultType=User是一個別名，如果我們接觸到的是這種一對一的問題，那么可以簡單的定義一個實體，這個實體代表數(shù)據庫表中的一條記錄即可。但是如果我們遇到一對多的問題呢，就拿這里的查詢用戶信息來說，如果每個用戶有各種興趣，需要維護每個用戶的興趣信息，那么我們可能就存在下面的數(shù)據表結構：

CREATE TABLE `user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `name` varchar(255) NOT NULL, `password` varchar(255) NOT NULL, `age` int(3) DEFAULT NULL, PRIMARY KEY (`id`)) ENGINE=InnoDB AUTO_INCREMENT=15 DEFAULT CHARSET=utf8; CREATE TABLE `userinterests` ( `userid` int(11) DEFAULT NULL, `interestid` int(11) DEFAULT NULL) ENGINE=InnoDB DEFAULT CHARSET=utf8; CREATE TABLE `interests` ( `interestid` int(11) NOT NULL, `interestname` varchar(255) DEFAULT NULL, PRIMARY KEY (`interestid`)) ENGINE=InnoDB DEFAULT CHARSET=utf8;

其中user表用于記錄用戶信息，interests表用于維護所有的興趣標簽，而userinterests用于維護每個用戶的興趣情況。

這時候，如果我們需要根據用戶id去查詢用戶的信息和興趣信息該怎么做呢？這時候我們就要用到<select>中的另一個重要屬性了，那就是resultMap。

在配置查詢的返回結果時，resultType和resultMap是二選一的操作。對于比較復雜的查詢結果，一般都會設置成resultMap。

resultMap該怎么配置呢？又支持哪些配置呢？我們看看下面：

<resultMap type='' id=''> <!-- id, 唯一性，注意啦，這個id用于標示這個javabean對象的唯一性， 不一定會是數(shù)據庫的主鍵（不要把它理解為數(shù)據庫對應表的主鍵） property屬性對應javabean的屬性名，column對應數(shù)據庫表的列名 （這樣，當javabean的屬性與數(shù)據庫對應表的列名不一致的時候，就能通過指定這個保持正常映射了） --> <id property='' column=''/><!-- result與id相比， 對應普通屬性 --> <result property='' column=''/><!-- constructor對應javabean中的構造方法 --> <constructor> <!-- idArg 對應構造方法中的id參數(shù) --> <idArg column=''/> <!-- arg 對應構造方法中的普通參數(shù) --> <arg column=''/> </constructor><!-- collection，對應javabean中容器類型, 是實現(xiàn)一對多的關鍵 property 為javabean中容器對應字段名 column 為體現(xiàn)在數(shù)據庫中列名 ofType 就是指定javabean中容器指定的類型 --> <collection property='' column='' ofType=''></collection><!-- association 為關聯(lián)關系，是實現(xiàn)N對一的關鍵。 property 為javabean中容器對應字段名 column 為體現(xiàn)在數(shù)據庫中列名 javaType 指定關聯(lián)的類型 --> <association property='' column='' javaType=''></association></resultMap>

根據上面的說明，我們來看看之前的問題怎么解決？

先截圖給出三個表的數(shù)據情況：

接著，我們來定義興趣類，并改寫之前的用戶實體類

package com.majing.learning.mybatis.entity;public class Interests {private int id;private String name;public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}@Overridepublic String toString() {return 'Interests [id=' + id + ', name=' + name + ']';}}

package com.majing.learning.mybatis.entity; import java.util.List; public class User2 {private int id;private String name;private String password;private int age;private List<Interests> interests;private String author;public List<Interests> getInterests() {return interests;}public void setInterests(List<Interests> interests) {this.interests = interests;}public String getAuthor() {return author;}public void setAuthor(String author) {this.author = author;}public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public String getPassword() {return password;}public void setPassword(String password) {this.password = password;}public int getAge() {return age;}public void setAge(int age) {this.age = age;}@Overridepublic String toString() {return 'User2 [id=' + id + ', name=' + name + ', password=' + password + ', age=' + age + ', interests=' + interests + ', author=' + author + ']';}}

緊接著，我們改寫Dao接口：

package com.majing.learning.mybatis.dao; import com.majing.learning.mybatis.entity.User2; public interface UserDao2 {/** * 查詢 * @param userId * @return */User2 findUserById (int userId);}

然后，我們給相關實體類創(chuàng)建一下別名：

<typeAliases><typeAlias alias='UserWithInterests' type='com.majing.learning.mybatis.entity.User2'/><typeAlias alias='Interests' type='com.majing.learning.mybatis.entity.Interests'/></typeAliases>

然后再創(chuàng)建一個對應跟UserDao2對應的Mapper映射文件：

<?xml version='1.0' encoding='UTF-8' ?> <!DOCTYPE mapper PUBLIC '-//ibatis.apache.org//DTD Mapper 3.0//EN' 'http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd'><mapper namespace='com.majing.learning.mybatis.dao.UserDao2'> <resultMap type='UserWithInterests' id='UserWithInterestsMap'><id property='id' column='id'/><result property='name' column='name'/><result property='password' column='password'/><result property='age' column='age'/><collection property='interests' column='interestname' ofType='Interests'><id property='id' column='interestid'/><result property='name' column='interestname'/></collection></resultMap> <select resultMap='UserWithInterestsMap'>select a.*,c.* from user as a right join userinterests as b on a.id = b.userid right join interests as c on b.interestid = c.interestid where id = #{id}</select> </mapper>

最后將這個映射文件添加到<mappers>元素配置下：

<mappers><mapper resource='commajinglearningmybatisdaoUserDaoMapper.xml' /><mapper resource='commajinglearningmybatisdaoUserDao2Mapper.xml' /></mappers>

下面我們來寫個測試代碼來測試一下是否可以正常運行：

public class UserDaoTest3 {@Testpublic void testFindUserById(){SqlSession sqlSession = getSessionFactory().openSession(true); UserDao2 userMapper = sqlSession.getMapper(UserDao2.class); User2 user = userMapper.findUserById(10); System.out.println('記錄為：'+user); } // Mybatis 通過SqlSessionFactory獲取SqlSession, 然后才能通過SqlSession與數(shù)據庫進行交互private static SqlSessionFactory getSessionFactory() {SqlSessionFactory sessionFactory = null;String resource = 'configuration.xml';try {sessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsReader(resource));} catch (IOException e) {e.printStackTrace();}return sessionFactory;}}

運行代碼后，我們可以看到成功啦！

（3）sql

sql元素的意義，在于我們可以定義一串SQL語句，其他的語句可以通過引用它而達到復用它的目的。因為平時用到的也不多，這里就不多介紹了，感興趣的朋友可以自行查閱資料了解一下。

（4）cache、cache-ref

關于緩存的這塊邏輯還沒有研究過，后面專門寫篇文章針對緩存進行針對性的說明，敬請關注。

到此這篇關于Mybatis中Mapper映射文件使用詳解的文章就介紹到這了,更多相關Mybatis Mapper映射文件內容請搜索好吧啦網以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持好吧啦網！