Module java.base

Package java.util.concurrent

Interface StructuredTaskScope.Subtask<T>

类型参数:

T - 结果类型

所有超接口:

Supplier<T>

封闭类:

StructuredTaskScope预览<T>

       public static sealed interface StructuredTaskScope.Subtask<T> extends Supplier<T>
      

Subtask 是 Java 平台的预览 API。

仅当启用预览功能时，程序才能使用 Subtask。

预览功能可能会在将来的版本中被移除，或升级为 Java 平台的永久功能。

代表使用 StructuredTaskScope.fork(Callable)^预览 分叉的子任务。

自:

21

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	StructuredTaskScope.Subtask.StatePREVIEW	预览。 代表子任务的状态。

Method Summary

Modifier and Type	Method	Description
Throwable	exception()	返回子任务抛出的异常。
T	get()	返回子任务的结果。
StructuredTaskScope.Subtask.StatePREVIEW	state()	返回子任务的状态。
Callable<? extends T>	task()	返回提供给 fork 方法的返回值任务。

Method Details

task

             Callable<? extends T> task()
            

返回提供给 fork 方法的返回值任务。

API 注释:

具有唯一标识的任务对象可用于由 handleComplete^预览 的实现进行关联。

返回:

提供给 fork 方法的返回值任务

state

             StructuredTaskScope.Subtask.StatePREVIEW state()
            

返回子任务的状态。

返回:

子任务的状态

get

             T get()
            

返回子任务的结果。

为确保正确使用，如果作用域所有者 分叉^预览 一个子任务，那么它必须在获取子任务的结果之前（使用 join^预览 或 joinUntil^预览）加入。

指定者:

get 在接口 Supplier<T>

返回:

可能为 null 的结果

抛出:

IllegalStateException - 如果子任务尚未完成，未成功完成，或当前线程是任务作用域所有者且在分叉后未加入

参见:

• StructuredTaskScope.Subtask.State.SUCCESS^预览

exception

             Throwable exception()
            

返回子任务抛出的异常。

为确保正确使用，如果作用域所有者 分叉^预览 一个子任务，那么它必须在获取子任务抛出的异常之前（使用 join^预览 或 joinUntil^预览）加入。

返回:

子任务抛出的异常

抛出:

IllegalStateException - 如果子任务尚未完成，已完成并返回结果，或当前线程是任务作用域所有者且在分叉后未加入

参见:

• StructuredTaskScope.Subtask.State.FAILED^预览