CompletableFuture.allOf用于等待多个异步任务全部完成但不返回结果，需手动调用join()获取各任务结果；它不传播异常，任一任务异常时allOf仍完成，须显式检查异常状态。
CompletableFuture.allOf 是 Java 中等待多个异步任务**全部完成**（不关心结果）的便捷方式，但它本身不返回结果集合，需额外处理才能获取每个任务的返回值。
allOf 的基本用法：只等完成，不取结果
它接收一个 CompletableFuture[]，返回一个新的 CompletableFuture<void></void>，当所有入参任务都完成（无论成功或异常）时，该 future 才完成。
⚠️ 注意：如果任意一个任务抛出异常，allOf 对应的 future 仍会“完成”，但不会主动传播异常；调用 join() 或 get() 时才可能抛出 CompletionException（包装了原始异常）。
示例：
立即学习“Java免费学习笔记（深入）”；
CompletableFuture<String> task1 = CompletableFuture.supplyAsync(() -> {
sleep(1000); return "A";
});
CompletableFuture<Integer> task2 = CompletableFuture.supplyAsync(() -> {
sleep(800); return 42;
});
CompletableFuture<Void> allDone = CompletableFuture.allOf(task1, task2);
allDone.join(); // 阻塞等待两个都完成
// 此时 task1 和 task2 已完成，可安全 get 结果
System.out.println(task1.join()); // "A"
System.out.println(task2.join()); // 42
获取所有任务的结果：需要手动 collect
allOf 不提供结果聚合，常见做法是先收集 futures 到列表，再用 allOf 等待，最后遍历调用 join() 或 get() 提取结果。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
推荐写法（类型安全、避免强制转换）：
- 用泛型通配符声明
List<completablefuture>></completablefuture>存储不同返回类型的 future - 调用
allOf(futures.toArray(new CompletableFuture[0])) - 再统一
stream().map(CompletableFuture::join).collect(...)
List<CompletableFuture<?>> futures = Arrays.asList(
CompletableFuture.supplyAsync(() -> "hello"),
CompletableFuture.supplyAsync(() -> 123),
CompletableFuture.supplyAsync(() -> true)
);
CompletableFuture.allOf(futures.toArray(new CompletableFuture[0])).join();
List<Object> results = futures.stream()
.map(CompletableFuture::join)
.collect(Collectors.toList());
更优雅的方式：用 thenCombine 或自定义组合工具
若任务数量固定且类型明确（如都是 String），可链式组合：
CompletableFuture<String> a = ...;
CompletableFuture<String> b = ...;
CompletableFuture<String> c = ...;
CompletableFuture<List<String>> allResult =
a.thenCombine(b, (s1, s2) -> Arrays.asList(s1, s2))
.thenCombine(c, (list, s3) -> {
List<String> result = new ArrayList<>(list);
result.add(s3);
return result;
});
但这种方式随任务数增加变得冗长。生产中更建议封装一个通用工具方法：
public static <T> CompletableFuture<List<T>> allOfList(List<CompletableFuture<T>> futures) {
return CompletableFuture.allOf(futures.toArray(new CompletableFuture[0]))
.thenApply(v -> futures.stream()
.map(CompletableFuture::join)
.collect(Collectors.toList()));
}
异常处理不能靠 allOf 自动兜底
allOf 完成 ≠ 所有任务都成功。某个任务失败会导致其 future 进入异常完成状态，但 allOf 仍会完成。必须显式检查每个 future 的状态：
- 用
isCompletedExceptionally()判断是否异常结束 - 或统一用
handle((r, t) -> t != null ? fallback : r)做容错 - 也可在提交任务时统一加异常捕获：
supplyAsync(...).exceptionally(e -> null)
否则直接 join() 可能抛出未处理异常，中断后续逻辑。
