completablefuture 的 completeontimeout 方法用于在指定时间内未完成时自动填充默认值。调用该实例方法并传入超时时间和 executor,即可返回一个包含后备值的异步任务。

completeOnTimeout 如何设置默认值
该方法通过链式调用绑定一个后备值,当原始任务未在限定时间内完成时,新任务将使用此值结束。需要提供一个 Executor 来调度超时检查逻辑,否则无法触发超时机制。

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;
public class Main {
public static void main(String[] args) throws Exception {
CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(2000); } catch (InterruptedException e) {}
return "Success";
});
CompletableFuture<String> withTimeout = future.completeOnTimeout("Default", 500, Executors.newSingleThreadExecutor());
System.out.println(withTimeout.get());
}
}
预期输出:
Default
立即学习“Java免费学习笔记(深入)”;
completeOnTimeout 与异常处理的区别
如果希望超时后抛出特定异常而非返回默认值,应使用 orTimeout 方法。两者都依赖外部执行器进行时间监控,但返回值类型和后续处理逻辑不同。

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeoutException;
public class Main {
public static void main(String[] args) throws Exception {
CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(2000); } catch (InterruptedException e) {}
return "Success";
});
try {
future.orTimeout(500, TimeUnit.MILLISECONDS).get();
} catch (Exception e) {
System.out.println(e.getClass().getSimpleName());
}
}
}
预期输出:
TimeoutException
超时后默认值是否影响原任务状态
超时触发的默认值仅作用于新创建的 CompletableFuture 实例,原始任务仍在后台继续运行直至完成或中断。原任务的状态变更不会反向影响已完成的超时结果对象。


















