详细学习一下 Redisson 的 `RFuture`

一篇从 源码到实战 的完整笔记 版本:Redisson 3.23.4 + JDK 17


目录

  1. 前言

  2. RFuture 是什么

  3. 类图与继承体系

  4. 生命周期 & 状态流转

  5. 四种典型用法

    1. 同步阻塞 get()
    2. 异步回调 whenComplete()
    3. 链式组合 thenCompose()
    4. 批量等待 CompletableFuture.allOf()
  6. 与 JDK Future 的差异

  7. 线程模型与调度器

  8. 常见陷阱 & 最佳实践

  9. 性能调优

  10. 总结


前言

在 Redisson 里,所有异步 APIRBucketAsync, RLockAsync, RMapAsync...) 都返回 RFuture<T>。 理解它 = 理解 Redisson 异步编程的全部乐趣。


RFuture 是什么

表格

复制

维度 描述
定义 public interface RFuture<V> extends CompletionStage<V>, Future<V>
作用 统一异步结果容器,屏蔽 Netty 与 JDK Future 差异
实现 RedissonPromise (内部继承 Netty DefaultPromise

类图与继承体系


生命周期 & 状态流转

表格

复制

状态 含义
UNSUCCESS 未完成
SUCCESS 正常完成
FAILURE 异常完成

java

复制

arduino 复制代码
enum PromiseState { UNSUCCESS, SUCCESS, FAILURE }

四种典型用法

1. 同步阻塞 get()

java

复制

ini 复制代码
RFuture<String> f = bucket.getAsync();
String value = f.get(3, TimeUnit.SECONDS);

2. 异步回调 whenComplete

java

复制

lua 复制代码
f.whenComplete((r, e) -> {
    if (e == null) {
        log.info("value: {}", r);
    } else {
        log.error("error", e);
    }
});

3. 链式组合 thenCompose

java

复制

less 复制代码
bucket.setAsync("A")
      .thenCompose(v -> bucket.getAsync())
      .thenAccept(System.out::println);

4. 批量等待

java

复制

vbscript 复制代码
List<RFuture<?>> batch = List.of(
        bucket.setAsync("a"),
        map.putAsync("k", "v")
);
CompletableFuture.allOf(batch.toArray(new CompletableFuture[0])).join();

与 JDK Future 的差异

表格

复制

特性 RFuture JDK Future
回调注册 addListener()
链式 API thenCompose()
超时 await(timeout)
取消 cancel(true)
异常携带 cause() get() 抛出

线程模型与调度器

  • 内部线程 :Redisson 的 ExecutorService(默认 ForkJoinPool.commonPool()
  • 回调线程:Netty EventLoop 或业务线程
  • 线程切换thenRunAsync(executor) 显式指定

常见陷阱 & 最佳实践

表格

复制

陷阱 解决
回调阻塞 耗时任务转业务线程
内存泄漏 ByteBuf 需要 release()
死循环 避免在回调里再次同步等待

性能调优

表格

复制

配置 建议
线程池 redisson.executor = customExecutor
连接池 redisson.nettyThreads = 0
超时 RFuture.get(timeout)

总结

  • RFuture = Netty Promise + JDK CompletionStage
  • 三步走:注册 → 完成 → 回调
  • 一句话 :掌握 RFuture,就掌握了 Redisson 异步世界的钥匙!
相关推荐
程序员鱼皮22 分钟前
前后端分离,千万别再搞错了!
java·前端·后端·计算机·程序员·编程·软件开发
葡萄城技术团队25 分钟前
Django 与 FastAPI 架构对比:学习路径指南
后端
golang学习记35 分钟前
Go Web 应用中的配置管理最佳实践
后端
SimonKing36 分钟前
【开发者必备】Spring Boot 2.7.x:WebMvcConfigurer配置手册来了(五)!
java·后端·程序员
Value_Think_Power1 小时前
Dapr pub/sub
后端
间彧1 小时前
Fastjson Map转JSON字符串API详解与项目实战
后端
Value_Think_Power1 小时前
dapr::Listiner
后端
闲云散1 小时前
WebClient 简述
java·后端
狗头大军之江苏分军1 小时前
请不要在感情里丢掉你的“我”
前端·后端
BingoGo1 小时前
2025 年必须尝试的 5 个 Laravel 新特性
后端