在 java 中使用 completablefuture 的 whencomplete 方法记录日志,核心在于利用其提供的异常上下文。该方法接收一个 biconsumer,同时传入计算结果和可能发生的异常对象。通过判断异常是否为空,可以分别记录成功时的耗时或数据,以及失败时的堆栈信息,且不会中断原有的异步执行链。

如何获取任务执行耗时并记录成功日志
要记录任务的执行耗时,需要在任务开始前记录时间戳,并在 whenComplete 中计算差值。由于 whenComplete 是同步执行的回调,直接在这里进行简单的减法运算即可得到毫秒级的耗时。这种方式适用于需要监控接口响应时间的场景,能够准确反映从提交到完成的全过程。

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.TimeUnit;
public class LogExample {
public static void main(String[] args) throws Exception {
long startTime = System.currentTimeMillis();
CompletableFuture<string> future = CompletableFuture.supplyAsync(() -> {
try {
TimeUnit.SECONDS.sleep(1);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
return "Success";
});
future.whenComplete((result, ex) -> {
long duration = System.currentTimeMillis() - startTime;
if (ex == null) {
System.out.println("[SUCCESS] Result: " + result + ", Duration: " + duration + "ms");
} else {
System.out.println("[FAILED] Error occurred.");
}
});
// 阻塞主线程等待结果
future.join();
}
}</string>
如何在发生异常时捕获并记录错误详情
当异步任务抛出异常时,whenComplete 的第二个参数 ex 将不为空。此时可以通过 ex.printStackTrace() 或日志框架(如 SLF4J)记录详细的错误堆栈。与 exceptionally 不同,whenComplete 不会吞掉异常,也不会改变返回的 CompletableFuture 状态,它仅仅是一个观察点,非常适合用于全局的错误审计。

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.TimeUnit;
public class ErrorLogExample {
public static void main(String[] args) throws Exception {
CompletableFuture<string> future = CompletableFuture.supplyAsync(() -> {
throw new RuntimeException("Simulated Failure");
});
future.whenComplete((result, ex) -> {
if (ex != null) {
System.err.println("[ERROR] Task failed with exception: " + ex.getMessage());
ex.printStackTrace();
} else {
System.out.println("[INFO] Task completed with result: " + result);
}
});
// 注意:join() 会重新抛出异常,这里仅用于演示流程
try {
future.join();
} catch (Exception e) {
// 主线程处理最终异常
}
}
}</string>
基于 whenComplete 返回值类型的具体问题
whenComplete 方法的返回值依然是原来的 CompletableFuture 实例,这意味着它可以被链式调用。如果需要在记录日志后继续处理结果,可以直接在 whenComplete 之后调用 thenApply 或 thenAccept。这一点区别于 handle 方法,后者允许你转换返回值,而 whenComplete 严格保持原样,适合纯副作用操作如日志记录。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











