CompletableFuture是Java异步编程核心工具，支持非阻塞任务执行与链式调用。通过runAsync/supplyAsync启动异步任务，默认使用ForkJoinPool.commonPool()，可自定义线程池。thenApply/thenAccept/thenRun实现结果转换、消费与后续操作。thenCombine/allOf/anyOf用于组合多个任务。exceptionally/handle处理异常，避免阻塞主线程，提升IO密集型场景性能。
Java中的CompletableFuture是实现异步编程的核心工具之一，它不仅支持非阻塞的任务执行，还能通过链式调用组合多个异步操作。相比传统的Future，它提供了更丰富的API来处理回调、异常和任务编排。
创建异步任务
使用CompletableFuture的第一步是启动一个异步任务。可以通过runAsync或supplyAsync方法实现。
- supplyAsync：用于有返回值的异步任务。
默认情况下，这些方法使用ForkJoinPool.commonPool()执行任务，也可以传入自定义线程池以更好控制资源。
示例：
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
CompletableFuture<Void> future = CompletableFuture.runAsync(() -> {<br>
System.out.println("任务正在执行");<br>
});
CompletableFuture<String> result = CompletableFuture.supplyAsync(() -> {<br>
return "异步结果";<br>
});
链式调用与结果处理
通过thenApply、thenAccept和thenRun等方法，可以在前一个任务完成后执行后续操作。
- thenApply：接收上一步结果并返回新值，适合转换数据。- thenAccept：消费结果但不返回值，适合打印日志或存储。
- thenRun：不接收参数，仅在前任务完成后运行。
示例：
立即学习“Java免费学习笔记（深入）”；
CompletableFuture<String> step1 = CompletableFuture.supplyAsync(() -> "Hello");<br>
CompletableFuture<Integer> step2 = step1.thenApply(String::length);<br>
step2.thenAccept(len -> System.out.println("长度：" + len));
组合多个异步任务
当需要并行执行多个任务并合并结果时，可以使用thenCombine、allOf或anyOf。
- allOf：等待所有任务完成（注意返回类型是CompletableFuture[]）。
- anyOf：任一任务完成即触发回调。
示例：
立即学习“Java免费学习笔记（深入）”；
CompletableFuture<String> f1 = CompletableFuture.supplyAsync(() -> "A");<br> CompletableFuture<String> f2 = CompletableFuture.supplyAsync(() -> "B");<br> f1.thenCombine(f2, (a, b) -> a + b).thenAccept(System.out::println);
异常处理机制
异步任务中发生异常不会立即抛出，需通过exceptionally或handle方法捕获。
- handle：无论是否异常都会执行，可用于统一处理结果和错误。
示例：
立即学习“Java免费学习笔记（深入）”；
CompletableFuture.supplyAsync(() -> {<br>
if (true) throw new RuntimeException("出错了");<br>
return "success";<br>
}).exceptionally(ex -> {<br>
System.out.println("错误：" + ex.getMessage());<br>
return "fallback";<br>
});
基本上就这些。合理使用CompletableFuture能显著提升程序响应性和吞吐量，尤其是在IO密集型或远程调用场景中。关键是避免阻塞主线程，同时注意线程池配置以防资源耗尽。不复杂但容易忽略。
