Java 并发学习专题

CompletableFuture:转换结果与组合异步步骤

用 JDK 21 程序比较 thenApply、thenCompose 和 thenCombine,观察嵌套 Future 与展开后的结果,并明确异步执行器和等待位置。

简明结论

thenApply 转换结果,thenCompose 连接返回另一个阶段的步骤,thenCombine 合并两个阶段的结果;带 Async 的方法才表达异步调度意图。

查询用户之后还要异步查询详情,应返回嵌套的 Future,还是一个最终 Future?关键看回调本身的返回类型。下面把三种组合放进同一个可运行程序。

可复现程序

保存为 FutureComposition.java,用 JDK 21 执行 java FutureComposition.java。线程池只处理本例有限的两个异步计算,程序结束时关闭。

import java.util.concurrent.*;

public class FutureComposition {
  public static void main(String[] args) {
    ExecutorService pool = Executors.newFixedThreadPool(2); // Two finite demo tasks, not a production queue policy.
    try {
      CompletableFuture<String> user = CompletableFuture.supplyAsync(() -> "user", pool);
      CompletableFuture<Integer> length = user.thenApply(String::length);
      CompletableFuture<CompletableFuture<String>> nested = user.thenApply(
          id -> CompletableFuture.completedFuture(id + "-detail"));
      CompletableFuture<String> flat = user.thenCompose(
          id -> CompletableFuture.supplyAsync(() -> id + "-detail", pool));
      CompletableFuture<Integer> combined = length.thenCombine(
          CompletableFuture.completedFuture(2), Integer::sum);
      System.out.println("length=" + length.join());
      System.out.println("nested=" + nested.join().join());
      System.out.println("flat=" + flat.join());
      System.out.println("combined=" + combined.join());
    } finally { pool.shutdown(); }
  }
}

预期输出:

length=4
nested=user-detail
flat=user-detail
combined=6

length 把字符串变成整数;nested 的回调返回另一个 Future,所以读取结果需两次 join。flat 使用 thenCompose 把后续阶段连接起来,调用者读取一次即可。combined 则拿到两个结果后求和。

怎样选择方法

需求方法回调返回什么
把已有结果转换为另一个值thenApply普通值
上一步结果决定下一次异步请求thenComposeCompletionStage
等两个阶段都成功后组合结果thenCombine普通值

这里的结果依赖不等于每一步都创建新线程。非 Async 回调可能由完成上一步的线程执行;需要明确隔离阻塞任务时,传入合适的执行器,并处理容量、拒绝和超时。没有显式执行器的异步调用也不能一概理解成业务专用线程池。

join() 在示例主线程收集结果;如果在同一个小线程池的任务里等待由该池执行的后续任务,可能造成等待链和资源饥饿。本文未模拟 HTTP/RPC,也未验证性能。

来源与继续学习

原资料的原作者与原始链接待确认。本站新增了完整类型声明、执行器关闭和确定输出;API 语义按 JDK 21 文档核对。

继续看异常、超时与取消,并结合线程池关闭理解任务的生命周期。