Springboot-Redis - 14.响应式的 Redis 支持

👀响应式的 Redis 支持

在近些年，响应式编程在 Java 社区中变得越来越受欢迎。Spring 框架也引入了对响应式编程的支持，其中包括对 Redis 的响应式支持。

✌1. Redis的要求

为了使用响应式的 Redis，你需要有以下的要求:

• Redis 服务器版本 3.0 或更高
• 使用 Lettuce 作为 Redis 驱动（目前是唯一的）

✌2. 使用响应式驱动连接到Redis

✍Redis的运行模式

Redis 支持多种运行模式，包括单机模式、哨兵模式和集群模式。你需要确保选择的驱动支持你的 Redis 运行模式。

✍ReactiveRedisConnection 和 ReactiveRedisConnectionFactory

ReactiveRedisConnection 和 ReactiveRedisConnectionFactory 是 Spring Data Redis 提供的用于与 Redis 交互的核心接口。

🎷作用:

• 创建与 Redis 的连接
• 管理连接的生命周期

🎷使用场景:

• 需要与 Redis 进行交互的任何场景

🎷示例代码:

@Autowired
private ReactiveRedisConnectionFactory factory;

public void connectToRedis() {
    ReactiveRedisConnection connection = factory.getReactiveConnection();
    // 使用 connection 进行 Redis 操作...
    connection.close();
}

✍配置 Lettuce 连接器（Connector）

Lettuce 是一个流行的 Redis 客户端，支持响应式编程。

🎷作用:

• 提供响应式的 Redis 连接

🎷使用场景:

• 需要响应式地与 Redis 进行交互的场景

🎷示例代码:

@Configuration
public class RedisConfig {

    @Bean
    public ReactiveRedisConnectionFactory reactiveRedisConnectionFactory() {
        return new LettuceConnectionFactory("localhost", 6379);
    }
}

✌3. 通过 ReactiveRedisTemplate 处理对象

ReactiveRedisTemplate 是一个提供了丰富 Redis 操作的类。

🎷作用:

• 提供响应式的 Redis 数据访问
• 提供对基本数据类型、集合和对象的操作

🎷使用场景:

• 需要响应式地与 Redis 进行数据访问的场景

🎷示例代码:

@Autowired
private ReactiveRedisTemplate<String, String> template;

public Mono<Boolean> setValue(String key, String value) {
    return template.opsForValue().set(key, value);
}

public Mono<String> getValue(String key) {
    return template.opsForValue().get(key);
}

✌4. 以字符串为重点的便利类

ReactiveStringRedisTemplate 是一个专注于字符串操作的类。

🎷作用:

• 提供响应式的 Redis 字符串数据访问

🎷使用场景:

• 当你只需要进行字符串操作时

🎷示例代码:

@Autowired
private ReactiveStringRedisTemplate template;

public Mono<Boolean> setStringValue(String key, String value) {
    return template.opsForValue().set(key, value);
}

public Mono<String> getStringValue(String key) {
    return template.opsForValue().get(key);
}

✌5. Redis Messaging/PubSub

✍发布消息

🎷作用:

• 异步地发送消息到指定的频道

🎷使用场景:

• 当你需要发送通知或广播消息时

🎷示例代码:

@Autowired
private ReactiveRedisTemplate<String, String> template;

public Mono<Long> publishMessage(String channel, String message) {
    return template.convertAndSend(channel, message);
}

✍订阅消息

🎷作用:

• 订阅指定频道的消息

🎷使用场景:

• 当你需要监听某个频道并处理其消息时

🎷示例代码:

@Autowired
private ReactiveRedisTemplate<String, String> template;

public Flux<ReactiveSubscription.Message<String, String>> subscribeChannel(String channel) {
    return template.listenToChannel(channel);
}

✍消息监听器容器ReactiveRedisMessageListenerContainer

🎷作用:

• 管理多个消息订阅

🎷使用场景:

• 当你需要订阅多个频道时

🎷示例代码:

在Spring Data Redis中，ReactiveRedisMessageListenerContainer提供了响应式的消息订阅功能。它允许我们订阅一个或多个Redis频道或模式，并对每个消息生成一个响应式流。

下面是在Spring Boot中使用ReactiveRedisMessageListenerContainer的示例代码：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.connection.ReactiveRedisConnectionFactory;
import org.springframework.data.redis.connection.ReactiveSubscription;
import org.springframework.data.redis.listener.ChannelTopic;
import org.springframework.data.redis.listener.ReactiveRedisMessageListenerContainer;
import org.springframework.stereotype.Service;
import reactor.core.publisher.Flux;

@Service
public class RedisSubscriberService {

    private final ReactiveRedisMessageListenerContainer container;

    @Autowired
    public RedisSubscriberService(ReactiveRedisConnectionFactory factory) {
        // 创建 ReactiveRedisMessageListenerContainer 实例
        this.container = new ReactiveRedisMessageListenerContainer(factory);
    }

    /**
     * 订阅一个 Redis 频道。
     * 
     * @param channelName 频道名称
     * @return 响应式流，包含从指定频道接收到的所有消息
     */
    public Flux<ReactiveSubscription.Message<String, String>> subscribe(String channelName) {
        // 创建一个频道主题
        ChannelTopic topic = new ChannelTopic(channelName);
        
        // 使用 container 的 receive 方法订阅该主题，并返回消息的响应式流
        return container.receive(topic);
    }

    // ... 其他业务方法 ...
}

这里的代码首先创建了一个ReactiveRedisMessageListenerContainer实例，然后提供了一个subscribe方法，允许我们订阅一个Redis频道并返回一个响应式流。这个流会包含从该频道接收到的所有消息。

当你订阅一个频道后，你可以像处理任何其他响应式流一样处理这个流，例如使用subscribe方法处理每个消息，或使用其他Reactor操作符对其进行转换和处理。

注意: 为了这个示例能够工作，你需要确保你的Spring Boot应用已经配置了响应式的Redis支持，并且已经引入了相应的依赖。

✍通过 template API 订阅

你还可以使用 ReactiveRedisTemplate 的 API 来订阅消息。

🎷示例代码:

@Autowired
private ReactiveRedisTemplate<String, String> template;

public Flux<ReactiveSubscription.Message<String, String>> subscribeUsingTemplate(String channel) {
    return template.listenToChannel(channel);
}

✌6. 响应式脚本（Reactive Scripting）

🎷作用:

• 允许你执行 Lua 脚本，这样可以在 Redis 服务器上原子性地执行复杂的操作

🎷使用场景:

• 当你需要在 Redis 服务器上执行原子性操作时

🎷示例代码:

@Autowired
private ReactiveRedisTemplate<String, String> template;

public Mono<String> executeScript(String script, List<String> keys, String... args) {
    return template.execute(script, keys, args);
}

注意: 上述代码仅为示意，具体实现可能需要根据你的实际需求进行调整。另外，为了使用上述功能，你还需要确保已经正确配置了响应式的 Redis 和相关的依赖。