Redisson下载与安装：快速获取高性能Redis客户端

你是否在寻找一款既易用又高性能的Redis客户端？Redisson作为基于Netty框架的Java Redis客户端，不仅提供了丰富的分布式对象和服务，还能无缝集成主流Java框架。本文将带你快速完成Redisson的下载与安装，让你轻松上手这个强大的工具。读完本文后，你将掌握多种安装方式（Maven、Gradle、源码编译）、Spring Boot集成方法以及基础配置技巧。

Redisson简介

Redisson是一个基于Redis的Java客户端，它提供了分布式锁、分布式集合等高级功能，同时支持多种Redis部署模式。Redisson的核心优势在于其丰富的分布式对象和服务，以及与Spring、Hibernate等主流框架的良好集成。

Redisson支持Redis 3.0 - 7.2以及Valkey 7.2.5+，兼容多种部署类型，包括单机、集群、哨兵等模式。其主要特性包括线程安全实现、自动重连、SSL支持、异步连接池、Lua脚本等。详细功能可参考README.md。

下载与安装

Maven安装

在Maven项目中，只需在pom.xml中添加以下依赖即可：

<dependency>
    <groupId>org.redisson</groupId>
    <artifactId>redisson</artifactId>
    <version>3.30.0</version>
</dependency>

Gradle安装

对于Gradle项目，在build.gradle中添加：

compile 'org.redisson:redisson:3.30.0'

SBT安装

SBT项目的依赖配置如下：

libraryDependencies += "org.redisson" % "redisson" % "3.30.0"

源码编译安装

如果需要从源码编译安装，可以通过以下步骤进行：

1. 克隆仓库：

git clone https://gitcode.com/gh_mirrors/red/redisson.git
cd redisson

2. 使用Maven编译：

mvn clean install -DskipTests

编译后的JAR文件将位于各模块的target目录下，如redisson/target/redisson-3.30.0.jar。

Spring Boot集成

Redisson提供了专门的Spring Boot Starter，方便在Spring Boot项目中快速集成。

添加依赖

在Maven项目中，添加以下依赖：

<dependency>
    <groupId>org.redisson</groupId>
    <artifactId>redisson-spring-boot-starter</artifactId>
    <version>3.30.0</version>
</dependency>

对于Gradle项目：

compile 'org.redisson:redisson-spring-boot-starter:3.30.0'

详细集成说明可参考redisson-spring-boot-starter/README.md。

版本适配

redisson-spring-boot-starter依赖于redisson-spring-data模块，不同的Spring Boot版本需要对应不同的redisson-spring-data模块：

redisson-spring-data模块	Spring Boot版本
redisson-spring-data-16	1.3.y
redisson-spring-data-17	1.4.y
redisson-spring-data-18	1.5.y
redisson-spring-data-2x	2.x.y
redisson-spring-data-3x	3.x.y

如果需要降级redisson-spring-data模块，以Gradle为例：

implementation ("org.redisson:redisson-spring-boot-starter:3.30.0") {
    exclude group: 'org.redisson', module: 'redisson-spring-data-31'
}
implementation "org.redisson:redisson-spring-data-27:3.30.0"

配置文件

Spring Boot项目中，可以通过application.yml或application.properties进行配置。以下是几种常见的配置方式：

使用Spring Boot默认配置

Spring Boot 3.x+：

spring:
  data:
    redis:
      host: localhost
      port: 6379
      password:
      timeout: 2000

Spring Boot 2.x：

spring:
  redis:
    host: localhost
    port: 6379
    password:
    timeout: 2000

使用Redisson配置文件

spring:
  redis:
    redisson:
      file: classpath:redisson.yaml

内联Redisson配置

spring:
  redis:
    redisson:
      config: |
        clusterServersConfig:
          nodeAddresses:
            - "redis://127.0.0.1:7004"
            - "redis://127.0.0.1:7001"
            - "redis://127.0.0.1:7000"
          readMode: "SLAVE"
          subscriptionMode: "SLAVE"
        threads: 16
        nettyThreads: 32
        codec: !<org.redisson.codec.Kryo5Codec> {}
        transportMode: "NIO"

可用的Spring Bean

集成后，Spring容器中将自动配置以下Bean：

• RedissonClient
• RedissonRxClient
• RedissonReactiveClient
• RedisTemplate
• ReactiveRedisTemplate

基础使用示例

创建Redisson客户端

// 创建配置对象
Config config = new Config();
config.useSingleServer()
      .setAddress("redis://127.0.0.1:6379");

// 创建Redisson实例
RedissonClient redisson = Redisson.create(config);

// 获取分布式Map
RMap<String, String> map = redisson.getMap("myMap");
map.put("key", "value");
String value = map.get("key");

// 关闭客户端
redisson.shutdown();

使用分布式锁

RLock lock = redisson.getLock("myLock");
try {
    // 加锁，最多等待100秒，10秒后自动释放
    boolean locked = lock.tryLock(100, 10, TimeUnit.SECONDS);
    if (locked) {
        // 业务逻辑
    }
} catch (InterruptedException e) {
    Thread.currentThread().interrupt();
} finally {
    // 释放锁
    if (lock.isHeldByCurrentThread()) {
        lock.unlock();
    }
}

其他集成方式

Redisson还提供了与其他框架的集成模块，如Hibernate、MyBatis、Quarkus等：

• Hibernate集成：redisson-hibernate/README.md
• MyBatis集成：redisson-mybatis/README.md
• Quarkus集成：redisson-quarkus/README.md
• Micronaut集成：redisson-micronaut/README.md

常见问题

如何禁用Redisson？

在某些环境中可能不需要Redis，可以通过以下方式禁用Redisson：

Spring Boot 2.7+：

@SpringBootApplication
@EnableAutoConfiguration(exclude = {RedissonAutoConfigurationV2.class})
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

或在application.yml中配置：

spring:
  autoconfigure:
    exclude:
      - org.redisson.spring.starter.RedissonAutoConfigurationV2

如何替换Netty版本？

可以在Maven的pom.xml中指定Netty版本：

<properties>
    <netty.version>4.1.107.Final</netty.version>
</properties>

总结

本文介绍了Redisson的下载、安装以及Spring Boot集成方法，涵盖了Maven、Gradle等依赖管理工具的配置，以及源码编译的步骤。同时，提供了基础的使用示例和常见问题解答。

Redisson作为一款功能强大的Redis客户端，不仅提供了丰富的分布式对象和服务，还能与主流Java框架无缝集成，是构建分布式系统的理想选择。更多详细信息可参考官方文档和各模块的README文件。

如果觉得本文对你有帮助，欢迎点赞、收藏、关注，以便获取更多关于Redisson的使用技巧和最佳实践。