Class StructuredTaskUtil

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

public final class StructuredTaskUtil extends Object
结构化并发工具类:扇出-聚合、首成功短路与限时编排。

本类基于虚拟线程池 + 任务取消实现结构化语义:

  • 扇出-聚合:parallel(Callable...) 并发执行全部任务,任一失败即取消其余并传播异常;
  • 首成功短路:anyOf(Callable...) 返回第一个成功的结果,其余任务被取消;
  • 限时编排:两种模式均支持整体超时,超时自动取消未完成任务;
  • 所有任务在虚拟线程上执行,可承载高扇出并发。

注意:JDK 21 的 StructuredTaskScope 仍为 preview API,不适合发布制品; 本类以稳定 API 提供等价语义,待 JDK 24+ 正式化后可在内部平滑迁移实现。

Since:
1.1.0
  • Method Details

    • parallel

      @SafeVarargs public static <T> List<T> parallel(Callable<T>... tasks)
      并发执行全部任务,全部成功后按输入顺序返回结果;任一任务失败则取消其余任务, 并抛出 RuntimeException(携带任务异常)。
      Type Parameters:
      T - 任务返回类型
      Parameters:
      tasks - 任务列表,不允许包含 null
      Returns:
      按输入顺序排列的结果列表
    • parallel

      public static <T> List<T> parallel(Collection<Callable<T>> tasks)
      并发执行全部任务,全部成功后按输入顺序返回结果;任一任务失败则取消其余任务, 并抛出 RuntimeException(携带任务异常)。
      Type Parameters:
      T - 任务返回类型
      Parameters:
      tasks - 任务集合,可为空
      Returns:
      按输入顺序排列的结果列表;输入为空时返回空列表
    • parallel

      public static <T> List<T> parallel(Collection<Callable<T>> tasks, Duration timeout)
      限时并发执行全部任务:在指定时间内全部成功则按输入顺序返回结果; 超时或任一任务失败均取消未完成任务并抛出 RuntimeException。
      Type Parameters:
      T - 任务返回类型
      Parameters:
      tasks - 任务集合,可为空
      timeout - 整体执行时限,null 表示不限时
      Returns:
      按输入顺序排列的结果列表;输入为空时返回空列表
    • parallel

      @SafeVarargs public static <T> List<T> parallel(Duration timeout, Callable<T>... tasks)
      限时并发执行全部任务(varargs 便捷重载):在指定时间内全部成功则按输入顺序返回结果; 超时或任一任务失败均取消未完成任务并抛出 RuntimeException。
      Type Parameters:
      T - 任务返回类型
      Parameters:
      timeout - 整体执行时限,null 表示不限时
      tasks - 任务列表
      Returns:
      按输入顺序排列的结果列表
    • anyOf

      @SafeVarargs public static <T> T anyOf(Callable<T>... tasks)
    • anyOf

      @SafeVarargs public static <T> T anyOf(Duration timeout, Callable<T>... tasks)
      限时并发执行全部任务,返回第一个成功的结果(varargs 便捷重载); 超时或全部失败均抛出 RuntimeException。
      Type Parameters:
      T - 任务返回类型
      Parameters:
      timeout - 整体执行时限,null 表示不限时
      tasks - 任务列表
      Returns:
      第一个成功任务的结果
    • anyOf

      public static <T> T anyOf(Collection<Callable<T>> tasks, Duration timeout)