java redission

### Java Redisson 使用教程

#### 1. Redisson简介
Redisson 是一种用于 Java 应用程序的强大 Redis 客户端，提供了多种分布式对象和服务。通过 Redisson 可以轻松地在 Java 中操作 Redis 数据结构并利用其丰富的功能集[^3]。

#### 2. 添加依赖项
为了使用 Redisson，在 Maven 或 Gradle 构建工具中添加相应的依赖项：

对于Maven项目：

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

对于Gradle项目：

implementation 'org.redisson:redisson:3.17.0'

#### 3. 配置与初始化
创建 `Config` 对象来指定连接参数，并基于此配置实例化 `RedissonClient` 实例。下面是一个简单的单机模式下的例子:

import org.redisson.Redisson;
import org.redisson.api.RedissonClient;
import org.redisson.config.Config;

public class RedissonInit {
    public static void main(String[] args) throws Exception {
        Config config = new Config();
        config.useSingleServer().setAddress("redis://127.0.0.1:6379");
        
        RedissonClient redisson = Redisson.create(config);
        // ... do something ...
        redisson.shutdown();
    }
}

如果要连接到 Redis Sentinel 集群，则可以按照如下方式设置配置文件[^2]:

config.useSentinelServers()
      .addSentinelAddress("redis://sentinel-host1:26379", "redis://sentinel-host2:26379")
      .setMasterName("mymaster");

#### 4. 分布式锁 (RLock)

Redisson 提供了一个名为 RLock 的接口，实现了 JUC 下的 Lock 接口。这使得开发者可以在不同 JVM 节点之间共享同一个锁资源，从而实现跨进程同步访问控制[^1].

import org.redisson.api.RLock;
// ...

RLock lock = redisson.getLock("anyLock");

lock.lock();

try {
    // 执行业务逻辑...
} finally {
    lock.unlock();
}

#### 5. 分布式信号量(RSemaphore)
除了基本的数据类型外，Redisson 还支持更复杂的并发原语如 Semaphore 。RSemaphore 类似于 JDK 自带版本但是能够在多个节点间工作正常.

import org.redisson.api.RSemaphore;
//...

RSemaphore semaphore = redisson.getSemaphore("mySemaphore");
semaphore.tryAcquire(permits);

try {
    // 处理任务...
} finally {
    semaphore.release(permits);
}

#### 6. 存储复杂数据结构(RBucket)
借助 RBucket ，可以直接保存整个序列化的 Java 对象而不仅仅是字符串键值对。这对于缓存大型实体特别有用[^4].

import org.redisson.api.RBucket;
//...

RBucket<MyObject> bucket = redisson.getBucket("bucketName");
MyObject obj = new MyObject();
obj.setName("test object");

bucket.set(obj);
System.out.println(bucket.get());