Подробная Spring Cache аннотация @ Cacheable, @ CachePut, @CacheEvict использование

https://blog.csdn.net/u012240455/article/details/80844361

Примечания Введение

@Cacheable

Основной эффект для @Cacheable метода конфигурации, возможности кэширования результатов запроса его в соответствии с параметрами методы

@Cacheable роль и настроить

 

параметры объяснение пример
стоимость Имена кэша, определенные в файле конфигурации пружины, необходимо указать по крайней мере один 例如:
@Cacheable (значение =»MyCache»)
@Cacheable (значение = {»кэш1” ,» cache2” }
ключ ключ кэша, может быть пустым, если вы хотите указать SPEL подготовлена ​​в соответствии с выражением, если не указано, по умолчанию параметры объединены в соответствии со всеми методами @Cacheable (значение =»testcache», ключ =»# Username»)
условие Условия буфера, может быть пустыми, SPEL запись, возвращает истину или ложь, это справедливо только для кэширования @Cacheable (значение =»testcache», условие =»# userName.length ()> 2” )

 

примеров

@Cacheable (значение = «accountCache»), это замечание означает, что при вызове этого метода, запросов из кэша с именем accountCache, если нет, то фактический метод выполняется (т.е. запроса к базе данных), и внедрение результатов, хранящихся в кэше, в противном случае объект кэша. Вот основные параметры кэша имя_пользователь, значение объект Account. «AccountCache» это имя кэша весной * .xml определены.

?
1
2
3
4
5
6
@Cacheable (value= "accountCache" ) // 使用了一个缓存名叫 accountCache
public Account getAccountByName(String userName) {
    // 方法内部实现不考虑缓存逻辑,直接实现业务
    System.out.println( "real query account." +userName);
    return getFromDB(userName);
}

@CachePut

Основная роль методы @CachePut для конфигурации, его результаты может быть кэшируются в методе параметров запроса и @Cacheable отличается тем, что он будет инициировать вызов к каждой истинной методе

@CachePut роли и настроить

 

параметры объяснение пример
стоимость Имена кэша, определенные в файле конфигурации пружины, необходимо указать по крайней мере один @CachePut (значение =»мой кэш»)
ключ ключ кэша, может быть пустым, если вы хотите указать SPEL подготовлена ​​в соответствии с выражением, если не указано, по умолчанию параметры объединены в соответствии со всеми методами @CachePut (значение =»testcache», ключ =»# Username»)
условие Условия буфера, может быть пустыми, SPEL запись, возвращает истину или ложь, это справедливо только для кэширования @CachePut (значение =»testcache», условие =»# userName.length ()> 2” )

 

примеров

@CachePut комментариев, комментарии могут обеспечить метод выполняются, и возвращаемое значение методы также записываются в кэш, кэш обновляются и синхронизируются базы данных.

?
1
2
3
4
@CachePut (value= "accountCache" ,key= "#account.getName()" ) // 更新accountCache 缓存
public Account updateAccount(Account account) {
   return updateDB(account);
}

@CacheEvict

Основной эффект для метода конфигурации @CachEvict, способен очистить кэш в соответствии с определенными условиями

@CacheEvict роль и настроить

 

параметры объяснение пример
стоимость Имена кэша, определенные в файле конфигурации пружины, необходимо указать по крайней мере один @CacheEvict (значение =»мой кэш»)
ключ ключ кэша, может быть пустым, если вы хотите указать SPEL подготовлена ​​в соответствии с выражением, если не указано, по умолчанию параметры объединены в соответствии со всеми методами @CacheEvict (значение =»testcache», ключ =»# Username»)
условие Условия буфера, может быть пустыми, SPEL запись, возвращает истину или ложь, это справедливо только для кэширования @CacheEvict (значение =»testcache», условие =»# userName.length ()> 2” )
allEntries Независимо от того, чтобы очистить все содержимое кэша по умолчанию является ложным, если вы зададите верно, то вызов метода будет немедленно очистить все кэш @CachEvict(value=”testcache”,allEntries=true)
beforeInvocation 是否在方法执行前就清空,缺省为 false,如果指定为 true,则在方法还没有执行的时候就清空缓存,缺省情况下,如果方法执行抛出异常,则不会清空缓存 @CachEvict(value=”testcache”,beforeInvocation=true)

 

实例

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@CacheEvict (value= "accountCache" ,key= "#account.getName()" ) // 清空accountCache 缓存
public void updateAccount(Account account) {
    updateDB(account);
}
 
@CacheEvict (value= "accountCache" ,allEntries= true ) // 清空accountCache 缓存
public void reload() {
    reloadAll()
}
 
@Cacheable (value= "accountCache" ,condition= "#userName.length() <=4" ) // 缓存名叫 accountCache
public Account getAccountByName(String userName) {
  // 方法内部实现不考虑缓存逻辑,直接实现业务
  return getFromDB(userName);
}

@CacheConfig

所有的@Cacheable()里面都有一个value=“xxx”的属性,这显然如果方法多了,写起来也是挺累的,如果可以一次性声明完 那就省事了, 所以,有了@CacheConfig这个配置,@CacheConfig is a class-level annotation that allows to share the cache names,如果你在你的方法写别的名字,那么依然以方法的名字为准。

?
1
2
3
4
5
6
@CacheConfig ( "books" )
public class BookRepositoryImpl  implements BookRepository {
 
   @Cacheable
   public Book findBook(ISBN isbn) {...}
}

条件缓存

下面提供一些常用的条件缓存

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
//@Cacheable将在执行方法之前( #result还拿不到返回值)判断condition,如果返回true,则查缓存;
@Cacheable (value =  "user" , key =  "#id" , condition =  "#id lt 10" )
public User conditionFindById( final Long id)
 
//@CachePut将在执行完方法后(#result就能拿到返回值了)判断condition,如果返回true,则放入缓存;
@CachePut (value =  "user" , key =  "#id" , condition =  "#result.username ne 'zhang'" )
public User conditionSave( final User user) 
 
//@CachePut将在执行完方法后(#result就能拿到返回值了)判断unless,如果返回false,则放入缓存;(即跟condition相反)
@CachePut (value =  "user" , key =  "#user.id" , unless =  "#result.username eq 'zhang'" )
public User conditionSave2( final User user) 
 
//@CacheEvict, beforeInvocation=false表示在方法执行之后调用(#result能拿到返回值了);且判断condition,如果返回true,则移除缓存;
@CacheEvict (value =  "user" , key =  "#user.id" , beforeInvocation =  false , condition =  "#result.username ne 'zhang'" )
public User conditionDelete( final User user) 

@Caching

有时候我们可能组合多个Cache注解使用;比如用户新增成功后,我们要添加id–>user;username—>user;email—>user的缓存;此时就需要@Caching组合多个注解标签了。

?
1
2
3
4
5
6
@Caching (put = {
@CachePut (value =  "user" , key =  "#user.id" ),
@CachePut (value =  "user" , key =  "#user.username" ),
@CachePut (value =  "user" , key =  "#user.email" )
})
public User save(User user) {

自定义缓存注解

比如之前的那个@Caching组合,会让方法上的注解显得整个代码比较乱,此时可以使用自定义注解把这些注解组合到一个注解中,如:

?
1
2
3
4
5
6
7
8
9
10
@Caching (put = {
@CachePut (value =  "user" , key =  "#user.id" ),
@CachePut (value =  "user" , key =  "#user.username" ),
@CachePut (value =  "user" , key =  "#user.email" )
})
@Target ({ElementType.METHOD, ElementType.TYPE})
@Retention (RetentionPolicy.RUNTIME)
@Inherited
public @interface UserSaveCache {
}

这样我们在方法上使用如下代码即可,整个代码显得比较干净。

?
1
2
@UserSaveCache
public User save(User user)

扩展

比如findByUsername时,不应该只放username–>user,应该连同id—>user和email—>user一起放入;这样下次如果按照id查找直接从缓存中就命中了

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
@Caching (
   cacheable = {
     @Cacheable (value =  "user" , key =  "#username" )
   },
   put = {
     @CachePut (value =  "user" , key =  "#result.id" , condition =  "#result != null" ),
     @CachePut (value =  "user" , key =  "#result.email" , condition =  "#result != null" )
   }
)
public User findByUsername( final String username) {
   System.out.println( "cache miss, invoke find by username, username:" + username);
   for (User user : users) {
     if (user.getUsername().equals(username)) {
       return user;
     }
   }
   return null ;
}

其实对于:id—>user;username—->user;email—>user;更好的方式可能是:id—>user;username—>id;email—>id;保证user只存一份;如:

?
1
2
3
4
5
6
@CachePut (value= "cacheName" , key= "#user.username" , cacheValue= "#user.username" )
public void save(User user) 
 
 
@Cacheable (value= "cacheName" , key= "#user.username" , cacheValue= "#caches[0].get(#caches[0].get(#username).get())" )
public User findByUsername(String username)

SpEL上下文数据

Spring Cache提供了一些供我们使用的SpEL上下文数据,下表直接摘自Spring官方文档:

 

名称 位置 描述 示例
methodName root对象 当前被调用的方法名 root.methodName
method root对象 当前被调用的方法 root.method.name
target root对象 当前被调用的目标对象 root.target
targetClass root对象 当前被调用的目标对象类 root.targetClass
args root对象 当前被调用的方法的参数列表 root.args[0]
caches root对象 当前方法调用使用的缓存列表(如@Cacheable(value={“cache1”, “cache2”})),则有两个cache root.caches[0].name
argument name 执行上下文 当前被调用的方法的参数,如findById(Long id),我们可以通过#id拿到参数 user.id
result 执行上下文 方法执行后的返回值(仅当方法执行之后的判断有效,如‘unless','cache evict'的beforeInvocation=false) result

 

?
1
2
@CacheEvict (value =  "user" , key =  "#user.id" , condition =  "#root.target.canCache() and #root.caches[0].get(#user.id).get().username ne #user.username" , beforeInvocation =  true )
public void conditionUpdate(User user)

 

 
 

рекомендация

отwww.cnblogs.com/qianjinyan/p/11697956.html