Class AsyncUtil

java.lang.Object
com.sure.tool.thread.AsyncUtil

public final class AsyncUtil extends Object
虚拟线程一等公民的异步门面。

默认全部使用虚拟线程执行,无需手动构造线程池;同时提供 CompletableFuture 风格的链式异步与结构化并发语义 (并行任务任一失败即取消其余并传播首个异常;说明:JDK 25 中 StructuredTaskScope 仍为 preview API,本项目不使用,等价语义 由虚拟线程执行器 + Future 实现,与 StructuredTaskUtil 一致)。

与 StructuredTaskUtil 的区别:本类返回 CompletableFuture, 支持非阻塞链式编排;需要阻塞等待时可配合 await(Duration, Future) / joinAll(Duration, Callable...)。

使用示例:

CompletableFuture<List<String>> cf = AsyncUtil.allOf(
        () -> fetchRemote("a"),
        () -> fetchRemote("b"));
List<String> rows = AsyncUtil.await(Duration.ofSeconds(5), cf);
// 超时抛 TimeoutException;任一任务失败取消其余并传播首个异常

null 语义:任务/供应器/执行器为 null 立即 NPE;任务的 null 返回值为合法结果(不视为失败);withTimeout(Duration, Supplier) 超时抛 TimeoutException 而非返回 null。

Since:
1.12.0