1、@EnableCaching、@Cacheable的介绍
首先说明这两个注解都是spring提供的,可以结合不同的缓存技术使用。(这里将顺便结合Redis进行讲解)
1.1 @EnableCaching
@EnableCaching是开启缓存功能,作用于缓存配置类上或者作用于springboot启动类上。
1.2 @Cacheable
@Cacheable 注解在方法上,表示该方法的返回结果是可以缓存的。也就是说,该方法的返回结果会放在缓存中,以便于以后使用相同的参数调用该方法时,会返回缓存中的值,而不会实际执行该方法。如果缓存过期,则重新执行。
注解常用的几个属性:
- cacheNames/value :用来指定缓存组件的名字
- key :缓存数据时使用的 key,可以用它来指定。默认是使用方法参数的值。(这个 key 你可以使用 spEL 表达式来编写)
- keyGenerator :key 的生成器。 key 和 keyGenerator 二选一使用
- cacheManager :可以用来指定缓存管理器。从哪个缓存管理器里面获取缓存。
- condition :可以用来指定符合条件的情况下才缓存
- unless :否定缓存。当 unless 指定的条件为 true ,方法的返回值就不会被缓存。当然你也可以获取到结果进行判断。(通过#result 获取方法结果)
- sync :是否使用异步模式。
2、Redis在SpringBoot中的使用教程
2.1 Redis的配置类
@EnableCaching //开启缓存功能,作用于缓存配置类上或者作用于springboot启动类上
@Configuration
public class RedisConfig {
/**
* 创建一个RedisTemplate实例,用于操作Redis数据库。
* 其中,redisTemplate是一个泛型为<String, Object>的模板对象,可以存储键值对数据;
* @param factory factory是一个Redis连接工厂对象,用于建立与Redis服务器的连接
* @return
*/
@Bean
public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
RedisTemplate<String, Object> template = new RedisTemplate<>();
//创建一个字符串序列化器对象,用于将字符串类型的数据转换成二进制格式存储到Redis中。
RedisSerializer<String> redisSerializer = new StringRedisSerializer();
//创建一个字符串序列化器对象,用于将字符串类型的数据转换成二进制格式存储到Redis中。
Jackson2JsonRedisSerializer jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer(Object.class);
//创建一个字符串序列化器对象,用于将字符串类型的数据转换成二进制格式存储到Redis中。
ObjectMapper om = new ObjectMapper();
//设置ObjectMapper对象的属性访问器可见性,使其能够访问所有的属性。
om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
//启用默认类型识别,避免在序列化过程中出现类型错误。
om.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL);
//将ObjectMapper对象设置为JSON序列化器的属性访问器。
jackson2JsonRedisSerializer.setObjectMapper(om);
//将ObjectMapper对象设置为JSON序列化器的属性访问器。
template.setConnectionFactory(factory);
//key序列化方式,将ObjectMapper对象设置为JSON序列化器的属性访问器。
template.setKeySerializer(redisSerializer);
//value序列化,将ObjectMapper对象设置为JSON序列化器的属性访问器。
template.setValueSerializer(jackson2JsonRedisSerializer);
//value hashmap序列化,将ObjectMapper对象设置为JSON序列化器的属性访问器。
template.setHashValueSerializer(jackson2JsonRedisSerializer);
return template;
}
/**
* 创建一个CacheManager实例,用于管理缓存。
* 其中,cacheManager是一个缓存管理器对象,用于管理缓存的生命周期和策略等;
* @param factory
* @return
*/
@Bean
public CacheManager cacheManager(RedisConnectionFactory factory) {
//第一个序列化器用于将字符串类型的数据转换为二进制格式,第二个序列化器用于将Java对象序列化为JSON格式。
RedisSerializer<String> redisSerializer = new StringRedisSerializer();
Jackson2JsonRedisSerializer jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer(Object.class);
//解决查询缓存转换异常的问题
ObjectMapper om = new ObjectMapper();
om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
om.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL);
jackson2JsonRedisSerializer.setObjectMapper(om);
// 配置序列化(解决乱码的问题),过期时间600秒
RedisCacheConfiguration config = RedisCacheConfiguration.defaultCacheConfig()
.entryTtl(Duration.ofSeconds(600))
.serializeKeysWith(RedisSerializationContext.SerializationPair.fromSerializer(redisSerializer))
.serializeValuesWith(RedisSerializationContext.SerializationPair.fromSerializer(jackson2JsonRedisSerializer))
//禁用缓存空值
.disableCachingNullValues();
RedisCacheManager cacheManager = RedisCacheManager.builder(factory)
.cacheDefaults(config)
.build();
return cacheManager;
}
}
2.2 测试实体类及Controller类
@Data
@AllArgsConstructor
@NoArgsConstructor
public class People {
private String name;
private int age;
}
@RestController
@RequestMapping("cache")
public class Demo2OfCacheController {
@GetMapping("/getById/{id}")
@Cacheable("people") //存储在Redis中的键为people::id 例如 people::111
public People getById(@PathVariable("id") String id) {
return new People("lisi", 23);
}
}
2.3 进行测试
直接访问
执行完getById方法返回数据之后,@Cacheable将会将返回结果保存到Redis中去,key为eople::id,value为所返回的People对象结果。
下次执行该方法时就会先根据key去Redis中查找,如果有直接返回,没有再进行方法的执行。
3、@Cacheable注解的进阶使用
3.1 定义多个缓存名存多份
@RestController
@RequestMapping("/cache")
public class Demo2OfCacheController {
@GetMapping("/getPeopleById/{id}")
@Cacheable({"people01","people02"})
public People getPeopleById(@PathVariable("id") String id) {
return new People("lisi", 23);
}
}
3.2 自定义key参数
默认的key拼串并不是很友好,调用的方法只有一个参数时,会自动使用@Cacheable(“student00”)中设置的student00 + :: + 传入参数;当多个参数时:
@RestController
@RequestMapping("/cache")
public class Demo2OfCacheController {
@GetMapping("/getByIdAndName/{id}/{name}")
//组成的key为 people03::id-name:111-lisi
@Cacheable(value = "people03", key = "'id-name:' + #id + '-' + #name")
public People getByIdAndName(@PathVariable("id") String id,
@PathVariable("name") String name) {
return new People("lisi", 23);
}
}
3.3 条件判断
可加入缓存判断条件,对方法传入参数进行判断,满足条件则执行缓存查询;不满足条件则直接把该方法当作普通方法使用,不会进行缓存判断,也不会把结果放近缓存。
condition = “#id > 1” //只有id>1才走缓存
3.4 是否使用异步模式
@Cacheable()中可加入sync = true/false属性,
是否使用异步模式。默认是方法执行完,以同步的方式将方法返回的结果存在缓存中。
3.5 设置过期时间
默认Cacheable使用公用的RedisCacheManager,可以自定义RedisCacheManager来实现ttl设置
PS:项目中已配置了RedisCacheManager需要在原配置的bean上添加注解**@Primary**,以免造成干扰
使用时使用cacheManager = "xxxCacheManager"进行使用