在 completionstage 的超时控制中,通常使用 ortimeout() 方法配合 completablefuture 实现。具体做法是调用 tocompletablefuture().ortimeout(duration, unit),它会返回一个新的 completionstage,若原阶段未在指定时间内完成,则抛出 timeoutexception。这属于非阻塞式超时,不会中断底层线程,仅标记状态。

如何捕获超时异常并处理?
通过 exceptionally() 或 handle() 可以捕获 TimeoutException。推荐使用 exceptionally() 返回默认值或重试逻辑,保持链式调用简洁。

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.TimeUnit;
public class TimeoutExample {
public static void main(String[] args) {
CompletableFuture<string> future = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(2000); } catch (InterruptedException e) {}
return "Done";
});
String result = future
.toCompletableFuture()
.orTimeout(1, TimeUnit.SECONDS)
.exceptionally(ex -> ex instanceof java.util.concurrent.TimeoutException ? "Timed out" : "Error")
.join();
System.out.println(result);
}
}
</string>
超时后是否影响原任务执行?
是的,orTimeout() 不取消原任务,原线程继续运行直到完成。若需彻底终止,需结合 cancel(true) 或使用 ExecutorService 提交任务。

import java.util.concurrent.*;
public class CancelOnTimeout {
public static void main(String[] args) throws Exception {
ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<string> future = new CompletableFuture();
executor.submit(() -> {
try { Thread.sleep(5000); future.complete("Done"); } catch (InterruptedException e) {
System.out.println("Task interrupted");
}
});
Thread.sleep(1000);
future.cancel(true);
executor.shutdownNow();
}
}
</string>
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











