6.1 默认缓存管理

Spring Boot继承了Spring框架的缓存管理功能,通过使用@EnableCaching注解开启基于注解的缓存支 持,Spring Boot就可以启动缓存管理的自动化配置。

6.1.1 搭建测试环境

主要是搭建一个springboot的web服务,使用jpa连接Mysql数据库,编写查询接口。

  1. @Service
  2. public class CommentService {
  3. @Autowired private CommentRepository commentRepository;
  4. public Comment findCommentById(Integer id){
  5. Optional<Comment> comment = commentRepository.findById(id); if(comment.isPresent()){
  6. Comment comment1 = comment.get();
  7. return comment1;
  8. }
  9. return null;
  10. }
  11. }

多次查询发现每次都会向数据库查询一次,也就是结果并没有缓存。

6.1.2 默认缓存实现

  1. 在项目启动类添加注解@EnableCaching

    1. @EnableCaching // 开启Spring Boot基于注解的缓存管理支持 @SpringBootApplication
    2. @SpringBootApplication
    3. public class Springboot04CacheApplication {
    4. public static void main(String[] args) { SpringApplication.run(Springboot04CacheApplication.class, args);
    5. }
    6. }
  2. 使用@Cacheable对操作方法进行缓存管理,标记在service类上,对查询结果进行缓存。该注解的作用是将查询结果Comment存放在Spring Boot默认缓存中名称为comment 的名称空间(namespace)中,对应缓存唯一标识。(即缓存数据对应的主键k)默认为方法参数comment_id的值,如果没有参数或多个参数,他会使用springboot的默认值。

    1. @Service
    2. public class CommentService {
    3. @Autowired private CommentRepository commentRepository;
    4. @Cacheable(cacheNames = "comment")
    5. public Comment findCommentById(Integer id){
    6. Optional<Comment> comment = commentRepository.findById(id); if(comment.isPresent()){
    7. Comment comment1 = comment.get();
    8. return comment1;
    9. }
    10. return null;
    11. }
    12. }
  • cacheNames=“comment”,comment是该空间的唯一标识,通过该标识找到cache,cache中维护了多个(K,V)值。
  • 底层结构:在诸多的缓存自动配置类中, SpringBoot默认装配的是 SimpleCacheConfiguration , 他使用的 CacheManager 是 ConcurrentMapCacheManager, 使用 ConcurrentHashMap 当底层的数据结构,按照Cache的名字查询出Cache, 每一个Cache中存在多个k-v键值对,缓存值。
  1. 缓存注解介绍

刚刚通过使用@EnableCaching@Cacheable注解实现了Spring Boot默认的基于注解的缓存管
,除此之外,还有更多的缓存注解及注解属性可以配置优化缓存管理

  • @EnableCaching注解

@EnableCaching是由spring框架提供的,springboot框架对该注解进行了继承,该注解需要配置在类 上(通常配置在项目启动类上),用于开启基于注解的缓存支持

  • @Cacheable注解
    • @Cacheable注解也是由spring框架提供的,可以作用于类或方法(通常用在数据查询方法上),用于 对方法结果进行缓存存储。注解的执行顺序是,先进行缓存查询,如果为空则进行方法查询,并将结果 进行缓存;如果缓存中有数据,不进行方法查询,而是直接使用缓存数据
    • @Cacheable注解提供了多个属性,用于对缓存存储进行相关配置 | 属性名 | 说明 | | —- | —- | | value/cacheNames | 指定缓存空间的名称,必配属性。这两个属性二选一使用 | | key | 指定缓存数据的key,默认使用方法参数值,可以使用SpEL表达式 | | keyGenerator | 指定缓存数据的key的生成器,与key属性二选一使用 | | cacheManager | 指定缓存管理器 | | cacheResolver | 指定缓存解析器,与cacheManager属性二选一使用 | | condition | 指定在符合某条件下,进行数据缓存 | | unless | 指定在符合某条件下,不进行数据缓存 | | sync | 指定是否使用异步缓存。默认false |

执行流程、时机

  • 方法运行之前,先去查询Cache(缓存组件),按照cacheNames指定的名字获取,(CacheManager 先获取相应的缓存),第一次获取缓存如果没有Cache组件会自动创建。
  • 去Cache中查找缓存的内容,使用一个key,默认就是方法的参数,如果多个参数或者没有参数,是按 照某种策略生成的,默认是使用KeyGenerator生成的,使用SimpleKeyGenerator生成key

SimpleKeyGenerator生成key的默认策略

参数个数 key
没有参数 new SimpleKey()
有一个参数 参数值
多个参数 new SimpleKey(params)

常见的SPEL表达式

描述 示例
当前被调用的方法名 #root.mathodName
当前被调用的方法 #root.mathod
当前被调用的目标对象 #root.target
当前被调用的目标对象类 #root.targetClass
当前被调用的方法的参数列表 #root.args[0] 第一个参数, #root.args[1] 第二个参数…
根据参数名字取出值 #参数名, 也可以使用 #p0 #a0 0是参数的下标索引
当前方法的返回值 #result
  • @CachePut注解

目标方法执行完之后生效, @CachePut被使用于修改操作比较多,哪怕缓存中已经存在目标值了,但是这个 注解保证这个方法依然会执行,执行之后的结果被保存在缓存中。
@CachePut注解也提供了多个属性,这些属性与@Cacheable注解的属性完全相同。
更新操作,前端会把id+实体传递到后端使用,我们就直接指定方法的返回值从新存进缓存时的 key=”#id” , 如果前端只是给了实体,我们就使用 key=”#实体.id” 获取key. 同时,他的执行时机是目标 方法结束后执行, 所以也可以使用 key=”#result.id” , 拿出返回值的id。

  • @CacheEvict注解

@CacheEvict注解是由Spring框架提供的,可以作用于类或方法(通常用在数据删除方法上),该注解 的作用是删除缓存数据。@CacheEvict注解的默认执行顺序是,先进行方法调用,然后将缓存进行除。

6.2 整合Redis缓存实现

6.2.1 SpringBoot支持的缓存组件

在Spring Boot中,数据的缓存管理存储依赖于Spring框架中cache相关的
org.springframework.cache.Cacheorg.springframework.cache.CacheManager缓存管理器接口。如果程序中没有定义类型为CacheManager的Bean组件或者是名为cacheResolver的CacheResolver缓存解析器,Spring Boot将尝试选择并启用以下缓存组件(按照指定的顺序):

  1. Generic
  2. JCache (JSR-107) (EhCache 3、Hazelcast、Infifinispan等)
  3. EhCache 2.x
  4. Hazelcast
  5. Infifinispan
  6. Couchbase
  7. Redis
  8. Caffffeine
  9. Simple

以上是根据Spring Boot缓存组件的加载顺序来列举的:

  • 如果项目中没有添加任何缓存组件,则使用第9的默认组件,也就是6.1提到的SimpleCacheConfiguration,它默认使用内存中的ConcurrentMap进行缓存存储。这种方式并不推荐。
  • 如果项目中有多个组件,则按照加载顺序来选择组件,加载先的优先级高 。但是也可以自己指定,比如使用@Cacheable注解时使用cacheManager属性指定缓存管理器。

    6.2.2 基于注解的Redis缓存实现

  1. 引入redis依赖

    1. <dependency>
    2. <groupId>org.springframework.boot</groupId>
    3. <artifactId>spring-boot-starter-data-redis</artifactId>
    4. </dependency>

    当我们添加进redis相关的启动器之后, SpringBoot会使用 RedisCacheConfiguration当做生效的自动
    配置类进行缓存相关的自动装配,容器中使用的缓存管理器是 RedisCacheManager , 这个缓存管理器创建的Cache为 RedisCache , 进而操控redis进行数据的缓存。

  2. 配置文件

    1. # Redis服务地址
    2. spring.redis.host=127.0.0.1
    3. # Redis服务器连接端口
    4. spring.redis.port=6379
    5. # Redis服务器连接密码(默认为空)
    6. spring.redis.password=
  3. 对CommentService类中的方法进行修改使用@Cacheable、@CachePut、@CacheEvict三个注 解定制缓存管理,分别进行缓存存储、缓存更新和缓存删除的演示 ```java @Service public class CommentService { // unless = “#result==null””表示查询结果为空不进行缓存 // @Cacheable注解中没有标记key值,将会使用默认参数值comment_id作为key进行 // 数据保存 @Cacheable(cacheNames = “comment”,unless = “#result==null”) public Comment findCommentById(Integer id){

    1. Optional<Comment> comment = commentRepository.findById(id); if(comment.isPresent()){
    2. Comment comment1 = comment.get();
    3. return comment1;
    4. }
    5. return null;

    }

    @CachePut(cacheNames = “comment”,key = “#result.id”) public Comment updateComment(Comment comment) { commentRepository.updateComment(comment.getAuthor(), comment.getaId());

    1. return comment;

    }

    @CacheEvict(cacheNames = “comment”) public void deleteComment(int comment_id) { commentRepository.deleteById(comment_id); }

}

  1. 4. 缓存保存的数据(对象类)需要进行序列化操作。java实现序列化可以实现Serializable接口来实现。
  2. 5. 进行调用测试。
  3. 6. 对缓存配置过期时间,此方法不够灵活,对所有缓存生效。
  4. ```properties
  5. # 对基于注解的Redis缓存数据统一设置有效期为1分钟,单位毫秒
  6. spring.cache.redis.time-to-live=60000

6.2.3 基于API的Redis缓存实现

基于API的Redis缓存实现,需要在某种业务需求下通过 Redis提供的API调用相关方法实现数据缓存管理;同时,这种方法还可以手动管理缓存的有效期。

  1. 6.2.2已经实现了redis缓存的引入,以下主要是使用API的方式实现缓存。

    1. @Service
    2. public class ApiCommentService {
    3. @Autowired private
    4. CommentRepository commentRepository;
    5. @Autowired private
    6. RedisTemplate redisTemplate;
    7. public Comment findCommentById(Integer id){
    8. Object o = redisTemplate.opsForValue().get("comment_" + id);
    9. if(o!=null) {
    10. return (Comment) o;
    11. } else {
    12. //缓存中没有,从数据库查询
    13. Optional<Comment> byId = commentRepository.findById(id);
    14. if(byId.isPresent()){
    15. Comment comment = byId.get();
    16. //将查询结果存入到缓存中,并设置有效期为1天
    17. redisTemplate.opsForValue().set("comment_"+id,comment,1,TimeUnit.DAYS);
    18. return comment;
    19. } else {
    20. return null;
    21. }
    22. }
    23. }
    24. public Comment updateComment(Comment comment) {
    25. commentRepository.updateComment(comment.getAuthor(), comment.getaId());
    26. //更新数据后进行缓存更新
    27. redisTemplate.opsForValue().set("comment_"+comment.getId(),comment);
    28. return comment;
    29. }
    30. public void deleteComment(int comment_id) {
    31. commentRepository.deleteById(comment_id); redisTemplate.delete("comment_"+comment_id);
    32. }
    33. }

6.2.4 自定义Redis缓存序列化机制

基于API的Redis缓存实现是使用RedisTemplate模板进行数据缓存操作的,这里打开
RedisTemplate类,查看该类的关键源码信息:

  1. public class RedisTemplate<K, V> extends RedisAccessor implements RedisOperations<K, V>, BeanClassLoaderAware {
  2. // 声明了key、value的各种序列化方式,初始值为空
  3. @Nullable
  4. private RedisSerializer keySerializer = null;
  5. @Nullable
  6. private RedisSerializer valueSerializer = null;
  7. @Nullable
  8. private RedisSerializer hashKeySerializer = null;
  9. @Nullable
  10. private RedisSerializer hashValueSerializer = null;
  11. public void afterPropertiesSet() {
  12. super.afterPropertiesSet();
  13. // 进行默认序列化方式设置,设置为JDK序列化方式
  14. if (this.defaultSerializer == null) {
  15. this.defaultSerializer = new JdkSerializationRedisSerializer(this.classLoader != null ? this.classLoader : this.getClass().getClassLoader());
  16. ......
  17. ......
  18. }
  19. }
  20. }

源码解析
从上述RedisTemplate核心源码可以看出,在RedisTemplate内部声明了缓存数据key、value的各
种序列化方式,且初始值都为空;在afterPropertiesSet()方法中,判断如果默认序列化参数
defaultSerializer为空,将数据的默认序列化方式设置为JdkSerializationRedisSerializer 。
根据源码信息,可以得出以下重要结论:

  1. 使用RedisTemplate进行Redis数据缓存操作时,内部默认使用的是 JdkSerializationRedisSerializer序列化方式,所以进行数据缓存的实体类必须实现JDK自带的序列化接口(例如Serializable)。
  2. 使用RedisTemplate进行Redis数据缓存操作时,如果自定义了缓存序列化方式 defaultSerializer,那么将使用自定义的序列化方式。
  3. 缓存数据key、value的各种序列化类型都是 RedisSerializer。进入RedisSerializer源码查看RedisSerializer支持的序列化方式(查看RedisSerializer接口的实现类)

自定义RedisTemplate序列化机制
在项目中引入Redis依赖后,Spring Boot提供的RedisAutoConfifiguration自动配置会生效。打开
RedisAutoConfifiguration类,查看内部源码中关于RedisTemplate的定义方式:

  1. public class RedisAutoConfiguration {
  2. @Bean
  3. @ConditionalOnMissingBean(
  4. name = {"redisTemplate"}
  5. )
  6. @ConditionalOnSingleCandidate(RedisConnectionFactory.class)
  7. public RedisTemplate<Object, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) {
  8. RedisTemplate<Object, Object> template = new RedisTemplate();
  9. template.setConnectionFactory(redisConnectionFactory);
  10. return template;
  11. }
  12. }

根据源码可以看出, @ConditionalOnMissingBean注解表示如果当前不存在redisTemplate类的时候就会自动实例化这个类并放入容器,所以我们可以自定义一个RedisTemplate放入容器,自动配置中的类就不会生效了。参考自动配置的自定义配置如下:

  1. @Configuration
  2. public class RedisConfig {
  3. @Bean
  4. public RedisTemplate<Object, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) {
  5. RedisTemplate<Object, Object> template = new RedisTemplate();
  6. template.setConnectionFactory(redisConnectionFactory);
  7. // 使用JSON格式序列化对象,对缓存数据key和value进行转换
  8. Jackson2JsonRedisSerializer jacksonSeial = new Jackson2JsonRedisSerializer(Object.class);
  9. // 解决查询缓存转换异常的问题
  10. ObjectMapper om = new ObjectMapper();
  11. om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY); om.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL); jacksonSeial.setObjectMapper(om);
  12. // 设置RedisTemplate模板API的序列化方式为JSON
  13. template.setDefaultSerializer(jacksonSeial);
  14. return template;
  15. }
  16. }

通过@Confifiguration注解定义了一个RedisConfifig配置类,并使用@Bean注解注入了一个默认名
称为方法名的redisTemplate组件(注意,该Bean组件名称必须是redisTemplate)。在定义的Bean组
件中,自定义了一个RedisTemplate,使用自定义的Jackson2JsonRedisSerializer数据序列化方式;在
定制序列化方式中,定义了一个ObjectMapper用于进行数据转换设置

自定义RedisCacheManager
刚刚针对基于 API方式的RedisTemplate进行了自定义序列化方式的改进,从而实现了JSON序列化
方式缓存数据,但是这种自定义的RedisTemplate对于基于注解的Redis缓存来说,是没有作用的。
针对注解的Redis缓存机制和自定义序列化机制如下:
Redis注解默认序列化机制
打开Spring Boot整合Redis组件提供的缓存自动配置类 RedisCacheConfifiguration(org.springframework.boot.autoconfifigure.cache包下的),该配置类中的RedisCacheManager的定义,选择了JDK序列化方式,我们自定义一个RedisCacheManager进行覆盖:

  1. @Bean public RedisCacheManager cacheManager(RedisConnectionFactory redisConnectionFactory) {
  2. // 分别创建String和JSON格式序列化对象,对缓存数据key和value进行转换
  3. RedisSerializer<String> strSerializer = new StringRedisSerializer();
  4. Jackson2JsonRedisSerializer jacksonSeial = new Jackson2JsonRedisSerializer(Object.class);
  5. // 解决查询缓存转换异常的问题
  6. ObjectMapper om = new ObjectMapper(); om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
  7. om.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL);
  8. jacksonSeial.setObjectMapper(om);
  9. // 定制缓存数据序列化方式及时效
  10. RedisCacheConfiguration config = RedisCacheConfiguration.defaultCacheConfig()
  11. .entryTtl(Duration.ofDays(1))
  12. .serializeKeysWith(RedisSerializationContext.SerializationPair
  13. .fromSerializer(strSerializer))
  14. .serializeValuesWith(RedisSerializationContext.SerializationPair
  15. .fromSerializer(jacksonSeial)) .disableCachingNullValues();
  16. RedisCacheManager cacheManager = RedisCacheManager
  17. .builder(redisConnectionFactory).cacheDefaults(config).build();
  18. return cacheManager;
  19. }

上述代码中,在RedisConfifig配置类中使用@Bean注解注入了一个默认名称为方法名的cacheManager组件。在定义的Bean组件中,通过RedisCacheConfifiguration对缓存数据的key和value
分别进行了序列化方式的定制,其中缓存数据的key定制为StringRedisSerializer(即String格式),而 value定制为了Jackson2JsonRedisSerializer(即JSON格式),同时还使用entryTtl(Duration.ofDays(1))方法将缓存数据有效期设置为1天