Spring Boot与Redis深度整合:实战指南
Spring Boot 整合 Redis 相当简单,它利用了 Spring Data Redis 项目,使得我们可以在 Spring Boot 应用中轻松地操作 Redis。以下是如何整合 Redis 到 Spring Boot 应用的基本步骤:
1. 添加依赖
首先,在你的 pom.xml 文件中添加 Spring Boot Data Redis 的依赖:
-
<dependencies>
-
<!-- 其他依赖 -->
-
<dependency>
-
<groupId>org.springframework.boot</groupId>
-
<artifactId>spring-boot-starter-data-redis</artifactId>
-
</dependency>
-
<!-- 如果使用Lettuce作为Redis客户端,需要添加此依赖 -->
-
<dependency>
-
<groupId>io.lettuce</groupId>
-
<artifactId>lettuce-core</artifactId>
-
</dependency>
-
<!-- 如果使用Jedis作为Redis客户端,需要添加此依赖 -->
-
<dependency>
-
<groupId>redis.clients</groupId>
-
<artifactId>jedis</artifactId>
-
</dependency>
-
</dependencies>
注意:Lettuce和Jedis是Spring Boot支持的两个主要的Redis客户端,你可以选择其中一个。在Spring Boot 2.x中,默认使用Lettuce。
2. 配置 Redis
在 application.properties 或 application.yml 文件中添加 Redis 的配置信息:
application.properties 示例
-
spring.redis.host=localhost
-
spring.redis.port=6379
-
spring.redis.password= # 如果设置了密码,则填写密码
-
spring.redis.database=0 # Redis数据库索引(默认为0)
-
spring.redis.jedis.pool.max-active=8 # 连接池最大连接数(使用Jedis时)
-
spring.redis.jedis.pool.max-wait=-1ms # 连接池最大阻塞等待时间(使用Jedis时)
-
spring.redis.jedis.pool.max-idle=8 # 连接池中的最大空闲连接(使用Jedis时)
-
spring.redis.jedis.pool.min-idle=0 # 连接池中的最小空闲连接(使用Jedis时)
-
spring.redis.lettuce.pool.max-active=8 # 连接池最大连接数(使用Lettuce时)
-
spring.redis.lettuce.pool.max-wait=-1ms # 连接池最大阻塞等待时间(使用Lettuce时)
-
spring.redis.lettuce.pool.max-idle=8 # 连接池中的最大空闲连接(使用Lettuce时)
-
spring.redis.lettuce.pool.min-idle=0 # 连接池中的最小空闲连接(使用Lettuce时)
application.yml 示例
-
spring:
-
redis:
-
host: localhost
-
port: 6379
-
password: # 如果设置了密码,则填写密码
-
database: 0 # Redis数据库索引(默认为0)
-
jedis:
-
pool:
-
max-active: 8 # 连接池最大连接数(使用Jedis时)
-
max-wait: -1ms # 连接池最大阻塞等待时间(使用Jedis时)
-
max-idle: 8 # 连接池中的最大空闲连接(使用Jedis时)
-
min-idle: 0 # 连接池中的最小空闲连接(使用Jedis时)
-
lettuce:
-
pool:
-
max-active: 8 # 连接池最大连接数(使用Lettuce时)
-
max-wait: -1ms # 连接池最大阻塞等待时间(使用Lettuce时)
-
max-idle: 8 # 连接池中的最大空闲连接(使用Lettuce时)
-
min-idle: 0 # 连接池中的最小空闲连接(使用Lettuce时)
这里要说的是:
Lettuce和Jedis两者都是Java连接Redis的客户端
选择使用Lettuce而不是Jedis的原因如下:
线程安全性:
- Lettuce 是基于 Netty 构建的,它使用异步和事件驱动的方式处理连接。因此,它可以在多个线程之间共享一个连接而不需要额外的同步,因此在高并发环境下更高效。
- Jedis 是基于阻塞 I/O 的,并且不是线程安全的,如果在多个线程中共享同一个 Jedis 实例,需要使用连接池进行同步管理,这可能引入额外的复杂性。
连接方式:
- Lettuce 支持基于 Reactive Streams 的响应式编程模型,能够更好地与 Spring Reactor、Project Reactor 等框架集成,提供异步和非阻塞的操作。
- Jedis 是同步的,并且在执行某些操作时会阻塞线程,这可能会影响应用程序的性能和响应性。
性能和扩展性:
- Lettuce 的设计目标是高性能和扩展性,它可以更好地利用 Redis 4.0 中引入的一些新特性(如 Redis Sentinel 和 Redis Cluster)。
- Jedis 的设计目标更偏向于简单易用,对于一些特殊的 Redis 集群模式可能支持不够完善。
维护和更新:
- Lettuce 是一个活跃的项目,并且持续地得到更新和改进。
- Jedis 在某些方面已经相对稳定,并且在一段时间内没有大的更新。
3. 创建 Redis 配置类
如果需要自定义 Redis 的配置(比如序列化器),可以创建一个配置类:
-
import org.springframework.context.annotation.Bean;
-
import org.springframework.context.annotation.Configuration;
-
import org.springframework.data.redis.connection.RedisConnectionFactory;
-
import org.springframework.data.redis.core.RedisTemplate;
-
import org.springframework.data.redis.serializer.StringRedisSerializer;
-
-
-
public class RedisConfig {
-
-
-
public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) {
-
RedisTemplate<String, Object> template = new RedisTemplate<>();
-
template.setConnectionFactory(redisConnectionFactory);
-
-
// 使用 StringRedisSerializer 来序列化和反序列化 key 值
-
template.setKeySerializer(new StringRedisSerializer());
-
// 使用 JdkSerializationRedisSerializer 来序列化和反序列化 value 值
-
// 你也可以自定义序列化器
-
template.setValueSerializer(new GenericToStringSerializer<>(Object.class));
-
-
template.afterPropertiesSet();
-
return template;
-
}
-
}
4. 使用 RedisTemplate 或 StringRedisTemplate
在 Spring Boot 应用中,你可以注入 RedisTemplate 或 StringRedisTemplate 来操作 Redis:
-
import org.springframework.beans.factory.annotation.Autowired;
-
import org.springframework.data.redis.core.RedisTemplate;
-
import org.springframework.stereotype.Service;
-
-
-
public class RedisService {
-
-
private final RedisTemplate<String, Object> redisTemplate;
-
-
-
public RedisService(RedisTemplate<String, Object> redisTemplate) {
-
this.redisTemplate = redisTemplate;
-
}
-
-
public void setValue(String key, Object value) {
-
redisTemplate.opsForValue().set(key, value);
-
}
-
-
public Object getValue(String key) {
-
return redisTemplate.opsForValue().get(key);
-
}
-
-
// 其他操作...
-
}
5. 编写测试
-
import org.junit.jupiter.api.Test;
-
import org.springframework.beans.factory.annotation.Autowired;
-
import org.springframework.boot.test.context.SpringBootTest;
-
import org.springframework.data.redis.core.StringRedisTemplate;
-
-
import java.util.concurrent.TimeUnit;
-
-
-
public class RedisTest {
-
-
private StringRedisTemplate stringRedisTemplate;
-
-
-
//测试redis
-
void contextLoads2() {
-
//添加缓存键值对name:mijiu并设置过期时间为1小时
-
stringRedisTemplate.opsForValue().set("name","mijiu",10, TimeUnit.SECONDS);
-
System.out.println(stringRedisTemplate.opsForValue().get("name"));
-
-
}
-
摘抄自网络,便于检索查找。

浙公网安备 33010602011771号