Spring的缓存

撰写于 2018-02-25 修改于 2018-12-15 标签 翻译

本文摘译自Spring Framework Document

在Spring框架中使用缓存,需要实现org.springframework.cache.Cacheorg.springframework.cache.CacheManager两个接口。前者定义了缓存操作的基本方法,例如获取,更新,剔除等操作;后者负责管理Cache对象。

Spring框架提供了几个注解方便缓存的配置:

  • @Cacheable - 开启缓存
  • @CachePut - 强制更新缓存
  • @CacheEvict - 清理缓存
  • @Caching - 将上述多条注解合并在一起
  • @CacheConfig - 类级别缓存注解

@Cacheable - 开启缓存

这是一个方法注解,表示方法的结果会被缓存。

@Cacheable({"books", "isbns"})
public Book findBook(ISBN isbn) {...}

@Cacheable默认参数为cacheNames,表示缓存对象的id,可以是1个id,也可以是1组id数组。

缓存键值

默认的缓存键值为org.springframework.cache.interceptor.SimpleKey对象。

  • 如果方法没有参数,那么键值就是SimpleKey.EMPTY
  • 如果只有一个参数,那么键值就是这个参数;
  • 如果有多个参数,那么键值就是以方法的全部参数为构造参数的SimpleKey对象。

缓存键值由org.springframework.cache.interceptor.KeyGenerator接口实现,默认实现方法是org.springframework.cache.interceptor.SimpleKeyGenerator

@Cacheable注解的key属性的值为SpEL表达式,为缓存键值的生成方法;也可以使用keyGenerator属性,使用自定义的键值生成器。

线程同步

如果有多条线程发起同样的参数调用,Spring可以保证只有一个调用被实际执行,其余调用则直接等待结果。

开启方法是sync属性设置为true

@Cacheable(cacheNames="foos", sync=true)
public Foo executeExpensiveOperation(String id) {...}

设置缓存条件

可以为conditionunless两个属性赋值,值类型为SpEL表达式,来实现部分条件下缓存方法结果。

@Cacheable(cacheNames="book", condition="#name.length() < 32")
public Optional<Book> findBook(String name)

这个例子表示name参数长度大于32的时候,调用结果不会缓存。

需要注意的是,condition是先决条件,在方法调用前判断,而unless则在方法调用后才会判断。

@CachePut - 强制更新缓存

@CachePut的用法和@Cacheable`类似。

@CacheEvict - 清理缓存

@CacheEvict可以清除Cache对象的部分内容,也可以设置allEntries属性为true从而清除Cache对象的全部内容。

通过设置beforeInvocation属性是否为true可以决定是否在方法执行前清理缓存。

@Caching - 合并注解

@Caching(evict = { @CacheEvict("primary"), @CacheEvict(cacheNames="secondary", key="#p0") })
public Book importBooks(String deposit, Date date)

@CacheConfig - 类级别缓存注解

@CacheConfig作用在类定义上,方便整合类中各方法的重复配置。

@CacheConfig("books")
public class BookRepositoryImpl implements BookRepository {

    @Cacheable
    public Book findBook(ISBN isbn) {...}
}

总体来讲,一个方法上的缓存配置,自上而下,有三个定义层面:

  1. CacheManager, KeyGenerator的全局配置
  2. @CacheConfig的类定义层级注解
  3. 方法层级注解

缓存开启

在某一个@Configuration类中,加上@EnableCaching注解。

Site by Zhang,Xin using Hexo & Random

Hide