Java中的@Cacheable注解的作用详解
作者:Myovlmx
一、@Cacheable的作用
1、缓存使用步骤:
@Cacheable这个注解,用它就是为了使用缓存的。所以我们可以先说一下缓存的使用步骤:
- 开启基于注解的缓存,使用 @EnableCaching 标识在 SpringBoot 的主启动类上。
- 标注缓存注解即可
使用 @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); }
这样放入缓存中的 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的作用
@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会在调用该方法之前清除缓存中的指定元素
到此这篇关于Java中的@Cacheable注解的作用详解的文章就介绍到这了,更多相关Java中的@Cacheable注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!