新手必备：SpringBoot3如何使用redis？怎么配置？实现一个常用工具类？

本文主要是介绍新手必备：SpringBoot3如何使用redis？怎么配置？实现一个常用工具类？，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

最近在做 Spring Boot 项目，借此机会，我使用了 Spring Boot 3 和 JDK 17 的组合，整理了一下 Redis 的配置方式，并通过实践实现了常用的 Redis 工具类。我这里主要是整理一下如何在 Spring Boot 3 中使用 Redis，以及如何自定义工具类实现常见的 Redis 操作。

Spring Boot 3.x 和 JDK 17 兼容，特别是在 Spring Boot 3 中引入了 Jakarta EE 9 的命名空间（如包名从 javax 改为 jakarta），因此在使用一些依赖时需要注意兼容性问题。

1、引入依赖

首先，我们要确保项目中已经引入了 Redis 相关的依赖。spring-boot-starter-data-redis 是使用 Redis 的核心依赖，它包含了 RedisTemplate 等必要的类。

在 pom.xml 文件中（如果使用 Maven），确保包含以下依赖：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

如果使用 Gradle，确保 build.gradle 中有以下依赖：

implementation 'org.springframework.boot:spring-boot-starter-data-redis'

2、application的配置

在 application.yml 文件中添加 Redis 相关的配置，这里有一点需要注意。Springboot2 中的配置是spring.redis，Springboot3 中的配置是spring.data.redis。

参考配置如下所示：

spring:data:redis:host: 127.0.0.1port: 6379database: 0timeout: 1800s # 使用时间格式化password:lettuce:pool:max-active: 20  # 最大连接数max-wait: -1    # 最大阻塞等待时间(负数表示没限制)max-idle: 5     # 最大空闲min-idle: 0     # 最小空闲

关键参数说明：

• host：Redis 服务器的主机地址。
• port：Redis 服务器的端口。
• database：使用的数据库索引。
• timeout：连接超时时间。
• lettuce.pool：Lettuce 连接池配置，控制 Redis 连接的并发数、空闲连接数等。

3、自定义某些配置

为了定制化 Redis 的使用方式，我们可以创建一个 RedisConfig 配置类，自定义 RedisTemplate 和 RedisCacheManager，以便对 Redis 的键值进行序列化和缓存管理。这里定义对象序列化的方式，可以直接往Reids中存放对象，它实现自动转换。

@Configuration
@EnableCaching
public class RedisConfig {// 配置 RedisTemplate，用于操作 Redis 数据库@Beanpublic RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {// 创建 RedisTemplate 对象，用于执行 Redis 操作RedisTemplate<String, Object> redisTemplate = new RedisTemplate<>();// 设置连接工厂，用于与 Redis 建立连接redisTemplate.setConnectionFactory(factory);// 设置 key 的序列化器，使用 StringRedisSerializer 将 key 序列化为字符串redisTemplate.setKeySerializer(new StringRedisSerializer());// 设置 value 的序列化器，使用 GenericJackson2JsonRedisSerializer 将对象序列化为 JSONredisTemplate.setValueSerializer(new GenericJackson2JsonRedisSerializer());// 设置 hash key 的序列化器，使用 StringRedisSerializer 序列化 hash 的 keyredisTemplate.setHashKeySerializer(new StringRedisSerializer());// 设置 hash value 的序列化器，使用 Jackson2JsonRedisSerializer 将 hash 值序列化为 JSONredisTemplate.setHashValueSerializer(new Jackson2JsonRedisSerializer<Object>(Object.class));// 返回配置好的 RedisTemplatereturn redisTemplate;}// 配置 RedisCacheManager，用于管理 Redis 缓存@Beanpublic RedisCacheManager redisCacheManager(RedisTemplate redisTemplate) {// 创建 RedisCacheWriter，nonLockingRedisCacheWriter 表示不使用锁机制进行缓存操作RedisCacheWriter redisCacheWriter = RedisCacheWriter.nonLockingRedisCacheWriter(redisTemplate.getConnectionFactory());// 配置 RedisCacheConfiguration，指定缓存值的序列化方式，使用 RedisTemplate 中配置的 ValueSerializer 进行序列化RedisCacheConfiguration redisCacheConfiguration = RedisCacheConfiguration.defaultCacheConfig().serializeValuesWith(RedisSerializationContext.SerializationPair.fromSerializer(redisTemplate.getValueSerializer()));// 返回配置好的 RedisCacheManagerreturn new RedisCacheManager(redisCacheWriter, redisCacheConfiguration);}
}

• @Configuration 注解：用于标记这是一个配置类，Spring 会在应用启动时加载该类中的配置，生成相关的 Bean 并将其管理。用于自定义 Redis 相关的 Bean。

• @EnableCaching 注解：启用 Spring 的缓存支持。通过这个注解，Spring 将使用缓存机制，并根据配置的缓存管理器管理缓存。

• RedisTemplate：用于执行 Redis 操作。自定义了键（key）使用字符串序列化，值（value）使用 JSON 序列化。

• RedisCacheManager：管理缓存配置。缓存的值也通过 JSON 序列化存储，便于处理复杂数据。

4、自定义工具类

为了简化 Redis 的常用操作（如增删改查），我们可以创建一个 RedisUtil 工具类，便于在项目中使用。

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Component;import java.util.Arrays;
import java.util.concurrent.TimeUnit;/*** Redis工具类** @author luoxiaodou*/
@Component
public class RedisUtil {private static final Logger logger = LoggerFactory.getLogger(RedisUtil.class);private final RedisTemplate<String, Object> redisTemplate;/*** 在 Spring Boot 中，RedisTemplate 是由 Spring 自动配置的。* Spring Boot 的 spring-boot-starter-data-redis 会自动根据 application.yml* 或 application.properties 中的 Redis 配置生成* RedisTemplate 实例，并将其作为一个 Bean 注入到 Spring 容器中。** 从 Spring Framework 4.3 开始，如果类只有一个构造函数，Spring 会自动推断并使用这个构造函数进行依赖注入，无需显式地使用 @Autowired 注解。* 由于 RedisUtil 类中只有一个构造函数，因此 Spring 自动会将 RedisTemplate<String, Object> 注入到 RedisUtil 中。** @param redisTemplate*/@Autowiredpublic RedisUtil(RedisTemplate<String, Object> redisTemplate) {this.redisTemplate = redisTemplate;}/*** 设置缓存失效时间** @param key 键* @param time 时间(秒)*/public boolean expire(String key, long time) {if (time > 0) {return Boolean.TRUE.equals(redisTemplate.expire(key, time, TimeUnit.SECONDS));}return false;}/*** 根据key 获取过期时间** @param key 键 不能为null* @return 时间(秒) 返回0代表为永久有效*/public long getExpire(String key) {return redisTemplate.getExpire(key, TimeUnit.SECONDS);}/*** 判断key是否存在** @param key 键* @return true 存在 false不存在*/public boolean hasKey(String key) {return Boolean.TRUE.equals(redisTemplate.hasKey(key));}/*** 删除缓存** @param key 可以传一个值 或多个*/public void delete(String... key) {if (key != null && key.length > 0) {if (key.length == 1) {redisTemplate.delete(key[0]);} else {redisTemplate.delete(Arrays.asList(key));}}}/*** 获取普通缓存** @param key 键* @return 值*/public Object get(String key) {return key == null ? null : redisTemplate.opsForValue().get(key);}/*** 泛型方法 get：<T> 使得 get 方法可以返回不同类型的对象，clazz 参数是对象的类型信息，传入后可以将存储的值反序列化为相应类型。* Redis 中的数据必须是通过 GenericJackson2JsonRedisSerializer 或类似的 JSON 序列化器存储的，确保可以成功反序列化。** @param key* @param clazz* @param <T>* @return*/public <T> T get(String key, Class<T> clazz) {try {Object value = redisTemplate.opsForValue().get(key);if (value != null) {// 自动转换成指定类型return clazz.cast(value);}} catch (Exception e) {logger.error(e.getMessage(), e);}return null;}/*** 普通缓存放入** @param key 键* @param value 值* @return true成功 false失败*/public boolean set(String key, Object value) {try {redisTemplate.opsForValue().set(key, value);return true;} catch (Exception e) {logger.error(e.getMessage(), e);return false;}}/*** 普通缓存放入并设置时间** @param key 键* @param value 值* @param time 时间(秒) time要大于0 如果time小于等于0 将设置无限期* @return true成功 false 失败*/public boolean set(String key, Object value, long time) {try {if (time > 0) {redisTemplate.opsForValue().set(key, value, time, TimeUnit.SECONDS);} else {set(key, value);}return true;} catch (Exception e) {logger.error(e.getMessage(), e);return false;}}
}

关键方法说明：

• expire：设置缓存的过期时间。
• getExpire：获取缓存项的过期时间。
• hasKey：判断缓存是否存在。
• delete：删除缓存。
• get：获取缓存中的值。
• set：设置缓存值，可选指定过期时间。

这篇关于新手必备：SpringBoot3如何使用redis？怎么配置？实现一个常用工具类？的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！

---