前言

其实在Springboot中集成redis是一个非常简单的事情，但是为什么要单独输出一篇文章来记录这个过程呢？第一个原因是，我记性不是太好，这次把这个过程记录下，在新的项目搭建的时候或者需要在本地集成redis做一些其他相关联技术的测试分析的时候，可以很快找到集成方法；第二个原因是，最早我记得Spring项目里集成redis的时候，用的是jedis作为客户端，而在Springboot2.0后，这一事实改变了，默认的是lettuce。作为一个成熟的程序员来说，我是乐于拥抱变化的，改变意味着新的可能。

文章示例环境配置信息
jdk版本:1.8
开发工具：Intellij iDEA 2020.1
springboot:2.3.9.RELEASE

依赖配置

Springboot本身已经提供好了关于redis的starter，即spring-boot-starter-data-redis，在使用redis连接池的时候会依赖到commons-pool2包。

org.springframework.bootspring-boot-starter-data-redis

org.apache.commonscommons-pool2

application.properties配置

单机模式

redis单机模式下，配置的连接参数是比较简单的，有主机ip、端口、连接验证密码，如果使用了连接池，再加连接池的几个参数就算配置完成了;

#单机模式
#redis主机ip
spring.redis.host=localhost
#redis对外提供服务端口
spring.redis.port=6379
#redis连接验证密码
spring.redis.password=fanfu123
#redis连接池配置-最大保持闲置的连接数
spring.redis.lettuce.pool.max-idle=16
#redis连接池配置-最大活跃的连接数
spring.redis.lettuce.pool.max-active=20
#redis连接池配置-最大等待时间，单位毫秒
spring.redis.lettuce.pool.max-wait=1

集群模式

集群模式下与单机模式的连接参数配置最大的区别就在于，这里配置的是多个节点主机ip+端口，多个节点之间英文逗号隔开；另外就是一些集群模式特有的参数，如重定向次数、集群刷新等；

#集群模式
#集群节点ip+端口，多个节点之间以英文逗号隔开
spring.redis.cluster.nodes=172.18.229.61:6380,172.18.229.61:6381,172.18.229.61:6382,172.18.229.61:6383,172.18.229.61:6384,172.18.229.61:6385;
#密码
spring.redis.password=fanfu123
#最大重定向次数
spring.redis.cluster.max-redirects=5
#是否开启集群刷新功能
spring.redis.lettuce.cluster.refresh.adaptive=false
#集群刷新间隔
spring.redis.lettuce.cluster.refresh.period=10M

redis密码更新

redis的配置文件，我本机操作系统是windows，使用了redis.windows.conf配置文件，更改内容如下：

requirepass fanfu123

单元测试

1、在redis.windows.conf配置文件中配置好密码，然后启动redis，这里我写了一个windwos上的批处理文件start.bat来启动redis，start.bat内容如下：

title redis-6385
redis-server.exe redis.windows.conf

2、在项目里增加依赖配置spring-boot-starter-data-redis和commons-pool2，并在application.properties中配置好redis的连接信息；

3、编写单元测试，使用redisTemplate对象往redis中设置一个key-value的键值对并读取；RedisTemplate是spring-data-redis提供的一个操作reids的类，可以直接注入单元测试或其他spring的bean中使用；

@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class RedisTest {@Autowiredprivate RedisTemplate redisTemplate;@Testpublic void test() {redisTemplate.opsForValue().set("username", "凡夫");String name = redisTemplate.opsForValue().get("name").toString();Assert.isTrue(name.equals("凡夫"), "xxxx");}
}

单元测试执行结果，发现key是这样的“\xAC\xED\x00\x05t\x00\x08username”，出现这样类似乱码的现象是因为注入的redisTemplate对象使用了默认的序列化方式JdkSerializationRedisSerializer，具体就是使用redisTemplate对象把key存储到redis中的时候，就会先使用JdkSerializationRedisSerializer对key进行序列化，序列后的结果存储在redis服务端；

这样在观察redis中存储的key时不太直观，为了解决redis中key使用默认序列化产生类似乱码的现象，需要重新定义redisTemplate对象并注入到Spring容器中，这里key的序列化使用StringRedisSerializer的方式，就可以消除上面类似乱码的现象；value类型是String，默认的序列化方式是StringRedisSerializer；value的类型是object，默认的序列化方式是JdkSerializationRedisSerializer；而一般经常使用的对象序列化方式是Jackson2JsonRedisSerializer；

这里再简单梳理一下redis本身提供的几种序列化方式 ：

GenericToStringSerializer: 可以将任何对象泛化为字符串并序列化

Jackson2JsonRedisSerializer: 序列化object对象为json字符串

JdkSerializationRedisSerializer: 序列化java对象

StringRedisSerializer: 简单的字符串序列化

@Configuration
public class RedisConfig {@Bean(name = "redisTemplate")public RedisTemplate getRedisTemplate(RedisConnectionFactory factory) {RedisTemplate redisTemplate = new RedisTemplate();redisTemplate.setConnectionFactory(factory);//key采用string的序列化方式StringRedisSerializer stringRedisSerializer = new StringRedisSerializer();redisTemplate.setKeySerializer(stringRedisSerializer);Jackson2JsonRedisSerializer jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer(Object.class);ObjectMapper objectMapper = new ObjectMapper();objectMapper.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);objectMapper.activateDefaultTyping(LaissezFaireSubTypeValidator.instance ,ObjectMapper.DefaultTyping.NON_FINAL, JsonTypeInfo.As.PROPERTY);jackson2JsonRedisSerializer.setObjectMapper(objectMapper);jackson2JsonRedisSerializer.setObjectMapper(objectMapper);//value的序列化方式采用jacksonredisTemplate.setValueSerializer(jackson2JsonRedisSerializer);//hash的key也采用string的序列化方式redisTemplate.setHashKeySerializer(stringRedisSerializer);//hash的value也采用jackson的序列化方式redisTemplate.setHashValueSerializer(jackson2JsonRedisSerializer);redisTemplate.afterPropertiesSet();return redisTemplate;}
}

工具类封装

redis有五种数据类型，分别是String、hash、list、set、zset，spring-data-redis中的redisTemplate针对每种类型value的操作命令都进行封装，如下：

ValueOperations valueOperations = redisTemplate.opsForValue();//string
HashOperations hashOperations = redisTemplate.opsForHash();//hash
ListOperations listOperations = redisTemplate.opsForList();//list
SetOperations setOperations = redisTemplate.opsForSet();//set
ZSetOperations zSetOperations = redisTemplate.opsForZSet();//zset

为了方便使用，可以单独封装成一个工具类，使用的时候直接通过工具类来操作，如下：

@Component
public class RedisService {@Autowiredprivate RedisTemplate redisTemplate;/*** 给一个指定的 key 值附加过期时间* @param key* @param time* @return*/public boolean expire(String key, long time) {return redisTemplate.expire(key, time, TimeUnit.SECONDS);}/*** 根据key 获取过期时间* @param key* @return*/public long getTime(String key) {return redisTemplate.getExpire(key, TimeUnit.SECONDS);}/*** 判断指定的key是否存在* @param key* @return*/public boolean hasKey(String key) {return redisTemplate.hasKey(key);}/*** 移除指定key的过期时间* @param key* @return*/public boolean persist(String key) {return redisTemplate.boundValueOps(key).persist();}/*** 根据key获取值* @param key 键* @return 值*/public Object get(String key) {return key == null ? null : redisTemplate.opsForValue().get(key);}/*** 将值放入缓存* @param key   键* @param value 值* @return true成功 false 失败*/public void set(String key, String value) {redisTemplate.opsForValue().set(key, value);}/*** 将值放入缓存并设置时间* @param key   键* @param value 值* @param time  时间(秒) -1为无期限* @return true成功 false 失败*/public void set(String key, String value, long time) {if (time > 0) {redisTemplate.opsForValue().set(key, value, time, TimeUnit.SECONDS);} else {redisTemplate.opsForValue().set(key, value);}}/*** 批量添加 key (重复的键会覆盖)* @param keyAndValue*/public void batchSet(Map keyAndValue) {redisTemplate.opsForValue().multiSet(keyAndValue);}/*** 批量添加 key-value 只有在键不存在时,才添加* map 中只要有一个key存在,则全部不添加* @param keyAndValue*/public void batchSetIfAbsent(Map keyAndValue) {redisTemplate.opsForValue().multiSetIfAbsent(keyAndValue);}/*** 对一个 key-value 的值进行加减操作,* 如果该 key 不存在 将创建一个key 并赋值该 number* 如果 key 存在,但 value 不是长整型 ,将报错* @param key* @param number*/public Long increment(String key, long number) {return redisTemplate.opsForValue().increment(key, number);}/*** 对一个 key-value 的值进行加减操作,* 如果该 key 不存在 将创建一个key 并赋值该 number* 如果 key 存在,但 value 不是 纯数字 ,将报错* @param key* @param number*/public Double increment(String key, double number) {return redisTemplate.opsForValue().increment(key, number);}/*** 将数据放入set缓存* @param key 键* @return*/public void sSet(String key, String value) {redisTemplate.opsForSet().add(key, value);}/*** 获取变量中的值* @param key 键* @return*/public Set