@Cached注解在Service的方法上,实现对方法结果进行缓存。
1、返回类型不能是void
/CompletableFuture<Void>
2、返回类型必须是可json序列化的
3、修饰必须是protected
/public
4、修饰不能是final
/static
本地缓存和远程缓存可同时设置,expire
设置为0,表示永不过期, 支持异步方法(返回类型为CompletableFuture
)。
属性 | 默认值 | 说明 |
---|---|---|
key | 未定义 | 缓存的key,支持参数动态组合,比如"key_#{id}" |
hash | DEFAULT_HASH |
缓存的hash, 不能含有':'、'#'、'@'字符 |
localExpire | -1 | 本地缓存过期时长, 0表示永不过期, -1表示不作本地缓存。 参数值支持方式: 100: 设置数值 ${env.cache.expires}: 读取系统配置项 |
remoteExpire | -1 | 远程缓存过期时长, 0表示永不过期, -1表示不作远程缓存。 参数值支持方式: 100: 设置数值 ${env.cache.expires}: 读取系统配置项 |
nullable | false | 是否可以缓存null值 |
timeUnit | TimeUnit.SECONDS |
时间单位TimeUnit |
comment | 未定义 | 备注描述 |
mode | LoadMode.ANY |
作用于Service模式,默认值为:ANY,作用于所有模式Service, LOCAL: 表示远程模式的Service对象中的缓存功能不起作用 |
将结果进行本地缓存30秒且远程缓存60秒
@Cached(key = "name", localExpire = "30", remoteExpire = "60")
public String getName() {
return "haha";
}
以参数code为key将结果进行本地缓存(时长由环境变量env.cache.expire
配置,没配置采用默认值30秒)
@Cached(key = "#{code}", localExpire = "${env.cache.expire:30}")
public CompletableFuture<String> getNameAsync(String code) {
return redis.getStringAsync(code);
}
以参数code+map.id为key将结果进行远程缓存60毫秒
@Resource
private CacheManager cacheManager;
//实时修改远程缓存的key值
public void updateName(String code, Map<String, Long> map) {
cacheManager.remoteSetString(code, code + "_" + map.get("id"), Duration.ofMillis(60));
}
@Cached(key = "#{code}_#{map.id}", remoteExpire = "60", timeUnit = TimeUnit.MILLISECONDS)
public String getName(String code, Map<String, Long> map) {
return code + "-" + map;
}
<!--
全局Serivce的缓存设置,没配置该节点将自动创建一个。
enabled: 是否开启缓存功能。默认: true
source: 远程CacheSource的资源名
-->
<cache enabled="true" source="xxx"/>