spring cache相关注解介绍 @Cacheable、@CachePut、@CacheEvict

最新推荐文章于 2024-05-02 23:41:38 发布

bruce.yao

最新推荐文章于 2024-05-02 23:41:38 发布

阅读量828

点赞数

文章标签： cache Cacheable CachePut CacheEvict

原文链接：https://www.jianshu.com/p/49fc4065201a

版权

https://www.jianshu.com/p/49fc4065201a

https://blog.csdn.net/poorCoder_/article/details/55258253

https://www.cnblogs.com/fashflying/p/6908028.html

spring cache的使用

缓存某些方法的执行结果

设置好缓存配置之后我们就可以使用 @Cacheable 注解来缓存方法执行的结果了
spring cache的使用是非常简单的,只需要在方法上标注 @Cacheable 注解就可以

@Cacheable("getName")  
public String getName(String id) {  
    return xxx;  
}  
  
@Cacheable("getUser")  
public User searchCity(String userId){  
    return this.query(userId);     
}

整个@Cacheable的流程是:先从缓存中读取，如果没有再调用方法获取数据，然后把数据添加到缓存中.

缓存数据一致性保证

在我们配置了查询用户名的方法缓存之后,假如这时候我们改名了,我想让我自己查询的时候能看到我自己的改变。这时候我们该怎么做呢？

@CacheEvict移除缓存

我们这时候可以在修改方法上加上@CacheEvict注解,来更新查询方法的结果缓存

@CacheEvict(value = "getName", key = "#user.id") //移除指定key的数据  
public User updateUser(User user) {  
    users.update(user);  
    return user;  
}

这时候再调用新的查询接口,我们就不会走缓存里的方法,会重新去数据库中查询.
因为调用修改用户的方法的时候, @CacheEvict会根据相应的key和value作为条件从缓存中移除相应的数据.

@CachePut 既要保证方法被调用，又希望结果被缓存

据前面的例子，我们知道，如果使用了 @Cacheable 注释，则当重复使用相同参数调用方法的时候，方法本身不会被调用执行，即方法本身被略过了，取而代之的是方法的结果直接从缓存中找到并返回了.

现实中并不总是如此，有些情况下我们希望方法一定会被调用，因为其除了返回一个结果，还做了其他事情，例如记录日志，调用接口等，这个时候，我们可以用 @CachePut 注释，这个注释可以确保方法被执行，同时方法的返回值也被记录到缓存中.

@Cacheable(value="userCache")
 public User getUserById(String id) { 
   // 方法内部实现不考虑缓存逻辑，直接实现业务
   return getUserFromDB(id); 
 } 

 // 更新 userCache 缓存
 @CachePut(value="userCache",key="#user.id")
 public User updateUser(User user) { 
   return updateUserToDB(user); 
 } 
 
 private User updateUserToDB(User user) { 
   // do some query
   return user; 
 }

如上面的代码所示，我们首先用 getUserById 方法查询一个人的信息，这个时候会查询数据库一次，但是也记录到缓存中了。然后我们修改了用户信息，调用了 updateUser 方法，这个时候会执行数据库的更新操作且记录到缓存，我们再次修改信息并调用 updateUser 方法，然后通过 getUserById 方法查询，这个时候，由于缓存中已经有数据，所以不会查询数据库，而是直接返回最新的数据

三种方式的对比

@Cacheable、@CachePut、@CacheEvict 注释介绍

@Cacheable 主要针对方法配置，能够根据方法的请求参数对其结果进行缓存
@CachePut 主要针对方法配置，能够根据方法的请求参数对其结果进行缓存，和 @Cacheable 不同的是，它每次都会触发真实方法的调用
@CachEvict 主要针对方法配置，能够根据一定的条件对缓存进行清空

基本原理

一句话介绍就是Spring AOP的动态代理技术。如果读者对Spring AOP不熟悉的话，可以去看看官方文档

注意和限制

基于 proxy 的 spring aop 带来的内部调用问题

上面介绍过 spring cache 的原理，即它是基于动态生成的 proxy 代理机制来对方法的调用进行切面，这里关键点是对象的引用问题.

如果对象的方法是内部调用（即 this 引用）而不是外部引用，则会导致 proxy 失效，那么我们的切面就失效，也就是说上面定义的各种注释包括 @Cacheable、@CachePut 和 @CacheEvict 都会失效，我们来演示一下。

public Account getAccountByName2(String accountName) { 
   return this.getAccountByName(accountName); 
 } 

 @Cacheable(value="accountCache")// 使用了一个缓存名叫 accountCache 
 public Account getAccountByName(String accountName) { 
   // 方法内部实现不考虑缓存逻辑，直接实现业务
   return getFromDB(accountName); 
 }

上面我们定义了一个新的方法 getAccountByName2，其自身调用了 getAccountByName 方法，这个时候，发生的是内部调用（this），所以没有走 proxy，导致 spring cache 失效

要避免这个问题，就是要避免对缓存方法的内部调用，或者避免使用基于 proxy 的 AOP 模式，可以使用基于 aspectJ 的 AOP 模式来解决这个问题。

@CacheEvict 的可靠性问题

我们看到,@CacheEvict 注释有一个属性 beforeInvocation,缺省为 false,即缺省情况下，都是在实际的方法执行完成后，才对缓存进行清空操作。期间如果执行方法出现异常，则会导致缓存清空不被执行。我们演示一下

// 清空 accountCache 缓存
 @CacheEvict(value="accountCache",allEntries=true)
 public void reload() { 
   throw new RuntimeException(); 
 }

我们的测试代码如下：

accountService.getAccountByName("someone"); 
   accountService.getAccountByName("someone"); 
   try { 
     accountService.reload(); 
   } catch (Exception e) { 
    //...
   } 
   accountService.getAccountByName("someone");

注意上面的代码，我们在 reload 的时候抛出了运行期异常，这会导致清空缓存失败。上面的测试代码先查询了两次，然后 reload，然后再查询一次，结果应该是只有第一次查询走了数据库，其他两次查询都从缓存，第三次也走缓存因为 reload 失败了。

那么我们如何避免这个问题呢？我们可以用 @CacheEvict 注释提供的 beforeInvocation 属性，将其设置为 true，这样，在方法执行前我们的缓存就被清空了。可以确保缓存被清空。

非 public 方法问题

和内部调用问题类似，非 public 方法如果想实现基于注释的缓存，必须采用基于 AspectJ 的 AOP 机制

Dummy CacheManager 的配置和作用

有的时候，我们在代码迁移、调试或者部署的时候，恰好没有 cache 容器，比如 memcache 还不具备条件，h2db 还没有装好等，如果这个时候你想调试代码，岂不是要疯掉？这里有一个办法，在不具备缓存条件的时候，在不改代码的情况下，禁用缓存。

方法就是修改 spring的配置文件，设置一个找不到缓存就不做任何操作的标志位

<cache:annotation-driven /> 
 
   <bean id="simpleCacheManager" class="org.springframework.cache.support.SimpleCacheManager"> 
     <property name="caches"> 
       <set> 
         <bean 
           class="org.springframework.cache.concurrent.ConcurrentMapCacheFactoryBean"
           p:name="default" /> 
       </set> 
     </property> 
   </bean> 

   <bean id="cacheManager" class="org.springframework.cache.support.CompositeCacheManager">
     <property name="cacheManagers"> 
       <list> 
         <ref bean="simpleCacheManager" /> 
       </list> 
     </property> 
     <property name="fallbackToNoOpCache" value="true" /> 
   </bean>

注意以前的 cacheManager 变为了 simpleCacheManager，且没有配置 accountCache 实例，后面的 cacheManager 的实例是一个 CompositeCacheManager，他利用了前面的 simpleCacheManager 进行查询，如果查询不到，则根据标志位 fallbackToNoOpCache 来判断是否不做任何缓存操作。

使用 guava cache

<bean id="cacheManager" class="org.springframework.cache.guava.GuavaCacheManager">
    <property name="cacheSpecification" value="concurrencyLevel=4,expireAfterAccess=100s,expireAfterWrite=100s" />
    <property name="cacheNames">
        <list>
            <value>dictTableCache</value>
        </list>
    </property>
</bean>

代码地址

https://github.com/rollenholt/spring-cache-example

参考链接

csdn的技术文:Redis 缓存 + Spring 的集成示例
Ibm的技术文:注释驱动的 Spring cache 缓存介绍
开涛大神的技术博客:Spring Cache抽象详解

@Cacheable
@Cacheable是用来声明方法是可缓存的。将结果存储到缓存中以便后续使用相同参数调用时不需执行实际的方法。直接从缓存中取值。最简单的格式需要制定缓存名称。
例如：

@Cacheable("books")
public Book findBook(ISBN isbn) {...}

在上面的代码片段中，findBook方法与名为books的缓存想关联。每次调用该方法时，将在缓存中检查该请求是否已执行，以免重复执行。虽然在大多数情况下，只有一个缓存被声明，注释允许指定多个名称，以便使用多个缓存。这种情况下，在执行方法之前，每个缓存都会检查之前执行的方法，只要有一个缓存命中，即直接从缓存中返回相关的值。
即使没有实际执行缓存方法，所有其他不包含该值的缓存也将被更新。
例如：

@Cacheable({"books", "isbns"})
public Book findBook(ISBN isbn) {...}

默认key生成：
默认key的生成按照以下规则：
- 如果没有参数,则使用0作为key
- 如果只有一个参数，使用该参数作为key
- 如果又多个参数，使用包含所有参数的hashCode作为key

自定义key的生成：
当目标方法参数有多个时，有些参数并不适合缓存逻辑
比如：

@Cacheable("books")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)

其中checkWarehouse，includeUsed并不适合当做缓存的key.针对这种情况，Cacheable 允许指定生成key的关键属性，并且支持支持SpringEL表达式。（推荐方法）
再看一些例子：

@Cacheable(cacheNames="books", key="#isbn")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)

@Cacheable(cacheNames="books", key="#isbn.rawNumber")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)

@Cacheable(cacheNames="books", key="T(someType).hash(#isbn)")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)

@Cacheable(cacheNames="books", key="#map['bookid'].toString()")
public Book findBook(Map<String, Object> map)

缓存的同步 sync：
在多线程环境下，某些操作可能使用相同参数同步调用。默认情况下，缓存不锁定任何资源，可能导致多次计算，而违反了缓存的目的。对于这些特定的情况，属性 sync 可以指示底层将缓存锁住，使只有一个线程可以进入计算，而其他线程堵塞，直到返回结果更新到缓存中。
例：

@Cacheable(cacheNames="foos", sync="true")
public Foo executeExpensiveOperation(String id) {...}

属性condition：
有时候，一个方法可能不适合一直缓存（例如：可能依赖于给定的参数）。属性condition支持这种功能，通过SpEL 表达式来指定可求值的boolean值，为true才会缓存（在方法执行之前进行评估）。
例：

@Cacheable(cacheNames="book", condition="#name.length < 32")
public Book findBook(String name)

此外，还有一个unless 属性可以用来是决定是否添加到缓存。与condition不同的是，unless表达式是在方法调用之后进行评估的。如果返回false，才放入缓存（与condition相反）。 #result指返回值例：

@Cacheable(cacheNames="book", condition="#name.length < 32", unless="#result.name.length > 5"")
public Book findBook(String name)

@CachePut
如果缓存需要更新，且不干扰方法的执行,可以使用注解@CachePut。@CachePut标注的方法在执行前不会去检查缓存中是否存在之前执行过的结果，而是每次都会执行该方法，并将执行结果以键值对的形式存入指定的缓存中。

@CachePut(cacheNames="book", key="#isbn")
public Book updateBook(ISBN isbn, BookDescriptor descriptor)

注意：应该避免@CachePut 和 @Cacheable同时使用的情况。

@CacheEvict annotation
spring cache不仅支持将数据缓存，还支持将缓存数据删除。此过程经常用于从缓存中清除过期或未使用的数据。
@CacheEvict要求指定一个或多个缓存，使之都受影响。此外，还提供了一个额外的参数allEntries 。表示是否需要清除缓存中的所有元素。默认为false，表示不需要。当指定了allEntries为true时，Spring Cache将忽略指定的key。有的时候我们需要Cache一下清除所有的元素。

@CacheEvict(cacheNames="books", allEntries=true)
public void loadBooks(InputStream batch)

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

@CacheEvict(cacheNames="books", beforeInvocation=true)
public void loadBooks(InputStream batch)

@CacheConfig
有时候一个类中可能会有多个缓存操作，而这些缓存操作可能是重复的。这个时候可以使用@CacheConfig

@CacheConfig("books")
public class BookRepositoryImpl implements BookRepository {

@Cacheable
public Book findBook(ISBN isbn) {...}
}

@CacheConfig是一个类级别的注解，允许共享缓存的名称、KeyGenerator、CacheManager 和CacheResolver。
该操作会被覆盖。

开启缓存注解
java类配置：

@Configuration
@EnableCaching
public class AppConfig {
}

XML 配置：

<cache:annotation-driven />

</beans>
————————————————
版权声明：本文为CSDN博主「poorCoder_」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/poorCoder_/article/details/55258253

bruce.yao

关注

0
点赞
踩
3

收藏

觉得还不错? 一键收藏
0
评论
spring cache相关注解介绍 @Cacheable、@CachePut、@CacheEvict

https://www.jianshu.com/p/49fc4065201ahttps://blog.csdn.net/poorCoder_/article/details/55258253https://www.cnblogs.com/fashflying/p/6908028.htmlspring cache的使用缓存某些方法的执行结果设置好缓存配置之后我们就可以使用 @Cacheable 注解来缓存方法执行的结果了spring cache的使用是非常简单的,只需要在方法上标注 @C
复制链接

扫一扫