前言：繼續(xù)深入學(xué)習(xí) mybatis 的用法及原理，還是先會(huì)用再學(xué)習(xí)原理。

映射器的主要元素有：select、insert、update、delete、parameterMap（即將被刪除，不建議使用）、sql、resultMap、cache、cache-ref

各個(gè)元素的規(guī)則定義：見(jiàn)源碼中的文件?org/apache/ibatis/builder/xml/mybatis-3-mapper.dtd

目錄：

　　一、select 元素

　　二、insert 元素

　　三、update 元素

　　四、delete 元素

　　五、參數(shù)

　　六、SQL 片段重用

　　七、resultMap 結(jié)果映射集

一、select 元素

1、查詢(xún)，select 元素有以下屬性：

　　id：和 Mapper 的命名空間組合起來(lái)必須是唯一的，供給 MyBatis 上下文調(diào)用。

　　parameterType：查詢(xún)參數(shù)類(lèi)型。一般給出類(lèi)的全命名，也可以給出類(lèi)的別名。可以選擇 JavaBean、Map 等復(fù)雜的參數(shù)類(lèi)型傳遞給 SQL。

　　resultType：查詢(xún)返回?cái)?shù)據(jù)類(lèi)型。一般給出類(lèi)的全命名，或者別名，不能和 resultMap 同時(shí)使用。

　　resultMap：查詢(xún)返回映射集的引用，將執(zhí)行強(qiáng)大的映射功能。不能和 resultType 同時(shí)使用。它是 MyBatis 最復(fù)雜的元素，可以自定義映射規(guī)則、級(jí)聯(lián)、typeHandle 等。

　　flushCache：它的作用是在調(diào)用 SQL 后，是否要求 MyBatis 清空之前查詢(xún)的本地緩存和二級(jí)緩存。取值為 boolean，默認(rèn) false。

　　useCache：啟動(dòng)二級(jí)緩存的開(kāi)關(guān)，是否要求 MyBatis 將此次結(jié)果緩存。取值為 boolean，默認(rèn) true。

　　timeout：這是超時(shí)參數(shù)，等超時(shí)的時(shí)候?qū)伋霎惓?#xff0c;單位為秒。默認(rèn)值為數(shù)據(jù)庫(kù)廠(chǎng)商提供的 JDBC 驅(qū)動(dòng)所設(shè)置的秒數(shù)。

　　fetchSize：獲取記錄的總條數(shù)。默認(rèn)值為數(shù)據(jù)庫(kù)廠(chǎng)商提供的 JDBC 驅(qū)動(dòng)所設(shè)置的條數(shù)。

　　statementType：選擇使用 JDBC 的 Statement 工作，取值為 STATEMENT、PREPARED、CallableStatement。默認(rèn) PREPARED。

　　resultSetType：很少使用

　　databaseId：數(shù)據(jù)庫(kù)廠(chǎng)商標(biāo)識(shí)，提供多數(shù)據(jù)庫(kù)的支持。

　　resultOrdered：很少使用

　　resultSets：很少使用

2、舉例　　

dao 接口

/*** 通過(guò)名字查找用戶(hù)* @param name* @return*/User queryUserByName(String name);

xml

<select id="queryUserByName" resultType="com.yule.user.entity.User">select t.id, t.name, t.age from t_user twhere t.name = #{name,jdbcType=VARCHAR}</select>

3、自動(dòng)映射

　　當(dāng)配置?autoMappingBehavior 不是 NONE 時(shí)，MyBatis 會(huì)提供自動(dòng)映射功能，只要返回的 sql 列名（別名）和 JavaBean 的屬性一致，MyBatis 就會(huì)幫助我們回填這些字段無(wú)需任何配置，它可以在很大程度上簡(jiǎn)化我們的配置工作。

　　在實(shí)際中，通常我們是使用 sql 列名的別名的方式自動(dòng)映射。上方例子的?resultType="com.yule.user.entity.User" 就是 MyBatis 的自動(dòng)映射。

　　在實(shí)際中，也可以通過(guò)在配置文件中開(kāi)啟駝峰命名方式：mapUndersoreToCamlCase 為 true。這種方式的前提是數(shù)據(jù)庫(kù)命名是規(guī)范的，即每一個(gè)單詞都用下劃線(xiàn)分割，POJO 采用的是駝峰命名方式，那么可以設(shè)置配置文件，從而達(dá)到從數(shù)據(jù)庫(kù)到 POJO 的自動(dòng)映射了。

　　自動(dòng)映射在 MyBatis 的配置文件中，元素 settings 中可以配置 autoMappingBehavior 屬性值來(lái)設(shè)置其策略，它包含 3 個(gè)值：

• NONE：取消自動(dòng)映射
• PARTIAL：只會(huì)自動(dòng)映射，沒(méi)有定義嵌套結(jié)果集映射的結(jié)果集。為默認(rèn)值。
• FULL：會(huì)自動(dòng)映射任意復(fù)雜的結(jié)果集（無(wú)論是否嵌套），性能會(huì)下降。

　　在大部分的情況下 MyBatis 都會(huì)推斷你返回?cái)?shù)據(jù)的類(lèi)型，所以大部分情況下你都無(wú)需去配置參數(shù)類(lèi)型和結(jié)果類(lèi)型。要我們?cè)O(shè)置的往往只是可能返回為空的字段類(lèi)型而已。因?yàn)?null 值，MyBatis 無(wú)法判斷其類(lèi)型。

4、傳遞多個(gè)參數(shù)

　　一、使用 map，缺點(diǎn)是業(yè)務(wù)關(guān)聯(lián)性不強(qiáng)，造成代碼可讀性下降。

　　二、使用注解 @Param，xml 中無(wú)需定義參數(shù)類(lèi)型。可讀性增強(qiáng)，但是當(dāng)參數(shù)個(gè)數(shù)太多時(shí)，可讀性仍然會(huì)下降。

　　三、使用 JavaBean 傳遞參數(shù)。

　　這三種方式對(duì)比：

• 使用 Map 傳遞參數(shù)。因?yàn)?Map 導(dǎo)致代碼的可讀性下降，會(huì)導(dǎo)致后面的擴(kuò)展和維護(hù)比較困難，所以建議少使用這種方式。
• 使用 @Param 注解方式。這種方式可讀性高，但是當(dāng)參數(shù)個(gè)數(shù)很多的時(shí)候，同樣會(huì)導(dǎo)致可讀性和維護(hù)性下降，所以，當(dāng)參數(shù)個(gè)數(shù)小于等于 5 時(shí)，建議采取這種方式。
• 使用實(shí)體 JavaBean 的方式。當(dāng)參數(shù)個(gè)數(shù)大于 5 時(shí)，建議采取這種方式。

5、使用 resultMap 映射結(jié)果集

?　　對(duì)于簡(jiǎn)單的映射，建議采用自動(dòng)映射就好，可以減少配置。resultMap 映射一般就用于復(fù)雜、級(jí)聯(lián)這些關(guān)聯(lián)的配置。所以這個(gè)放在 resultMap 結(jié)果映射集講。

二、insert 元素

1、插入，insert 元素有一下屬性：

　　id：同 select

　　parameterType：同 select

　　flushCache：同 select

　　timeout：同 select

　　statemeterType：同 select

　　keyProperty：表示以哪個(gè)列作為屬性的主鍵。不能和 keyColumn 同時(shí)使用。聯(lián)合主鍵可以用逗號(hào)隔開(kāi)。

　　useGeneratedKeys：這會(huì)令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法來(lái)取出數(shù)據(jù)庫(kù)內(nèi)部生成的主鍵，使用該屬性后就必須使用keyColumn或者KeyProperty屬性中的一個(gè)。取值為 boolean 值，默認(rèn) false。

　　keyColumn：指明第幾列是主鍵。不能和 keyProperty 同時(shí)使用。聯(lián)合主鍵可以用逗號(hào)隔開(kāi)。只接受整形參數(shù)。

　　databaseId：同 select

　　lang：使用很少

2、舉例

?dao 接口

/*** 新增用戶(hù)* @param user* @return*/int insertUser(User user);

xml，自定義規(guī)則：使用序列實(shí)現(xiàn)主鍵回填，即執(zhí)行完新增后返回主鍵 id。這個(gè)能把主鍵 id 回填到實(shí)體 User 上去。

　　MyBatis 中 不允許同事包含連兩個(gè)?selectKey 標(biāo)簽。

<insert id="insertUser"><selectKey keyProperty="id" order="BEFORE" resultType="int">select t_user_s.nextval from dual</selectKey>insert into t_user(id, name, age)values(#{id}, #{name}, #{age})</insert>

測(cè)試

@Testpublic void testInsertUser(){SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();SqlSession sqlSession = sqlSessionFactory.openSession();UserDao mapper = sqlSession.getMapper(UserDao.class);User user = new User("yule", "24");mapper.insertUser(user);sqlSession.commit();sqlSession.close();System.out.println(user.toString());}

3、舉例2

xml，使用主鍵自增長(zhǎng)（必須在表中設(shè)置 id 字段為自增字段），同時(shí) sql 執(zhí)行完成之后 MyBatis 自動(dòng)將執(zhí)行完 sql 后自動(dòng)生成的 id 回填到我們的參數(shù) User 對(duì)象中。

　　<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">insert into t_user(name, age)values(#{name}, #{age})</insert>

三、update 元素

1、修改，和 insert 一樣，MyBatis 執(zhí)行完后會(huì)返回一個(gè)整數(shù)，標(biāo)出執(zhí)行后影響的條數(shù)。

2、舉例

dao 接口

/*** 修改用戶(hù)信息* @param user* @return*/int updateUserById(User user);

xml

<update id="updateUserById">update t_user t set t.age = #{age}, t.name = #{name}where t.id = #{id}</update>

四、delete 元素

1、刪除，和 insert 一樣，MyBatis 執(zhí)行完后會(huì)返回一個(gè)整數(shù)，標(biāo)出執(zhí)行后影響的條數(shù)。

2、舉例

dao 接口

int deleteUserById(String id);

xml

<delete id="deleteUserById">delete t_user t where t.ID = #{id}</delete>

五、參數(shù)?　　

　　定義參數(shù)屬性時(shí)，MyBatis 不允許換行！！！

1、參數(shù)配置

　　我們可以通過(guò)制定參數(shù)的類(lèi)型去讓對(duì)應(yīng)的 typeHandle 處理它們，也可以通過(guò)指定對(duì)應(yīng)的 JavaType、JdbcType 來(lái)明確使用哪個(gè) typeHandle 處理參數(shù)。詳見(jiàn)?https://www.cnblogs.com/yuxiaole/p/9464019.html#typeHandler

2、存儲(chǔ)過(guò)程支持

?　　對(duì)于存儲(chǔ)過(guò)程而言，存在 3 種參數(shù)，輸入?yún)?shù)（IN）、輸出參數(shù)（OUT）、輸入輸出參數(shù)（INOUT）。MyBatis 的參數(shù)規(guī)則為其提供了良好的支持。

3、特殊字符串替換和處理（# 和 $）

　　使用 #{} 方式，MyBatis 會(huì)用創(chuàng)建預(yù)編譯的語(yǔ)句，然后 MyBatis 為它設(shè)值。

　　使用 ${} 方式，傳遞 SQL 語(yǔ)句本身，比如傳遞 SQL 的列名、根據(jù)某些列排序等。比如 select ${columns} from t_tablename 來(lái)支持傳遞動(dòng)態(tài)列名。不過(guò)使用這種方式是不安全的，所以雖然 MyBatis 是給了靈活性，但是自己也需要控制參數(shù)來(lái)保證 SQL 運(yùn)轉(zhuǎn)的正確性和安全性。

六、SQL 片段重用

　　采用? <include refid="sql_id"></include> 來(lái)實(shí)現(xiàn) SQL 片段的重用。SQL 片段是指用 <sql></sql> 定義的片段。

　　比如：給 include 標(biāo)簽加一個(gè) refid 屬性進(jìn)行引用，從而達(dá)到重用的功能

<sql id="user_columns">${prefix}.id, ${prefix}.name, ${prefix}.age</sql><select id="queryUserByName" resultType="com.yule.user.entity.User">select<include refid="user_columns"><property name="prefix" value="t"/></include>from t_user twhere t.name = #{name,jdbcType=VARCHAR}</select>

　　或者，可以直接給 refid 一個(gè)參數(shù)值，由程序制定引入 SQL

<select id="queryUserList" resultType="User" ><include refid="common_query"><property name="columnsName" value="user_columns"/></include></select> <sql id="common_query">select<include refid="${columnsName}"><property name="prefix" value="t"/></include>from t_user t</sql>

七、resultMap 結(jié)果映射集

　　resultMap 是 MyBatis 中最復(fù)雜的元素。主要是定義一個(gè)查詢(xún)中的結(jié)果集的映射關(guān)系，不支持修改、刪除。作用是定義映射規(guī)則、級(jí)聯(lián)的更新、定制類(lèi)型轉(zhuǎn)換器等。

1、resultMap 元素里面的構(gòu)成

　　見(jiàn)源碼：org/apache/ibatis/builder/xml/mybatis-3-mapper.dtd

<!ELEMENT resultMap (constructor?,id*,result*,association*,collection*, discriminator?)>

　　其中，constructor 元素用于配置實(shí)體構(gòu)造方法。表示告訴 MyBatis 用實(shí)體的哪個(gè)構(gòu)造方法來(lái)構(gòu)造實(shí)體。

<!ELEMENT constructor (idArg*,arg*)>

　　其中，id 元素是表示哪個(gè)列是主鍵，允許多個(gè)主鍵，多個(gè)主鍵稱(chēng)為聯(lián)合主鍵。

　　其中，result 元素是配置 POJO 到 SQL 列名的映射關(guān)系。

　　result 和 id 兩個(gè)元素都有如下屬性：

• property：代表 POJO 的屬性名稱(chēng)。映射到列結(jié)果的字段或?qū)傩?#xff0c;如果 POJO 的屬性匹配是存在的，和給定 SQL 列名（column 元素）相同的，那么 MyBatis 就會(huì)映射到 POJO 上。
• column：對(duì)應(yīng)的是 SQL 的列名。
• javaType：配置 Java 的字段類(lèi)型
• jdbcType：配置數(shù)據(jù)庫(kù)中的字段類(lèi)型
• typeHandle：類(lèi)型處理器

2、使用 map 存儲(chǔ)結(jié)果集

　　select 元素中使用 resultMap 會(huì)使可讀性下降，所以建議更多時(shí)候使用 POJO 的方式來(lái)自動(dòng)映射，即 resultType。

　　resultMap 元素的屬性 id 代表這個(gè) resultMap 的標(biāo)識(shí)，type 代表需要映射的 POJO。

<!ATTLIST resultMap id CDATA #REQUIRED type CDATA #REQUIRED extends CDATA #IMPLIED autoMapping (true|false) #IMPLIED >

舉例：SQL 語(yǔ)句的列名需要和 column 一 一對(duì)應(yīng)。

<resultMap id="userResultMap" type="com.yule.user.entity.User"><constructor><idArg column="id" javaType="string"/><arg column="name" javaType="string"/><arg column="age" javaType="string"/></constructor><id property="id" column="id"/><result property="name" column="name"/><result property="age" column="age"/></resultMap> <select id="queryUserById" resultMap="userResultMap">select t.id, t.name, t.age from t_user twhere t.id = #{id}</select>

3、級(jí)聯(lián)

　　有 3 中關(guān)系：一對(duì)一、一對(duì)多、多對(duì)多。多對(duì)多可用一對(duì)多雙向標(biāo)識(shí)。

　　在 MyBatis 中級(jí)聯(lián)分為這么 3 種：

• association：一對(duì)一。
• collection：一對(duì)多。
• discriminator：鑒別器。可以根據(jù)實(shí)際選擇采用哪個(gè)類(lèi)作為實(shí)例，允許根據(jù)特定的條件去關(guān)聯(lián)不同的結(jié)果集。

舉例：

　　

?

轉(zhuǎn)載于:https://www.cnblogs.com/yuxiaole/p/9478618.html

總結(jié)

以上是生活随笔為你收集整理的深入理解MyBatis的原理（四）：映射器的用法的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。