Spring boot 使用注解缓存

注解在Spring中的应用很广泛，几乎成为了其标志，这里说下使用注解来集成缓存。 
cache方面的注解主要有以下5个

@Cacheable 触发缓存入口（这里一般放在创建和获取的方法上）
@CacheEvict 触发缓存的eviction（用于删除的方法上）
@CachePut 更新缓存且不影响方法执行（用于修改的方法上，该注解下的方法始终会被执行）
@Caching 将多个缓存组合在一个方法上（该注解可以允许一个方法同时设置多个注解）
@CacheConfig 在类级别设置一些缓存相关的共同配置（与其它缓存配合使用）
上边5个注解中目前我学习的时候使用了前三个，所以这里主要针对前三个来展开，后边两个结合spring官方文档来简单介绍下。

@Cacheable

先看看它的源码
 

public @interface Cacheable {

    /**
     * 设定要使用的cache的名字，必须提前定义好缓存
     */
    @AliasFor("cacheNames")
    String[] value() default {};

    /**
     * 同value()，决定要使用那个/些缓存
     */
    @AliasFor("value")
    String[] cacheNames() default {};

    /**
     * 使用SpEL表达式来设定缓存的key，如果不设置默认方法上所有参数都会作为key的一部分
     */
    String key() default "";

    /**
     * 用来生成key，与key()不可以共用
     */
    String keyGenerator() default "";

    /**
     * 设定要使用的cacheManager，必须先设置好cacheManager的bean，这是使用该bean的名字
     */
    String cacheManager() default "";

    /**
     * 使用cacheResolver来设定使用的缓存，用法同cacheManager，但是与cacheManager不可以同时使用
     */
    String cacheResolver() default "";

    /**
     * 使用SpEL表达式设定出发缓存的条件，在方法执行前生效
     */
    String condition() default "";

    /**
     * 使用SpEL设置出发缓存的条件，这里是方法执行完生效，所以条件中可以有方法执行后的value
     */
    String unless() default "";

    /**
     * 用于同步的，在缓存失效（过期不存在等各种原因）的时候，如果多个线程同时访问被标注的方法
     * 则只允许一个线程通过去执行方法
     */
    boolean sync() default false;

}
details/82429603 
版权声明：本文为博主原创文章，转载请附上博文链接！

@CachePut

这是个一般用于修改方法上的注解，它的代码跟Cacheable基本相同，这里不做介绍。 
现在说下CachePut和Cacheable的主要区别。

@Cacheable：它的注解的方法是否被执行取决于Cacheable中的条件，方法很多时候都可能不被执行。 
@CachePut：这个注解不会影响方法的执行，也就是说无论它配置的条件是什么，方法都会被执行，更多的时候是被用到修改上。

@CacheEvict

它跟上边的两个注解相比，源码中多了两个属性

public @interface CacheEvict {


    /**
     * 是否删除缓存中的所有数据，默认为false，只会删除被注解方法中传入的key的缓存
     */
    boolean allEntries() default false;

    /**
     * 设置缓存的删除在方法执行前执行还是执行后执行。如果设置true，则无论该方法是否正常结束，缓存中的值都会被删除。
     */
    boolean beforeInvocation() default false;

}

@Caching

它是个组合上面三个注解的注解，之前我并没有用到，现在结合spring文档简单说下。

源码

public @interface Caching {

    Cacheable[] cacheable() default {};

    CachePut[] put() default {};

    CacheEvict[] evict() default {};

}

它只是给出了三种注解的组合，并没有给出限制条件，所以其使用也很简单，如下

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

@CacheConfig 
类级别的注解，可以设置某类中所有注解的相同部分，这个可以参考spring的类级别的@Mapping来理解。 
其代码很简单

public @interface CacheConfig {

    String[] cacheNames() default {};

    String keyGenerator() default "";

    String cacheManager() default "";

    String cacheResolver() default "";

}