Java-基于Redisson的Redis工具类RedissonUtils

<think>我们正在开发一个名为RedissonUtils的工具类，用于简化Redisson客户端的初始化和常用操作。根据引用[3]，我们首先需要添加Redisson的Maven依赖。工具类的主要功能：1.初始化RedissonClient客户端（单例模式，避免重复创建）2.提供获取RedissonClient的方法3.提供关闭RedissonClient的方法4.封装一些常用操作，例如获取锁、设置对象等注意事项：-配置可以通过配置文件（如application.yml）或硬编码方式，但最佳实践是从配置文件读取。-考虑线程安全。步骤：1.创建一个RedissonUtils类，包含静态的RedissonClient实例。2.使用静态代码块或者懒加载方式初始化RedissonClient。3.提供获取RedissonClient的静态方法。4.封装常用操作，例如获取分布式锁。示例代码结构如下：</think> 基于提供的引用资料，下面是如何构建一个`RedissonUtils`工具类的完整示例和最佳实践： ### RedissonUtils工具类实现 ```java import org.redisson.Redisson; import org.redisson.api.RedissonClient; import org.redisson.config.Config; public class RedissonUtils { private static volatile RedissonClient redissonClient; // 私有构造防止实例化 private RedissonUtils() {} /** * 初始化Redisson客户端 (单例模式) * @param configPath 配置文件路径(格式：redis://127.0.0.1:6379) * @return RedissonClient实例 */ public static RedissonClient init(String configPath) { if (redissonClient == null) { synchronized (RedissonUtils.class) { if (redissonClient == null) { Config config = new Config(); config.useSingleServer() .setAddress(configPath) .setConnectionPoolSize(64); redissonClient = Redisson.create(config); } } } return redissonClient; } /** * 获取分布式锁 * @param lockName 锁名称 * @return RLock对象 */ public static RLock getLock(String lockName) { checkClientStatus(); return redissonClient.getLock(lockName); } /** * 安全关闭客户端 */ public static void shutdown() { if (redissonClient != null && !redissonClient.isShutdown()) { redissonClient.shutdown(); } } // 检查客户端状态 private static void checkClientStatus() { if (redissonClient == null) { throw new IllegalStateException("RedissonClient未初始化"); } if (redissonClient.isShutdown()) { throw new IllegalStateException("RedissonClient已关闭"); } } } ``` ### 使用示例 ```java // 1. 初始化客户端 RedissonUtils.init("redis://192.168.1.100:6379"); // 2. 获取分布式锁 RLock lock = RedissonUtils.getLock("orderLock"); try { lock.lock(10, TimeUnit.SECONDS); // 设置10秒超时 // 业务代码... System.out.println("执行分布式操作"); } finally { lock.unlock(); } // 3. 程序结束前关闭 RedissonUtils.shutdown(); ``` ### 最佳实践 1. **配置管理** - 从外部配置文件读取Redis地址（如`application.yml`） - 支持集群模式配置： ```java config.useClusterServers() .addNodeAddress("redis://node1:6379", "redis://node2:6380"); ``` 2. **连接池优化** 根据并发量调整连接池大小（默认64）： ```java .setConnectionPoolSize(128) // 高并发场景 ``` 3. **异常处理增强** ```java public static RLock getLockSafely(String lockName) { try { return getLock(lockName); } catch (RedisException e) { // 记录日志/告警 throw new ServiceException("获取分布式锁失败"); } } ``` 4. **对象序列化扩展** 添加对象操作工具方法： ```java public static <T> void setBucket(String key, T object) { checkClientStatus(); redissonClient.getBucket(key).set(object); } ``` 5. **健康检查** 添加连接状态检测： ```java public static boolean isActive() { return redissonClient != null && !redissonClient.isShutdown(); } ``` > **注意**：实际生产环境建议配合Spring容器管理生命周期，通过`@PostConstruct`初始化和`@PreDestroy`关闭客户端[^3]。