MyBatis 缓存详解

参考文档：MyBatis官方文档

MyBatis的缓存主要分为两种一级缓存也叫本地缓存（local cache）和二级缓存（second level cache）。

一级缓存、本地缓存

一级缓存是session级缓存，即缓存只在session范围生效。

每当一个新 session 被建立，MyBatis 就会建立一个与之相关联的本地缓存。任何在 session 执行过的查询语句自己都会被保存在本地缓存中，那么，相同的查询语句和相同的参数所产生的更改就不会二度影响数据库了。本地缓存会被增删改、提交事务、关闭事务以及关闭 session 所清空。

默认状况下，本地缓存数据可在整个 session 的周期内使用，这一缓存须要被用来解决循环引用错误和加快重复嵌套查询的速度，因此它不能够被禁用掉，可是你能够设置 localCacheScope=STATEMENT 表示缓存仅在语句执行时有效。

注意，若是 localCacheScope 被设置为 SESSION，那么 MyBatis 所返回的引用将传递给保存在本地缓存里的相同对象。对返回的对象（例如 list）作出任何更新将会影响本地缓存的内容，进而影响存活在 session 生命周期中的缓存所返回的值。所以，不要对 MyBatis 所返回的对象做出更改，以防后患。

手动清空本地缓存：

void clearCache()

二级缓存

二级缓存是namespace级缓存，二级缓存会在同一 namespace中生效。

默认状况下，MyBatis 3 没有开启二级缓存，要开启二级缓存,你须要在你的 SQL 映射文件（mapper.xml）中添加一行:

<cache/>

其实还须要在配置文件中把mybatis.configuration.cache-enabled设置为true(默认为true)，若添加<cache/>标签后缓存不生效，能够检查是否将其设置为了false

字面上看就是这样。这个简单语句的效果以下:

• 映射语句文件中的全部 select 语句将会被缓存。
• 映射语句文件中的全部 insert,update 和 delete 语句会刷新缓存。
• 缓存会使用 Least Recently Used(LRU,最近最少使用的)算法来收回。
• 根据时间表(好比 no Flush Interval,没有刷新间隔), 缓存不会以任什么时候间顺序 来刷新。
• 缓存会存储列表集合或对象(不管查询方法返回什么)的 1024 个引用。
• 缓存会被视为是 read/write(可读/可写)的缓存,意味着对象检索不是共享的,而 且能够安全地被调用者修改,而不干扰其余调用者或线程所作的潜在修改。

全部的这些属性均可以经过缓存元素的属性来修改。好比:

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

这个更高级的配置建立了一个 FIFO 缓存，并每隔 60 秒刷新，存数结果对象或列表的 512 个引用，并且返回的对象被认为是只读的，所以在不一样线程中的调用者之间修改它们会 致使冲突。

可用的收回策略有:

• LRU – 最近最少使用的:移除最长时间不被使用的对象。
• FIFO – 先进先出:按对象进入缓存的顺序来移除它们。
• SOFT – 软引用:移除基于垃圾回收器状态和软引用规则的对象。
• WEAK – 弱引用:更积极地移除基于垃圾收集器状态和弱引用规则的对象。

默认的缓存回收策略是 LRU。

flushInterval(刷新间隔)能够被设置为任意的正整数，并且它们表明一个合理的毫秒形式的时间段。默认状况是不设置，也就是没有刷新间隔，缓存仅仅调用语句时刷新。

size(引用数目)能够被设置为任意正整数,要记住你缓存的对象数目和你运行环境的 可用内存资源数目。默认值是 1024。

readOnly(只读)属性能够被设置为 true 或 false。只读的缓存会给全部调用者返回缓 存对象的相同实例。所以这些对象不能被修改。这提供了很重要的性能优点。可读写的缓存 会返回缓存对象的拷贝(经过序列化) 。这会慢一些,可是安全,所以默认是 false。

若在SqlSession关闭时，SqlSession对应的本地缓存会自动转化为二级缓存。

自定义缓存

使用自定缓存，只须要实现MyBatis的Cache接口并在<cache/>中配置缓存类型：

<cache type="com.domain.something.MyCustomCache"/>

自定义缓存没有使用过，若是你们有兴趣能够参考MyBatis官方文档自定义缓存部分

后记

这篇文章主要由MyBatis官方文档整理而来，用于记录个人学习过程，做为2019年的开始，之后的学习都须要有产出物，不然学了以后很快就会忘记。