Class StructuredTaskUtil
java.lang.Object
com.sure.tool.thread.StructuredTaskUtil
结构化并发工具类:扇出-聚合、首成功短路与限时编排。
本类基于虚拟线程池 + 任务取消实现结构化语义:
- 扇出-聚合:
parallel(Callable...)并发执行全部任务,任一失败即取消其余并传播异常; - 首成功短路:
anyOf(Callable...)返回第一个成功的结果,其余任务被取消; - 限时编排:两种模式均支持整体超时,超时自动取消未完成任务;
- 所有任务在虚拟线程上执行,可承载高扇出并发。
注意:JDK 21 的 StructuredTaskScope 仍为 preview API,不适合发布制品;
本类以稳定 API 提供等价语义,待 JDK 24+ 正式化后可在内部平滑迁移实现。
- Since:
- 1.1.0
-
Method Summary
Modifier and TypeMethodDescriptionstatic <T> T限时并发执行全部任务,返回第一个成功的结果(varargs 便捷重载); 超时或全部失败均抛出RuntimeException。static <T> TanyOf(Collection<Callable<T>> tasks, Duration timeout) static <T> Tstatic <T> List<T> 限时并发执行全部任务(varargs 便捷重载):在指定时间内全部成功则按输入顺序返回结果; 超时或任一任务失败均取消未完成任务并抛出RuntimeException。static <T> List<T> parallel(Collection<Callable<T>> tasks) 并发执行全部任务,全部成功后按输入顺序返回结果;任一任务失败则取消其余任务, 并抛出RuntimeException(携带任务异常)。static <T> List<T> parallel(Collection<Callable<T>> tasks, Duration timeout) 限时并发执行全部任务:在指定时间内全部成功则按输入顺序返回结果; 超时或任一任务失败均取消未完成任务并抛出RuntimeException。static <T> List<T> 并发执行全部任务,全部成功后按输入顺序返回结果;任一任务失败则取消其余任务, 并抛出RuntimeException(携带任务异常)。
-
Method Details
-
parallel
并发执行全部任务,全部成功后按输入顺序返回结果;任一任务失败则取消其余任务, 并抛出RuntimeException(携带任务异常)。- Type Parameters:
T- 任务返回类型- Parameters:
tasks- 任务列表,不允许包含null- Returns:
- 按输入顺序排列的结果列表
-
parallel
并发执行全部任务,全部成功后按输入顺序返回结果;任一任务失败则取消其余任务, 并抛出RuntimeException(携带任务异常)。- Type Parameters:
T- 任务返回类型- Parameters:
tasks- 任务集合,可为空- Returns:
- 按输入顺序排列的结果列表;输入为空时返回空列表
-
parallel
限时并发执行全部任务:在指定时间内全部成功则按输入顺序返回结果; 超时或任一任务失败均取消未完成任务并抛出RuntimeException。- Type Parameters:
T- 任务返回类型- Parameters:
tasks- 任务集合,可为空timeout- 整体执行时限,null表示不限时- Returns:
- 按输入顺序排列的结果列表;输入为空时返回空列表
-
parallel
限时并发执行全部任务(varargs 便捷重载):在指定时间内全部成功则按输入顺序返回结果; 超时或任一任务失败均取消未完成任务并抛出RuntimeException。- Type Parameters:
T- 任务返回类型- Parameters:
timeout- 整体执行时限,null表示不限时tasks- 任务列表- Returns:
- 按输入顺序排列的结果列表
-
anyOf
-
anyOf
限时并发执行全部任务,返回第一个成功的结果(varargs 便捷重载); 超时或全部失败均抛出RuntimeException。- Type Parameters:
T- 任务返回类型- Parameters:
timeout- 整体执行时限,null表示不限时tasks- 任务列表- Returns:
- 第一个成功任务的结果
-
anyOf
-