completablefuture 的 completeontimeout 方法用于在指定时间内未完成时,自动填充一个默认值。调用该实例方法并传入 duration 和默认值对象即可生效,它返回一个新的 completablefuture,原任务若超时则被取消并替换为默认结果。

completeOnTimeout 如何与异步任务配合使用
该方法必须作用于已经启动或即将启动的异步任务上。通常结合 supplyAsync 使用,将耗时操作包装后链式调用超时处理逻辑。如果任务在设定时间内正常完成,则忽略默认值;只有当时间耗尽且任务仍未结束,才会触发默认值的填充。

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
public class TimeoutExample {
public static void main(String[] args) throws ExecutionException, InterruptedException {
// 模拟一个需要 3 秒才能完成的耗时任务
CompletableFuture<string> slowTask = CompletableFuture.supplyAsync(() -> {
try {
Thread.sleep(3000);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
return "Success";
});
// 设置 1 秒超时,超时后返回 "Default Value"
CompletableFuture<string> futureWithTimeout = slowTask.completeOnTimeout("Default Value", 1, TimeUnit.SECONDS);
String result = futureWithTimeout.get();
System.out.println(result); // 输出: Default Value
}
}</string></string>
超时发生时原任务的状态变化是什么
当超时条件触发时,底层会调用 cancel(true) 来中断正在执行的原任务。这意味着原任务的线程会被中断,且其计算结果不再有效。新创建的 CompletableFuture 状态变为已完成(completed),值为提供的默认参数。注意,这不会抛出异常,而是静默地用默认值替代。
Biome 是一个基于 Rust 的高性能工具链,适用于 JavaScript、TypeScript、JSX、JSON、CSS 和 GraphQL,它将格式化和 linting 统一到一个工具中。具有 97% 的 Prettier 兼容性以及超过 450 条 lint 规则,Biome 以显著更快的执行速度取代了 ESLint 和 Prettier。

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.TimeUnit;
public class CancellationCheck {
public static void main(String[] args) {
CompletableFuture<string> task = CompletableFuture.supplyAsync(() -> {
try {
Thread.sleep(5000);
} catch (InterruptedException e) {
System.out.println("Task was interrupted!");
throw new RuntimeException("Interrupted");
}
return "Done";
});
// 设置极短超时
CompletableFuture<string> limited = task.completeOnTimeout("Fallback", 100, TimeUnit.MILLISECONDS);
try {
System.out.println(limited.get());
} catch (Exception e) {
// 这里不会进入,因为 completeOnTimeout 保证了完成
}
}
}</string></string>
如果默认值是 null 会发生什么
如果传入的默认值参数为 null,completeOnTimeout 依然会成功执行,并将 CompletableFuture 的状态标记为已完成,其内部值为 null。这与 complete(null) 的行为一致。调用者获取结果时将得到 null,但不会触发 CompletionException,除非后续步骤对 null 值进行了非空检查或解引用操作。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










