whencomplete是completablefuture提供的回调方法，用于任务无论成功或失败后执行统一收尾操作；它接收biconsumer参数，不改变结果也不参与链式传递，适合日志、资源清理等副作用处理。
whenComplete 是 Java CompletableFuture 提供的一个回调方法，用于在异步任务执行**无论成功或失败**后执行监听逻辑，适合做统一收尾处理（如资源清理、日志记录、状态更新等）。
whenComplete 的基本用法
它接收一个 BiConsumer<t throwable></t> 参数：第一个参数是正常结果（成功时为计算值，失败时为 null），第二个参数是异常（成功时为 null）。注意：它不改变原始 CompletableFuture 的结果，也不参与链式结果传递。
示例：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
CompletableFuture<string> future = CompletableFuture.supplyAsync(() -> {
// 模拟可能出错的耗时操作
if (Math.random() > 0.5) throw new RuntimeException("随机失败");
return "任务成功";
});
future.whenComplete((result, ex) -> {
if (ex != null) {
System.err.println("执行异常：" + ex.getMessage());
} else {
System.out.println("执行完成，结果：" + result);
}
});
</string>
与 handle 的关键区别
whenComplete 不返回新 CompletableFuture，也不支持修改结果；handle 可以返回新值并继续链式调用。
- whenComplete：只“看”结果，适合副作用操作（打日志、关连接、发通知），不能改变下游结果。
- handle：既能读取结果/异常，又能返回新值（或抛出异常），可用于容错兜底（比如失败时返回默认值）。
实际使用中的注意事项
需注意执行时机和线程上下文：
- 回调默认在任务完成的**同一线程**中执行（可能是 ForkJoinPool 线程，也可能是你手动
complete()的主线程），不是固定在主线程。 - 如果需要指定线程执行监听逻辑，应改用
whenCompleteAsync(..., executor)并传入自定义线程池。 - 若监听逻辑耗时或含阻塞操作，避免在无参 whenComplete 中直接写，否则可能拖慢整个 ForkJoinPool。
典型适用场景
适合不需要改变结果流、但必须响应“执行结束”这个事件的场合：
- 记录任务耗时（配合
System.nanoTime()） - 释放临时资源（如关闭临时文件句柄、清理缓存标记）
- 上报监控指标（成功数 / 失败数 / 响应时间 P99）
- 触发非关键的后续动作（如发站内信、更新 UI 状态，且不依赖任务结果）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
