创新互联MyBatis教程:MyBatis3XML映射文件-缓存

Mybatis 内置了一个强大的事务性查询缓存机制,它可以非常方便地配置和定制。 为了使它更加强大而且易于配置,我们对 MyBatis 3 中的缓存实现进行了许多改进。

网站建设哪家好,找创新互联!专注于网页设计、网站建设、微信开发、微信小程序、集团企业网站建设等服务项目。为回馈新老客户创新互联还提供了安塞免费建站欢迎大家使用!

默认情况下,只启用了本地的会话缓存,它仅仅对一个会话中的数据进行缓存。 要启用全局的二级缓存,只需要在你的 SQL 映射文件中添加一行:

基本上就是这样。这个简单语句的效果如下:

  • 映射语句文件中的所有 ​select ​语句的结果将会被缓存。
  • 映射语句文件中的所有 ​insert​、​update ​和 ​delete ​语句会刷新缓存。
  • 缓存会使用最近最少使用算法(​LRU​, ​Least Recently Used​)算法来清除不需要的缓存。
  • 缓存不会定时进行刷新(也就是说,没有刷新间隔)。
  • 缓存会保存列表或对象(无论查询方法返回哪种)的 1024 个引用。
  • 缓存会被视为读/写缓存,这意味着获取到的对象并不是共享的,可以安全地被调用者修改,而不干扰其他调用者或线程所做的潜在修改。

缓存只作用于 cache 标签所在的映射文件中的语句。如果你混合使用 Java API 和 XML 映射文件,在共用接口中的语句将不会被默认缓存。你需要使用 ​@CacheNamespaceRef​ 注解指定缓存作用域。

这些属性可以通过 cache 元素的属性来修改。比如:

这个更高级的配置创建了一个 ​FIFO ​缓存,每隔 60 秒刷新,最多可以存储结果对象或列表的 512 个引用,而且返回的对象被认为是只读的,因此对它们进行修改可能会在不同线程中的调用者产生冲突。

可用的清除策略有:

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

默认的清除策略是 ​LRU​。

flushInterval​(刷新间隔)属性可以被设置为任意的正整数,设置的值应该是一个以毫秒为单位的合理时间量。 默认情况是不设置,也就是没有刷新间隔,缓存仅仅会在调用语句时刷新。

size​(引用数目)属性可以被设置为任意正整数,要注意欲缓存对象的大小和运行环境中可用的内存资源。默认值是 1024。

readOnly​(只读)属性可以被设置为 ​true ​或 ​false​。只读的缓存会给所有调用者返回缓存对象的相同实例。 因此这些对象不能被修改。这就提供了可观的性能提升。而可读写的缓存会(通过序列化)返回缓存对象的拷贝。 速度上会慢一些,但是更安全,因此默认值是 ​false​。

二级缓存是事务性的。这意味着,当 ​SqlSession ​完成并提交时,或是完成并回滚,但没有执行 ​flushCache=true​ 的 ​insert​/​delete​/​update ​语句时,缓存会获得更新。

使用自定义缓存

除了上述自定义缓存的方式,你也可以通过实现你自己的缓存,或为其他第三方缓存方案创建适配器,来完全覆盖缓存行为。

这个示例展示了如何使用一个自定义的缓存实现。​type ​属性指定的类必须实现 ​org.apache.ibatis.cache.Cache​ 接口,且提供一个接受 ​String ​参数作为 id 的构造器。 这个接口是 MyBatis 框架中许多复杂的接口之一,但是行为却非常简单。

public interface Cache {
  String getId();
  int getSize();
  void putObject(Object key, Object value);
  Object getObject(Object key);
  boolean hasKey(Object key);
  Object removeObject(Object key);
  void clear();
}

为了对你的缓存进行配置,只需要简单地在你的缓存实现中添加公有的 ​JavaBean ​属性,然后通过 ​cache ​元素传递属性值,例如,下面的例子将在你的缓存实现上调用一个名为 ​setCacheFile(String file)​ 的方法:


  

你可以使用所有简单类型作为 ​JavaBean ​属性的类型,MyBatis 会进行转换。 你也可以使用占位符(如 ​${cache.file}​),以便替换成在配置文件属性中定义的值。

从版本 3.4.2 开始,MyBatis 已经支持在所有属性设置完毕之后,调用一个初始化方法。 如果想要使用这个特性,请在你的自定义缓存类里实现 ​org.apache.ibatis.builder.InitializingObject​ 接口。

public interface InitializingObject {
  void initialize() throws Exception;
}

上一节中对缓存的配置(如清除策略、可读或可读写等),不能应用于自定义缓存。

请注意,缓存的配置和缓存实例会被绑定到 SQL 映射文件的命名空间中。 因此,同一命名空间中的所有语句和缓存将通过命名空间绑定在一起。 每条语句可以自定义与缓存交互的方式,或将它们完全排除于缓存之外,这可以通过在每条语句上使用两个简单属性来达成。 默认情况下,语句会这样来配置: