redissonclient semaphore 工具类

### 使用 RedissonClient 实现 Semaphore 的工具类

Redisson 提供了基于 Redis 的分布式信号量 `RSemaphore`，该对象实现了 Java 中的 `Semaphore` 接口。这使得可以轻松创建和管理分布式的信号量资源。

#### 创建并初始化 RedissonClient

为了使用 Redisson 功能，首先需要配置并启动一个 `RedissonClient` 实例：

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

public class RedissonUtil {
    private static final Config config = new Config();
    
    static {
        // 配置连接到单个 Redis 服务器或集群的方式
        config.useSingleServer().setAddress("redis://127.0.0.1:6379");
        
        // 初始化客户端
        redissonClient = Redisson.create(config);
    }
}

#### 构建 Semaphore 工具类

下面是一个简单的工具类示例，用于获取、释放以及尝试获得许可：

import org.redisson.api.RSemaphore;
import org.redisson.api.RedissonClient;

public class DistributedSemaphoreTool {

    private final RSemaphore semaphore;
    private final int permits;

    /**
     * 构造函数接收 Redisson 客户端实例和信号量名称作为参数
     */
    public DistributedSemaphoreTool(RedissonClient client, String name, int initialPermits) {
        this.semaphore = client.getSemaphore(name);
        this.permits = initialPermits;
        try {
            // 设置初始可用许可证数量
            semaphore.trySetAvailablePermits(permits);
        } catch (Exception e){
            System.err.println("Failed to set available permits.");
        }
    }

    /**
     * 获取指定数量的许可，默认为1
     */
    public boolean acquire(int numPermises) throws InterruptedException {
        return semaphore.acquire(numPermises);
    }

    /**
     * 尝试立即获取指定数量的许可而不阻塞
     */
    public boolean tryAcquire(int numPermises) {
        return semaphore.tryAcquire(numPermises);
    }

    /**
     * 释放指定数量的许可
     */
    public void release(int numPermises) {
        semaphore.release(numPermises);
    }
}

此代码片段展示了如何定义一个名为 `DistributedSemaphoreTool` 的工具类来封装对 `RSemaphore` API 的调用[^1]。