Module java.base
Package java.util.concurrent

Class StructuredTaskScope.ShutdownOnSuccess<T>

java.lang.Object
java.util.concurrent.StructuredTaskScopePREVIEW<T>
java.util.concurrent.StructuredTaskScope.ShutdownOnSuccess<T>
类型参数:
T - 结果类型
所有实现的接口:
AutoCloseable
封闭类:
StructuredTaskScope预览<T>
public static final class StructuredTaskScope.ShutdownOnSuccess<T> extends StructuredTaskScopePREVIEW<T>
ShutdownOnSuccess 是 Java 平台的预览 API。
仅当启用预览功能时，程序才能使用 ShutdownOnSuccess。
预览功能可能在将来的版本中被移除，或升级为 Java 平台的永久功能。
捕获第一个子任务成功完成的结果的 StructuredTaskScope。一旦捕获，它会 关闭预览 任务范围以中断未完成的线程并唤醒任务范围所有者。此类实现的策略适用于任何子任务的结果都可以的情况（"调用任何"），并且不再需要其他未完成子任务的结果的情况。

除非另有说明，在此类中向方法传递 null 参数将导致抛出 NullPointerException。

API 注意:
此类实现了一个策略，当子任务成功完成时关闭任务范围。不应该使用 shutdown预览 方法直接关闭任务范围。
自 JDK 版本:
21

  • Constructor Details

    • ShutdownOnSuccess

      public ShutdownOnSuccess(String name, ThreadFactory factory)
      使用给定的名称和线程工厂构造一个新的 ShutdownOnSuccess。任务范围可选地用于监视和管理目的命名。线程工厂用于在子任务被 forked预览 时创建线程。任务范围由当前线程拥有。

      构造函数捕获当前线程的 scoped value预览 绑定，以便在任务范围内启动的线程继承。类描述中的 树结构 部分详细说明了为了继承 scoped value 绑定而隐式建立父子关系的方式。

      参数:
      name - 任务范围的名称，可以为 null
      factory - 线程工厂

    • ShutdownOnSuccess

      public ShutdownOnSuccess()
      构造一个新的未命名的 ShutdownOnSuccess，创建虚拟线程。
      实现要求:
      此构造函数等效于使用名称为 null 和创建虚拟线程的线程工厂调用 2-参数构造函数。

  • Method Details