MyBatis 緩存配置 之 二級緩存

二級緩存

MyBatis 的二級緩存非常強(qiáng)大屎慢,它不同于一級緩存只存在于 SqlSession 的生命周期中,而是可以理解為存在于 SqlSessionFactory 的生命周期中淹接。

配置二級緩存

MyBatis 的二級緩存是和命名空間綁定的鲸鹦,即二級緩存需要配置在 Mapper.xml 映射文件中憋沿,或者配置在 Mapper.java 接口中。在映射文件中季稳,命名空間就是 XML 根節(jié)點 mapper 的 namespace 屬性擅这。在 Mapper 接口中,命名空間就是接口的全限定名稱景鼠。

開啟二級緩存

在 MyBatis 的全局配置 settings 中有一個參數(shù) cacheEnabled仲翎,這個參數(shù)是二級緩存的全局開關(guān),默認(rèn)值是 true 铛漓,初始狀態(tài)為啟用狀態(tài)溯香。如果把這個參數(shù)設(shè)置為 false,即使有后面的二級緩存配置浓恶,也不會生效逐哈。由于這個參數(shù)值默認(rèn)為 true,所以不必配置问顷,如果想配置,可以在 mybatis-config.xml 中添加如下代碼禀梳。

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

Mapper.xml 中配置二級緩存

在保證二級緩存的全局配置開啟的情況下杜窄,給 UserMapper.xml 開啟二級緩存只需要在 UserMapper.xml 中添加 <cache/> 標(biāo)簽即可,添加后的 UserMapper.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="com.mybatis.mapper.UserMapper">
    <!--二級緩存默認(rèn)配置-->
    <cache/>
    
    <!--其他配置-->
</mapper>

默認(rèn)的二級緩存會有如下效果塞耕。

  • 映射語句文件中的所有 SELECT 語句將會配緩存。
  • 映射語句文件中的所有 INSERT嘴瓤、UPDATE扫外、DELETE 語句會刷新緩存。
  • 緩存會使用 Least Recently Used (LRU廓脆,最近最少使用的)算法來回收筛谚。
  • 根據(jù)時間表(如 no Flush Interval,沒有刷新時間)停忿,緩存不會以任何時間順序來刷新驾讲。
  • 緩存會存儲集合或?qū)ο螅o論查詢方法返回什么類型的值)的1024個引用。
  • 緩存會被視為 read/write(可讀/可寫)的席赂,意味著對象檢索不是共享的吮铭,而且可以安全的被調(diào)用者修改,而不干擾其他調(diào)用者或線程所做的潛在修改颅停。

所有的這些屬性都可以通過緩存原屬的屬性來修改谓晌,示例如下。

<?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="com.mybatis.mapper.UserMapper">
    <!--二級緩存自定義配置-->
    <cache eviction="FIFO"
           flushInterval="60000"
           size="512"
           readOnly="true"/>
    
    <!--其他配置-->
</mapper>

這個更高級的配置創(chuàng)建了一個 FIFO 緩存癞揉,并每隔60秒刷新一次纸肉,存儲集合或?qū)ο蟮?12個引用溺欧,而且返回的對象被認(rèn)為是只讀的,因此在不同的線程中的調(diào)用者之間修改它們會導(dǎo)致沖突毁靶。

<cache> 標(biāo)簽可以配置的屬性如下胧奔。

  • eviction(回收策略)

    • LUR(最近最少使用):移除最長時間不被使用的對象,這是默認(rèn)值预吆。
    • FIFO(先進(jìn)先出):按對象進(jìn)入緩存的順序來析出它們龙填。
    • SOFT(軟引用):移除基于垃圾回收器狀態(tài)和軟引用規(guī)則的對象。
    • WEAK(弱引用):更積極的移除基于垃圾收集器狀態(tài)和弱引用規(guī)則的對象拐叉。
  • flushInterval(刷新時間)

    可以被設(shè)置為任意的正整數(shù)岩遗,而且她們代表一個合理的毫秒形成的時間段。默認(rèn)情況不設(shè)置凤瘦,即沒有刷新間隔宿礁,緩存僅僅在調(diào)用語句時刷新。

  • size(引用數(shù)目)

    可以被設(shè)置為任意的正整數(shù)蔬芥,要記住緩存的對象數(shù)目和運(yùn)行環(huán)境的可用內(nèi)存資源數(shù)目梆靖。默認(rèn)值是 1024。

  • readOnly(只讀)

    readOnly 屬性可以配設(shè)置為 true 或 false笔诵。只讀的緩存會給所有調(diào)用者返回緩存對象的相同實例返吻,因此這些對象不能被修改,這提供了很重要的性能優(yōu)勢乎婿〔饨可讀寫的緩存會通過序列化返回緩存對象的拷貝,這種方式會慢一些谢翎,但是安全捍靠,因此默認(rèn)是 false。

Mapper 接口中配置二級緩存

在使用注解方式進(jìn)行開發(fā)時森逮,如果相對注解方法啟用二級緩存榨婆,則需要在 Mapper 接口中進(jìn)行配置。

@CacheNamespace
public interface AnnotationUserMapper {
    // 接口方法
}

只需要在接口類上增加 @CacheNamespace 注解即可 褒侧,該注解同 XML 文件中的 <cache/> 標(biāo)簽纲辽。

自定義配置各項屬性,示例如下璃搜。

@CacheNamespace(
        eviction = FifoCache.class,
        flushInterval = 60000,
        size = 512,
        readWrite = true
)

這里的 readWrite 屬性和 XML 中的 readOnly 屬性一樣拖吼,用于配置緩存是否為只讀類型,在這里 true 為讀寫这吻,false為只讀吊档,默認(rèn)為 true。

xml 和 接口中同時配置二級緩存

當(dāng)同時使用注解方式和 XML 映射文件時唾糯,如果同時配置了二級緩存怠硼,就會拋出如下異常鬼贱。

Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: java.lang.IllegalArgumentException: Caches collection already contains value for com.mybatis.mapper.AnnotationUserMapper

這是應(yīng)為 Mapper 接口和對應(yīng)的 XML 文件是相同的命名空間,想使用二級緩存香璃,兩者必須同時配置这难,如果接口中不存在使用注解的方法,則可以只在 XML 文件中配置葡秒。

因此這個時候應(yīng)該使用參照緩存來避免同時配置二級緩存導(dǎo)致的錯誤姻乓。

1.在 Mapper 接口中進(jìn)行修改

@CacheNamespaceRef(AnnotationUserMapper.class)
public interface AnnotationUserMapper {
    // 接口方法
}

如例所示,想讓 AnnotationUserMapper 接口中的注釋方法和 XML 中的方法使用相同緩存眯牧,因此使用參照緩存 AnnotationUserMapper.class 蹋岩,這樣就會使用命名空間為 com.mybatis.mapper.AnnotationUserMapper 的緩存配置,即 AnnotationUserMapper.xml 中配置的緩存学少。

2.在 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="com.mybatis.mapper.AnnotationUserMapper">
    <cache-ref namespace="com.mybatis.mapper.AnnotationUserMapper"/>

</mapper>

這樣配置后剪个,XML 就會引用 Mapper 接口中配置的二級緩存。

參考資料:MyBatis 從入門到精通 作者:劉增輝

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末版确,一起剝皮案震驚了整個濱河市扣囊,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌绒疗,老刑警劉巖侵歇,帶你破解...
    沈念sama閱讀 222,183評論 6 516
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異忌堂,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)酗洒,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,850評論 3 399
  • 文/潘曉璐 我一進(jìn)店門士修,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人樱衷,你說我怎么就攤上這事棋嘲。” “怎么了矩桂?”我有些...
    開封第一講書人閱讀 168,766評論 0 361
  • 文/不壞的土叔 我叫張陵沸移,是天一觀的道長。 經(jīng)常有香客問我侄榴,道長雹锣,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 59,854評論 1 299
  • 正文 為了忘掉前任癞蚕,我火速辦了婚禮蕊爵,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘桦山。我一直安慰自己攒射,他們只是感情好醋旦,可當(dāng)我...
    茶點故事閱讀 68,871評論 6 398
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著会放,像睡著了一般饲齐。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上咧最,一...
    開封第一講書人閱讀 52,457評論 1 311
  • 那天捂人,我揣著相機(jī)與錄音,去河邊找鬼窗市。 笑死先慷,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的咨察。 我是一名探鬼主播论熙,決...
    沈念sama閱讀 40,999評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼摄狱!你這毒婦竟也來了脓诡?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,914評論 0 277
  • 序言:老撾萬榮一對情侶失蹤媒役,失蹤者是張志新(化名)和其女友劉穎祝谚,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體酣衷,經(jīng)...
    沈念sama閱讀 46,465評論 1 319
  • 正文 獨居荒郊野嶺守林人離奇死亡交惯,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,543評論 3 342
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了穿仪。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片席爽。...
    茶點故事閱讀 40,675評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖啊片,靈堂內(nèi)的尸體忽然破棺而出只锻,到底是詐尸還是另有隱情,我是刑警寧澤紫谷,帶...
    沈念sama閱讀 36,354評論 5 351
  • 正文 年R本政府宣布齐饮,位于F島的核電站,受9級特大地震影響笤昨,放射性物質(zhì)發(fā)生泄漏祖驱。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 42,029評論 3 335
  • 文/蒙蒙 一瞒窒、第九天 我趴在偏房一處隱蔽的房頂上張望羹膳。 院中可真熱鬧,春花似錦根竿、人聲如沸陵像。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,514評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽醒颖。三九已至妻怎,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間泞歉,已是汗流浹背逼侦。 一陣腳步聲響...
    開封第一講書人閱讀 33,616評論 1 274
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留腰耙,地道東北人榛丢。 一個月前我還...
    沈念sama閱讀 49,091評論 3 378
  • 正文 我出身青樓,卻偏偏與公主長得像挺庞,于是被迫代替她去往敵國和親晰赞。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,685評論 2 360

推薦閱讀更多精彩內(nèi)容

  • 1. 簡介 1.1 什么是 MyBatis 选侨? MyBatis 是支持定制化 SQL掖鱼、存儲過程以及高級映射的優(yōu)秀的...
    笨鳥慢飛閱讀 5,527評論 0 4
  • 如果你覺得不夠上根利智,不妨學(xué)會笨一點地堅持援制。學(xué)一點用一點戏挡,相信水滴石穿的耐力。 ???
    法振閱讀 118評論 0 0
  • 董沛沛 洛陽 焦點講師班三期 堅持原創(chuàng)分享第369天 在焦點的咨詢中晨仑,選擇了來訪者的資源后褐墅,接下來要做的就是建構(gòu),...
    緣源流長閱讀 233評論 0 0