浅析springboot的@Cacheable加入缓存@CacheEvict清除缓存及spEL表达式编写key

一、@Cacheable的作用

1、缓存使用步骤：@Cacheable这个注解，用它就是为了使用缓存的。所以我们可以先说一下缓存的使用步骤：

1、开启基于注解的缓存，使用 @EnableCaching 标识在 SpringBoot 的主启动类上。

2、标注缓存注解即可

注：这里使用 @Cacheable 注解就可以将运行结果缓存，以后查询相同的数据，直接从缓存中取，不需要调用方法

2、@Cacheable作用：把方法的返回值添加到Ehcache缓存中。

3、常用属性介绍：

（1）cacheNames/value 用来指定缓存组件的名字，将方法的返回结果放在哪个缓存中，可以是数组的方式，支持指定多个缓存

@Cacheable(cacheNames = "streamUrl", key = "#eventId", unless = "#result == null")
// 数组
@Cacheable(cacheNames = {"streamUrl", "test"}, key = "#eventId", unless = "#result == null")

（2）key：缓存数据时使用的 key。默认使用的是方法参数的值。可以使用 spEL 表达式去编写。

@Cacheable(cacheNames = "streamUrl", key = "#eventId + '[' + #id + ']'", unless = "#result == null")

（3）keyGenerator：key 的生成器，可以自己指定 key 的生成器，通过这个生成器来生成 key。

@Cacheable(value = "ip", keyGenerator = "cacheKeyGenerator")
public IPResponse query(String ip) {
　　return ipAPI.query(ip);
}

@Slf4j
@Component
public class CacheKeyGenerator implements KeyGenerator {
    @Override
    public Object generate(Object target, Method method, Object... params) {
       //...
        return key.toString();
    }
}

这样放入缓存中的 key 的生成规则就按照你自定义的 keyGenerator 来生成。不过需要注意的是：@Cacheable的属性，key 和 keyGenerator 使用的时候，一般二选一。

（4）condition：符合条件的情况下才缓存。方法返回的数据要不要缓存，可以做一个动态判断

// 表示 id 大于 1 才进行缓存
@Cacheable(cacheNames = "streamUrl", condition = "#id > 1")

（5）unless：否定缓存。当 unless 指定的条件为 true ，方法的返回值就不会被缓存。当然你也可以获取到结果进行判断。（通过 #result 获取方法结果）

（6）sync：是否使用异步模式。默认是方法执行完，以同步的方式将方法返回的结果存在缓存中。

4、spEL 编写 key

前面说过，缓存的 key 支持使用 spEL 表达式去编写，下面总结一下使用 spEL 去编写 key 可以用的一些元数据：

二、@CacheEvict的作用
1、@CacheEvict是用来标注在需要清除缓存元素的方法或类上的。当标记在一个类上时，表示其中所有的方法的执行都会触发缓存的清除操作。

@CacheEvict可以指定的属性有value、key、condition、allEntries和beforeInvocation。其中value、key和condition的语义与@Cacheable对应的属性类似。

即value表示清除操作是发生在哪些Cache上的（对应Cache的名称）；

key表示需要清除的是哪个key，如未指定则会使用默认策略生成的key；

condition表示清除操作发生的条件。下面我们来介绍一下新出现的两个属性allEntries和beforeInvocation。

2、allEntries属性

allEntries是boolean类型，表示是否需要清除缓存中的所有元素。默认为false，表示不需要。当指定了allEntries为true时，清除缓存中的所有元素，Spring Cache将忽略指定的key。

有的时候我们需要Cache一下清除所有的元素，这比一个一个清除元素更有效率。

3、beforeInvocation属性

清除操作默认是在对应方法成功执行之后触发的，即方法如果因为抛出异常而未能成功返回时也不会触发清除操作。使用beforeInvocation可以改变触发清除操作的时间，当我们指定该属性值为true时，Spring会在调用该方法之前清除缓存中的指定元素