---

---

前言

MyBatis的強(qiáng)大在于它的語句映射，它提供了注解和XML映射文件兩種開發(fā)方式，都是為了減少我們的使用成本，屏蔽JDBC代碼細(xì)節(jié)，節(jié)省代碼，從而讓我們更專注于SQL代碼！

通過 《上文》，我們學(xué)會(huì)了常用12種注解開發(fā)，本文主要講解XML映射文件方式開發(fā)，輕松學(xué)會(huì)創(chuàng)建XML映射文件和常用的select標(biāo)簽和resultMap標(biāo)簽的用法。

---

一、創(chuàng)建XML映射文件

XML映射文件的目錄位置通常推薦創(chuàng)建在resources下，例如實(shí)戰(zhàn)案例創(chuàng)建如下：

在tg-book-dal的resources下創(chuàng)建與UserMapper.java對(duì)應(yīng)的Xml映射文件UserMapper.xml，如下圖：

要求：路徑相同，名稱相同。

不同行不行？可以通過mybatis.mapper-locations配置！建議保持默認(rèn)相同！

UserMapper.xml的內(nèi)容定義如下：

<?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="org.tg.book.dal.mapper.UserMapper"></mapper>

---

二、MybatisX插件安裝

這里推薦安裝使用MybatisX插件，非常方便在接口與XML映射文件之間來回跳轉(zhuǎn)！以及可以生成標(biāo)簽！

IDEA的File-》Settings-》Plugins 搜索MybatisX安裝即可!

---

三、mapper標(biāo)簽

mapper標(biāo)簽，它是最頂級(jí)的標(biāo)簽，也就是XML根標(biāo)簽，通過namespace屬性指定對(duì)應(yīng)的接口，比如這里指定的是：org.tg.book.dal.mapper.UserMapper，這樣接口和XML映射文件就產(chǎn)生了關(guān)聯(lián)，接口通過JDK動(dòng)態(tài)代理生成實(shí)現(xiàn)類時(shí)，就會(huì)讀取XML映射文件的對(duì)應(yīng)配置！

如何配置呢？常用的XML標(biāo)簽有：

• select標(biāo)簽（對(duì)應(yīng)寫查詢SQL語句）
• resultMap標(biāo)簽（結(jié)果映射，上文曾介紹過）
• insert標(biāo)簽（對(duì)應(yīng)寫插入INSERT語句）
• update標(biāo)簽（對(duì)應(yīng)寫修改UPDATE語句）
• delete標(biāo)簽（對(duì)應(yīng)寫刪除DELETE語句）
• sql標(biāo)簽（對(duì)應(yīng)寫SQL語句，這個(gè)SQL語句可被其他語句引用的可重用的語句塊）

---

四、select標(biāo)簽

我們先刪除上文的注解方式，換成XML映射文件的方式來實(shí)現(xiàn)！

UserMapper接口方法

@Param指定參數(shù)名

public interface UserMapper {User selectByUserNamePassword(@Param("userName") String userName,@Param("password") String password);
}

這時(shí)MybatisX插件會(huì)提示一個(gè)錯(cuò)誤，把鼠標(biāo)懸浮在方法上，會(huì)提示selectByUserNamePassword方法在xml中沒有定義，我們點(diǎn)擊Generate statement

UserMapper.xml

這時(shí)，在UserMapper.xml中會(huì)生成一個(gè)select標(biāo)簽，使用id屬性指定對(duì)應(yīng)的接口方法名，使用resultType屬性指定返回類型，如下圖：

這里依然有一個(gè)警告：XML tag has empty body，是因?yàn)槲覀儧]有寫對(duì)應(yīng)的查詢select語句SQL，我們?cè)?code>select標(biāo)簽中補(bǔ)充SQL語句如下：

select * from user where user_name =#{userName} and password =#{password}

SQL中的參數(shù)使用#{}作為占位符

實(shí)際的效果與上文使用的@Select注解相同！

---

五、resultMap標(biāo)簽

同樣的，運(yùn)行后你會(huì)發(fā)現(xiàn)【User對(duì)象】的userId并沒有取到值，原因是【user表】的字段名叫id，而不是userId，名稱不同所以無法獲取到對(duì)應(yīng)的值，我們通過resultMap標(biāo)簽方式解決。

定義resultMap標(biāo)簽

<resultMap id="UserMap" type="org.tg.book.dal.po.User"><id column="id" jdbcType="INTEGER" property="userId"/><result column="user_name" jdbcType="VARCHAR" property="userName"/><result column="password" jdbcType="VARCHAR" property="password"/>
</resultMap>

resultMap標(biāo)簽說明：

• 通過id屬性定義唯一標(biāo)識(shí)，type屬性定義結(jié)果類型
• 通過id標(biāo)簽指定主鍵列, result標(biāo)簽指定非主鍵列
  • property指定對(duì)象的屬性名
  • column指定數(shù)據(jù)表的列名
  • jdbcType指定數(shù)據(jù)表的字段類型

修改select標(biāo)簽

使用resultMap屬性代替了resultType屬性，resultMap屬性內(nèi)指定剛定義的resultMap id名稱。

實(shí)際的效果與上文使用的@Results和@Result注解相同！

OK，到這，我們就使用XML映射文件方式，完整實(shí)現(xiàn)了接口方法selectByUserNamePassword！

總結(jié)

寫一個(gè)數(shù)據(jù)庫查詢方法，簡(jiǎn)單來說，步驟如下：

1. 創(chuàng)建接口對(duì)應(yīng)的xml映射文件
2. 創(chuàng)建查詢方法對(duì)應(yīng)的select標(biāo)簽
3. 寫查詢selec語句SQL
4. 【可選】如果【數(shù)據(jù)庫字段】與【PO對(duì)象屬性】不一致，需要增加結(jié)果映射resultMap標(biāo)簽，然后在select標(biāo)簽使用resultMap屬性指定resultMap標(biāo)簽