Mybatis系列全解(五):全網(wǎng)最全!詳解Mybatis的Mapper映射文件

封面:洛小汐
作者:潘潘

若不是生活所迫,誰愿意背負(fù)一身才華。

前言

上節(jié)我們介紹了 《 Mybatis系列全解(四):全網(wǎng)最全!Mybatis配置文件 XML 全貌詳解 》,內(nèi)容很詳細(xì)( 也很枯燥),由于篇幅實(shí)在過于冗長,我預(yù)計(jì)大家想看完得花上兩段上班地鐵公交車的時(shí)間 。。。

不過應(yīng)該有讓大家了解到 Mybatis 的核心配置文件 config.xml 全貌,其中的 <mappers></mappers> 元素即是我們本節(jié)準(zhǔn)備登場介紹的 SQL 映射器,上節(jié)有介紹了三種引入 SQL 映射器的方式,本節(jié)我們就主要聊聊它的幾個(gè)頂級元素用法。

Mybatis 真正強(qiáng)大就在于它的語句映射,這是它的魔力所在,也是基石。由于它異常強(qiáng)大,映射器的 XML 文件就顯得相對簡單。如果拿它跟具有相同功能的 JDBC 代碼進(jìn)行對比,你會立即發(fā)現(xiàn)省掉了將近 95% 的代碼( 95% 是Mybatis 官網(wǎng)的說法 ,我也就引入一下 ),MyBatis 致力于減少使用成本,讓用戶能更專注于 SQL 代碼。

Mybatis系列全解腦圖分享,持續(xù)更新中

Mybaits系列全解 (持續(xù)更新)


目錄


1、mapper 映射器頂級元素全貌

2、namespace 命名空間

3、select 查詢

4、insert / update / delete 增刪改

5、cache 緩存

6、cache-ref 緩存引用

7、sql 語句塊

8、parameterMap 參數(shù)映射

9、總結(jié)

mapper 映射器頂級元素全貌

與其它 ORM 框架如 Hibernate 不同,Mybatis 的框架思想希望開發(fā)者能夠直接操作數(shù)據(jù)庫編寫 SQL,而不是隱藏起來,讓開發(fā)者獨(dú)自面對 Java 對象,為此 Mybatis 設(shè)計(jì)了 SQL 映射器,任你五招十二式。

映射器有九大頂級元素 ,基本技能介紹

  • select : 用于查詢,支持傳參,返回指定結(jié)果集;
  • insert : 用于新增,支持傳參,返回指定結(jié)果集;
  • update : 用于更新,支持傳參,返回指定結(jié)果集;
  • delete : 用于刪除,支持傳參,返回指定結(jié)果集;
  • sql : 被其它語句引用的 可復(fù)用 語句塊;
  • cache : 當(dāng)前命名空間緩存配置;
  • cache-ref : 引用其它命名空間的緩存配置;
  • parameterMap : 參數(shù)映射,已棄用,是它不夠好;
  • resultMap : 結(jié)果集映射,它就很好;

其中,增刪改查操作拼接 SQL 時(shí)使用到的 動態(tài)SQL( if、where、foreach啥的),以及封裝結(jié)果集時(shí)使用到的 復(fù)雜映射 (1對1 ,1對多,多對多啥的),這兩部分我們后面單立文章再詳細(xì)介紹,本文中我們簡單點(diǎn)過。

九大頂級元素 ,功能歸類:

其中頂一元素 parameterMap 已建議棄用了 。

無論你有多么復(fù)雜的 SQL 操作,最根本的思路都逃不出以上 4 部分。

namespace 命名空間

一個(gè)完整的 Mapper 映射文件,需要有約束頭 xml 與 !DOCTYPE ,其次才是 mapper 根元素,最后再是頂級元素,而其中,namespace 屬性作為 mapper 的唯一標(biāo)識,試回憶:

  • 上學(xué)時(shí),6年級一班23號,能代表唯一的你。
  • 編寫 Java 類時(shí),包名 + 類名,能代表唯一的類。
  • 而如今,我們在 Mybatis 中寫的每一段 SQL 語句,同樣有唯一的代表方式,那就是「 命名空間標(biāo)識 + 語句id 」,無論是為了區(qū)分業(yè)務(wù)也好,還是為了拆分服務(wù)也好,反正 Mybatis 讓每一個(gè) mapper.xml 配備一個(gè)唯一命名空間標(biāo)識。

每一段 SQL 語句都是唯一定義的,我們在 Mybatis 中用「 命名空間標(biāo)識 + 語句塊 ID 」作為唯一的標(biāo)識,組合之后在 Mybatis 二級緩存中可以作為本地 map 集合 緩存 的唯一Key ,也可以用于 Dao 接口的 映射 綁定,還能作為唯一 代理 標(biāo)識??傊?,我們希望避免命名沖突和重復(fù)定義,所以,擁有這么一個(gè)唯一標(biāo)識 ,它就至少有一億個(gè)利好。

select 查詢

select 查詢語句,幾乎是我們最高頻的使用元素,所以 Mybatis 在這塊沒少下功夫,目的就是通過提供盡可能多的便利,讓我們的查詢操作變得簡單。 一個(gè)查詢用戶 User 的查詢語句可以這么編寫:

<select id="selectUser" parameterType="int" resultType="hashmap">
  select * from t_user where id = #{id}
</select>
  • id屬性:在當(dāng)前 mapper.xml 命名空間下,它的 id 值是唯一的( 不過如果在不同的 mapper.xml 命名空間下,則允許有相同的的 id 值 )
  • parameterType 屬性:代表傳入的參數(shù)類型,這里是 int (或 Integer)類型
  • resultType屬性:代表返回結(jié)果類型,這里指定返回一個(gè) hashMap 類型的對象,mybatis 會把查詢出來的數(shù)據(jù)表記錄對應(yīng)的 ' 字段列名 - 字段值 ',自動映射為 map 集合的 key - value 。

當(dāng)然如果你不希望通過 hashmap 來接收查詢結(jié)果,允許你自由指定返回類型。Mybatis 是支持自動綁定 JavaBean 的,我們只要讓查詢返回的字段名和 JavaBean 的屬性名保持一致(或者采用駝峰式命名),便可以自動映射結(jié)果集,例如你創(chuàng)建一個(gè) Java 類 User.java ,包含兩個(gè)屬性 id 和 name , 那么結(jié)果集可以指定為 com.vo.User ,就完成了。

<select id="selectUser" 
    parameterType="int" resultType="com.vo.User">
  select * from t_user where id = #{id}
</select>

注意參數(shù)符號:

#{id}

'#{}' 告訴 MyBatis 創(chuàng)建一個(gè)預(yù)編譯語句(PreparedStatement)參數(shù),在 JDBC 中,這樣的一個(gè)參數(shù)在 SQL 中會由一個(gè) “ ? ” 來標(biāo)識,并被傳遞到一個(gè)新的預(yù)編譯語句中,就像這樣:

// 近似的 JDBC 代碼,非 MyBatis 代碼...
String selectUser = " select * from t_user where id = ? ";
PreparedStatement ps = conn.prepareStatement(selectUser);
ps.setInt(1,id);

'#{}' 作為占位符,${} 作為替換符,兩者沒有孰輕孰重,只不過應(yīng)用場景不同,適當(dāng)取舍即可。

我們希望完成類似 JDBC 中的 PrepareStatement 預(yù)編譯處理 ,可以使用 #{} ,它會在替換占位符時(shí)首尾添加上單引號 '' ,能有效防止 SQL 注入 風(fēng)險(xiǎn)。

例如使用 ${} 操作刪除 ( 就很有問題?。?/p>

// 1、使用 ${} 有注入風(fēng)險(xiǎn)
delete from t_user where id = ${id}

// 2、正常傳值,id 傳入 1  
delete from t_user where id = 1
// 結(jié)果刪除了id=1 的記錄
    
// 3、注入風(fēng)險(xiǎn),id 傳入 1 or 1=1 
delete from t_user where id = 1 or 1=1
// 全表刪除了

再看看 #{} 是如何規(guī)避 SQL 注入 的:

// 1、使用 #{} 有效防止注入風(fēng)險(xiǎn)
delete from t_user where id = #{id}

// 2、正常傳值,id 傳入 1   
delete from t_user where id = '1'
// 結(jié)果刪除了id=1 的記錄
    
// 3、注入風(fēng)險(xiǎn),id 傳入 1 or 1=1 
delete from t_user where id = '1 or 1=1'
// SQL 語句報(bào)錯(cuò),表數(shù)據(jù)安全

雖然在防止 SQL 注入方面,{} 確實(shí)無能為力,不過我們{} 在其它方面可不容小覷,例如它允許你靈活地進(jìn)行 動態(tài)表和動態(tài)列名的替換 操作,例如:

// 1、靈活查詢指定表數(shù)據(jù)
select * from ${tableName} 

// 傳入 tableName參數(shù) = t_user , 結(jié)果
select * from t_user  

// 2、靈活查詢不同列條件數(shù)據(jù)
select * from t_user where ${colunmName} = ${value}

// 傳入 colunmName參數(shù) = name , value參數(shù) = '潘潘', 結(jié)果
select * from t_user where name = '潘潘'

// 傳入 colunmName參數(shù) = id , value參數(shù) = 1, 結(jié)果
select * from t_user where id = 1

以上的 {} 替換列名與表名的方式非常靈活,不過確實(shí)存在 SQL 注入風(fēng)險(xiǎn),所以在考慮使用 #{} 或{} 前,需要評估風(fēng)險(xiǎn),避免風(fēng)險(xiǎn),允許的情況下,我建議使用 #{} 。

當(dāng)然,select 元素允許你配置很多屬性來配置每條語句的行為細(xì)節(jié)。

<select     
  id="selectUser" 
  parameterType="int"
  parameterMap="deprecated"
  resultType="hashmap"
  resultMap="personResultMap"
  flushCache="false"
  useCache="true"
  timeout="10"
  fetchSize="256"
  statementType="PREPARED"
  resultSetType="FORWARD_ONLY"
  databaseId="mysql"
  resultOrdered="false"
  resultSets="rs1,rs2,rs3">
  select * from t_user
</select>

下面詳細(xì)介紹一下,略微冗長,一口氣看完吧:

  • id 必填項(xiàng),在命名空間下的唯一標(biāo)識,可被 Mybatis 引用,如果存在相同的 “ 命名空間 + 語句id ” 組合,Mybatis 將拋出異常;
  • parameterType 可選項(xiàng),傳入語句的參數(shù)的類全限定名或別名,可以是基本類型、map 或 JavaBean 等復(fù)雜的參數(shù)類型傳遞給 SQL;
  • parameterMap 用于引用外部 parameterMap 的屬性塊,目前已被廢棄。以后請使用行內(nèi)參數(shù)映射和 parameterType 屬性。
  • resultType 可選項(xiàng),定義類的全路徑,在允許自動匹配的情況下,結(jié)果集將通過 Javaben 的規(guī)范映射,或定義為 int 、double、float 等參數(shù);也可以使用別名,但是要符合別名規(guī)范和定義。 resultType 和 resultMap 之間只能同時(shí)使用一個(gè)。(日常中,比如我們統(tǒng)計(jì)結(jié)果總條數(shù)的時(shí)候可以設(shè)置為 int );
  • resultMap 可選項(xiàng),對外部 resultMap 的命名引用。結(jié)果映射是 MyBatis 最強(qiáng)大的特性,如果你對其理解透徹,許多復(fù)雜的映射問題都能迎刃而解,后面一對一、一對多、多對多我們會有一篇文章單獨(dú)講解。 resultType 和 resultMap 之間只能同時(shí)使用一個(gè)。
  • flushCache 可選項(xiàng),清空緩存,將其設(shè)置為 true 后,只要語句被調(diào)用,都會導(dǎo)致本地緩存和二級緩存被清空,默認(rèn)值:false。
  • useCache 可選項(xiàng),使用緩存,將其設(shè)置為 true 后,將會導(dǎo)致本條語句的結(jié)果被二級緩存緩存起來,默認(rèn)值:對 select 元素為 true。
  • timeout 可選項(xiàng),這個(gè)設(shè)置是在拋出異常之前,驅(qū)動程序等待數(shù)據(jù)庫返回請求結(jié)果的秒數(shù)。默認(rèn)值為未設(shè)置(unset)(依賴數(shù)據(jù)庫驅(qū)動)。
  • fetchSize 可選項(xiàng),獲取記錄的總條數(shù)設(shè)定。這是一個(gè)給驅(qū)動的建議值,嘗試讓驅(qū)動程序每次批量返回的結(jié)果行數(shù)等于這個(gè)設(shè)置值。 默認(rèn)值為未設(shè)置(unset)(依賴驅(qū)動)。由于性能問題,建議在 sql 做分頁處理。
  • statementType 可選項(xiàng),可選 STATEMENT,PREPARED 或 CALLABLE。這會讓 MyBatis 分別使用 Statement,PreparedStatement 或 CallableStatement,默認(rèn)值:PREPARED。
  • resultSetType 可選項(xiàng),F(xiàn)ORWARD_ONLY,SCROLL_SENSITIVE, SCROLL_INSENSITIVE 或 DEFAULT(等價(jià)于 unset) 中的一個(gè),默認(rèn)值為 unset (依賴數(shù)據(jù)庫驅(qū)動)。
- FORWARD_ONLY,只允許游標(biāo)向前訪問;
- SCROLL_SENSITIVE,允許游標(biāo)雙向滾動,但不會及時(shí)更新數(shù)據(jù),也就是說如果數(shù)據(jù)庫中的數(shù)據(jù)被修改過,并不會在resultSet中及時(shí)更新出來;
- SCROLL_INSENSITIVE ,允許游標(biāo)雙向滾動,如果數(shù)據(jù)庫中的數(shù)據(jù)被修改過,會及時(shí)更新到resultSet;

我們知道 JDBC 通過 ResultSet 來對查詢結(jié)果進(jìn)行封裝,ResultSet 對象本身包含了一個(gè)由查詢語句返回的一個(gè)結(jié)果集合。例如你經(jīng)常在 JDBC 見過的結(jié)果集讀?。?/p>

// 允許滾動游標(biāo)索引結(jié)果集
while( rs.next() ){
    rs.getString("name");
}
// 當(dāng)然也支持游標(biāo)定位到最后一個(gè)位置
rs.last();
// 向后滾動
rs.previous();
  • databaseId 可選項(xiàng),如果配置了數(shù)據(jù)庫廠商標(biāo)識(databaseIdProvider),MyBatis 會加載所有不帶 databaseId 或匹配當(dāng)前 databaseId 的語句;如果帶和不帶的語句都有,則不帶的會被忽略。
  • resultOrdered 可選項(xiàng),這個(gè)設(shè)置僅針對嵌套結(jié)果 select 語句:如果為 true,將會假設(shè)包含了嵌套結(jié)果集或是分組,當(dāng)返回一個(gè)主結(jié)果行時(shí),就不會產(chǎn)生對前面結(jié)果集的引用。 這就使得在獲取嵌套結(jié)果集的時(shí)候不至于內(nèi)存不夠用。默認(rèn)值:false。
  • resultSets 這個(gè)設(shè)置僅適用于多結(jié)果集的情況。它將列出語句執(zhí)行后返回的結(jié)果集并賦予每個(gè)結(jié)果集一個(gè)名稱,多個(gè)名稱之間以逗號分隔。

insert / update / delete 增刪改

數(shù)據(jù)變更語句 insert,update 和 delete 的實(shí)現(xiàn)非常接近,而且相對于 select 元素而言要簡單許多。

<insert
  id="insertUser"
  parameterType="domain.vo.User"
  flushCache="true"
  statementType="PREPARED"
  keyProperty=""
  keyColumn=""
  useGeneratedKeys=""
  timeout="20">

<update
  id="updateUser"
  parameterType="domain.vo.User"
  flushCache="true"
  statementType="PREPARED"
  timeout="20">

<delete
  id="deleteUser"
  parameterType="domain.vo.User"
  flushCache="true"
  statementType="PREPARED"
  timeout="20">

其中大部分屬性和 select 元素相同,我們介紹 3 個(gè)不同的屬性:

  • useGeneratedKeys : (僅適用于 insert 和 update)這會令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法來取出由數(shù)據(jù)庫內(nèi)部生成的主鍵(比如:像 MySQL 和 SQL Server 這樣的關(guān)系型數(shù)據(jù)庫管理系統(tǒng)的自動遞增字段),默認(rèn)值:false。
  • keyProperty : (僅適用于 insert 和 update)指定能夠唯一識別對象的屬性,MyBatis 會使用 getGeneratedKeys 的返回值或 insert 語句的 selectKey 子元素設(shè)置它的值,默認(rèn)值:未設(shè)置(unset)。如果生成列不止一個(gè),可以用逗號分隔多個(gè)屬性名稱。
  • keyColumn : (僅適用于 insert 和 update)設(shè)置生成鍵值在表中的列名,在某些數(shù)據(jù)庫(像 PostgreSQL)中,當(dāng)主鍵列不是表中的第一列的時(shí)候,是必須設(shè)置的。如果生成列不止一個(gè),可以用逗號分隔多個(gè)屬性名稱。

我們先看看 insert,update 和 delete 語句的示例:

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

<update id="updateUser">
  update t_user set name = #{name} where id = #{id}
</update>

<delete id="deleteUser">
  delete from t_user where id = #{id}
</delete>

如前所述,插入語句的配置規(guī)則更加豐富,在插入語句里面有一些額外的屬性和子元素用來處理主鍵的生成,并且提供了多種生成方式。

首先,如果你的數(shù)據(jù)庫支持 自動生成主鍵 的字段(比如 MySQL 和 SQL Server),那么你可以設(shè)置 useGeneratedKeys=”true”,然后再把 keyProperty 設(shè)置為目標(biāo)屬性就 OK 了。例如,如果上面的 t_user 表已經(jīng)在 id 列上使用了自動生成,那么語句可以修改為:

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

如果你的數(shù)據(jù)庫還支持多行插入, 你也可以傳入一個(gè) User 數(shù)組或集合,并返回自動生成的主鍵。

<insert id="insertUser" useGeneratedKeys="true"
    keyProperty="id">
  
  insert into t_user (name) values  
    
  <foreach item="item" collection="list" separator=",">
    (#{item.name})
  </foreach>
</insert>

對于不支持自動生成主鍵列的數(shù)據(jù)庫和可能不支持自動生成主鍵的 JDBC 驅(qū)動,MyBatis 有另外一種方法來生成主鍵

這里有一個(gè)簡單(也很傻)的示例,它可以生成一個(gè)隨機(jī) ID(不建議實(shí)際使用,這里只是為了展示 MyBatis 處理問題的靈活性和寬容度):

<insert id="insertUser">
 
  <selectKey keyProperty="id" resultType="int" order="BEFORE">
    select CAST(RANDOM()*1000000 as INTEGER) a from SYSIBM.SYSDUMMY1
  </selectKey>
    
  insert into t_user (id, name)
  values  (#{id}, #{name})
</insert>

在上面的示例中,首先會運(yùn)行 selectKey 元素中的語句,并設(shè)置 User 的 id,然后才會調(diào)用插入語句。這樣就實(shí)現(xiàn)了數(shù)據(jù)庫自動生成主鍵類似的行為,同時(shí)保持了 Java 代碼的簡潔。

selectKey 元素描述如下:

<selectKey
  keyProperty="id"
  resultType="int"
  order="BEFORE"
  statementType="PREPARED">

selectKey 中的 order 屬性有2個(gè)選擇:BEFORE 和 AFTER 。

  • BEFORE:表示先執(zhí)行selectKey的語句,然后將查詢到的值設(shè)置到 JavaBean 對應(yīng)屬性上,然后再執(zhí)行 insert 語句。
  • AFTER:表示先執(zhí)行 AFTER 語句,然后再執(zhí)行 selectKey 語句,并將 selectKey 得到的值設(shè)置到 JavaBean 中的屬性。上面示例中如果改成 AFTER,那么插入的 id 就會是空值,但是返回的 JavaBean 屬性內(nèi)會有值。

cache 緩存

緩存對于互聯(lián)網(wǎng)系統(tǒng)來說特別常見,其特點(diǎn)就是將數(shù)據(jù)保存在內(nèi)存中。MyBatis 內(nèi)置了一個(gè)強(qiáng)大的事務(wù)性查詢緩存機(jī)制,它可以非常方便地配置和定制。 為了使它更加強(qiáng)大而且易于配置,我們對 MyBatis 3 中的緩存實(shí)現(xiàn)進(jìn)行了許多改進(jìn)。

默認(rèn)情況下,只啟用了本地的會話緩存(即一級緩存,sqlSession級別 ),它僅僅對一個(gè)會話中的數(shù)據(jù)進(jìn)行緩存。 要啟用全局的二級緩存,首先在全局配置文件config.xml文件中加入如下代碼:

<!--開啟二級緩存--> 
<settings> 
    <setting name="cacheEnabled" value="true"/> </settings>

其次在UserMapper.xml文件中開啟緩存:

<!--開啟二級緩存--> 
<cache></cache>

基本上就是這樣。這個(gè)簡單語句的效果如下:

  • 映射語句文件中的所有 select 語句的結(jié)果將會被緩存。
  • 映射語句文件中的所有 insert、update 和 delete 語句會刷新緩存。
  • 緩存會使用最近最少使用算法(LRU, Least Recently Used)算法來清除不需要的緩存。
  • 緩存不會定時(shí)進(jìn)行刷新(也就是說,沒有刷新間隔)。
  • 緩存會保存列表或?qū)ο螅o論查詢方法返回哪種)的 1024 個(gè)引用。
  • 緩存會被視為讀/寫緩存,這意味著獲取到的對象并不是共享的,可以安全地被調(diào)用者修改,而不干擾其他調(diào)用者或線程所做的潛在修改。

緩存只作用于 cache 標(biāo)簽所在的映射文件中的語句。如果你混合使用 Java API 和 XML 映射文件,在共用接口中的語句將不會被默認(rèn)緩存。你需要使用 @CacheNamespaceRef 注解指定緩存作用域。

這些屬性可以通過 cache 元素的屬性來修改。比如:

<cache
  eviction="FIFO"
  flushInterval="60000"
  size="512"
  readOnly="true"/>

上面表示了一套更高級的緩存配置,首先創(chuàng)建了一個(gè) FIFO 緩存,每隔 60 秒刷新,最多可以存儲結(jié)果對象或列表的 512 個(gè)引用,然后返回的對象被設(shè)置成只讀的,因此對它們進(jìn)行修改可能會在不同線程中的調(diào)用者產(chǎn)生沖突。

緩存可用的清除策略有:

  • LRU – 最近最少使用:移除最長時(shí)間不被使用的對象。
  • FIFO – 先進(jìn)先出:按對象進(jìn)入緩存的順序來移除它們。
  • SOFT – 軟引用:基于垃圾回收器狀態(tài)和軟引用規(guī)則移除對象。
  • WEAK – 弱引用:更積極地基于垃圾收集器狀態(tài)和弱引用規(guī)則移除對象。

默認(rèn)的清除策略是 LRU

flushInterval(刷新間隔)屬性可以被設(shè)置為任意的正整數(shù),設(shè)置的值應(yīng)該是一個(gè)以毫秒為單位的合理時(shí)間量。 默認(rèn)情況是不設(shè)置,也就是沒有刷新間隔,緩存僅僅會在調(diào)用語句時(shí)刷新。

size(引用數(shù)目)屬性可以被設(shè)置為任意正整數(shù),要注意欲緩存對象的大小和運(yùn)行環(huán)境中可用的內(nèi)存資源。默認(rèn)值是 1024。

readOnly(只讀)屬性可以被設(shè)置為 true 或 false。只讀的緩存會給所有調(diào)用者返回緩存對象的相同實(shí)例。 因此這些對象不能被修改。這就提供了可觀的性能提升。而可讀寫的緩存會(通過序列化)返回緩存對象的拷貝。 速度上會慢一些,但是更安全,因此默認(rèn)值是 false。

二級緩存是事務(wù)性的。這意味著,當(dāng) SqlSession 完成并提交 ( commit ) 時(shí),或是完成并回滾 ( close ) 時(shí),二級緩存都會被刷新。不管是否配置了 flushCache=true 。

Mybatis 的緩存包括一級緩存(sqlSession 級別)和二級緩存(mapper 級別),所以 mapper 映射器中配置的是二級緩存,我們先大概知道有這個(gè)概念,因?yàn)楹罄m(xù)我們會針對這兩種緩存進(jìn)行詳細(xì)介紹,而且還會講解如何自定義緩存,因?yàn)?Mybatis 的緩存默認(rèn)都是以 map 的數(shù)據(jù)結(jié)構(gòu)存儲在本地,所以自定義緩存可以把存儲介質(zhì)拓展到磁盤或數(shù)據(jù)庫redis等;而且一級緩存是默認(rèn)開啟的,二級緩存需要我們手工開啟,這些后續(xù)都會詳細(xì)講解,提前預(yù)告。

緩存獲取順序:二級緩存 > 一級緩存 > 數(shù)據(jù)庫

cache-ref 引用緩存

回想一下 cache 的內(nèi)容,對某一命名空間的語句,只會使用該命名空間的緩存進(jìn)行緩存或刷新。 但你可能會想要在多個(gè)命名空間中共享相同的緩存配置和實(shí)例。要實(shí)現(xiàn)這種需求,你可以使用 cache-ref 元素來引用另一個(gè)緩存。

<cache-ref namespace="com.vo.UserMapper"/>

sql 語句塊

這個(gè)元素可以用來定義可重用的 SQL 代碼片段,以便在其它語句中使用。 參數(shù)可以靜態(tài)地(在加載的時(shí)候)確定下來,并且可以在不同的 include 元素中定義不同的參數(shù)值。比如:

<sql id="userColumns"> 
    ${alias}.id,${alias}.name 
</sql>

這個(gè) SQL 片段可以在其它語句中使用,例如:

<select id="selectUsers" resultType="map">
  select
    <include refid="userColumns">
        <property name="alias" value="t1"/>
    </include>,
    <include refid="userColumns">
        <property name="alias" value="t2"/>
    </include>
  from t_user t1 cross join t_user t2
</select>

也可以在 include 元素的 refid 屬性或多層內(nèi)部語句中使用屬性值,例如:

<sql id="sql1">
  ${prefix}_user
</sql>

<sql id="sql2">
  from
    <include refid="${include_target}"/>
</sql>

<select id="select" resultType="map">
  select
    id, name
  <include refid="sql2">
    <property name="prefix" value="t"/>
    <property name="include_target" value="sql1"/>
  </include>
</select>

parameterMap 參數(shù)映射

parameterMap 元素官方已經(jīng)不建議使用,并且再后續(xù)版本會退出舞臺。首先對于我們 Java 來說,特別不希望在代碼中通過傳遞 map 來傳參,這樣對于后續(xù)維護(hù)或者參數(shù)查找都是極不負(fù)責(zé)任的,我們推薦使用 JavaBean 來傳值參數(shù),這是 parameterMap 被拋棄的其中一個(gè)原因;另外也由于 parameterType 屬性的誕生就能很好的代替 parameterMap ,并且還能自定義 JavaBean 類型的傳參,所以 parameterMap 退出舞臺,實(shí)屬正常。

總結(jié)

我一直來都希望自己只輸出觀點(diǎn),而不是輸出字典,但其中有些知識點(diǎn)又是極其冗雜,知識輸出真是個(gè)難搞的差事,如何既能把知識脈絡(luò)梳理的完整,又能講得淺顯易懂,言簡意賅,確實(shí)是后續(xù)文章分解輸出的研究方向。

本篇完,本系列下一篇我們講《 Mybatis系列全解(六):Mybatis最硬核的API你知道幾個(gè)? 》。

BIU ~ 文章持續(xù)更新,微信搜索「潘潘和他的朋友們」第一時(shí)間閱讀,隨時(shí)有驚喜。本文會在 GitHub https://github.com/JavaWorld 收錄,熱騰騰的技術(shù)、框架、面經(jīng)、解決方案,我們都會以最美的姿勢第一時(shí)間送達(dá),歡迎 Star ~ 我們未來 不止文章!想進(jìn)讀者群的伙伴歡迎撩我個(gè)人號:panshenlian,備注「加群」我們?nèi)豪餁g聊吧 ~

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容