Class AsyncUtil
java.lang.Object
com.sure.tool.thread.AsyncUtil
虚拟线程一等公民的异步门面。
默认全部使用虚拟线程执行,无需手动构造线程池;同时提供
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
-
Method Summary
Modifier and TypeMethodDescriptionstatic <T> CompletableFuture<List<T>> 并行全部完成(失败取消其余并传播首个异常,等价结构化并发语义)。static <T> CompletableFuture<T> 首个成功即返回(其余任务被取消)。static <T> T限时等待 Future 并解包ExecutionException(保留原始 cause)。static <T> List<T> 限时并行聚合(全部完成后返回,任一失败取消其余)。static Future<?> 虚拟线程异步执行(fire-and-forget)。static Future<?> 指定执行器异步执行(fire-and-forget)。static <T> CompletableFuture<T> supplyAsync(Supplier<T> supplier) 虚拟线程异步供应值。static <T> TwithTimeout(Duration timeout, Supplier<T> supplier) 限时供应:超时抛TimeoutException。
-
Method Details
-
runAsync
虚拟线程异步执行(fire-and-forget)。- Parameters:
runnable- 任务- Returns:
- Future(异常经
Future.get()传播)
-
runAsync
指定执行器异步执行(fire-and-forget)。- Parameters:
runnable- 任务executor- 执行器- Returns:
- Future(异常经
Future.get()传播)
-
supplyAsync
虚拟线程异步供应值。- Type Parameters:
T- 结果泛型- Parameters:
supplier- 供应器- Returns:
- CompletableFuture(异常经
CompletableFuture.get()传播)
-
allOf
并行全部完成(失败取消其余并传播首个异常,等价结构化并发语义)。- Type Parameters:
T- 结果泛型- Parameters:
tasks- 任务列表- Returns:
- 按输入顺序排列的结果 CompletableFuture
-
anyOf
首个成功即返回(其余任务被取消)。- Type Parameters:
T- 结果泛型- Parameters:
tasks- 任务列表- Returns:
- 首个成功结果 CompletableFuture;全部失败则异常
-
withTimeout
public static <T> T withTimeout(Duration timeout, Supplier<T> supplier) throws TimeoutException, ExecutionException, InterruptedException 限时供应:超时抛TimeoutException。- Type Parameters:
T- 结果泛型- Parameters:
timeout- 超时supplier- 供应器- Returns:
- 供应值
- Throws:
TimeoutException- 超时ExecutionException- 任务异常InterruptedException- 线程中断
-
await
public static <T> T await(Duration timeout, Future<T> future) throws TimeoutException, ExecutionException, InterruptedException 限时等待 Future 并解包ExecutionException(保留原始 cause)。- Type Parameters:
T- 结果泛型- Parameters:
timeout- 超时future- Future- Returns:
- 结果
- Throws:
TimeoutException- 超时ExecutionException- 任务异常(cause 为真实异常)InterruptedException- 线程中断
-
joinAll
@SafeVarargs public static <T> List<T> joinAll(Duration timeout, Callable<T>... tasks) throws TimeoutException, ExecutionException, InterruptedException 限时并行聚合(全部完成后返回,任一失败取消其余)。- Type Parameters:
T- 结果泛型- Parameters:
timeout- 总超时tasks- 任务列表- Returns:
- 按输入顺序排列的结果列表
- Throws:
TimeoutException- 超时ExecutionException- 首个任务异常InterruptedException- 线程中断
-