モジュール java.base

パッケージ java.util.concurrent

インタフェースStructuredTaskScope.Subtask<T>

型パラメータ:

T - 結果の型

すべてのスーパー・インタフェース:

Supplier<T>

含まれているクラス:

StructuredTaskScopePREVIEW<T>

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

Subtaskは、JavaプラットフォームのプレビューAPIです。

プレビュー機能が有効な場合のみ、プログラムでSubtaskを使用できます。

プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。

StructuredTaskScope.fork(Callable)^PREVIEWでフォークされたサブタスクを表します。

導入されたバージョン:

21

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	インタフェース	説明
static enum	StructuredTaskScope.Subtask.StatePREVIEW	Preview. サブタスクの状態を表します。

メソッドのサマリー

修飾子と型	メソッド	説明
Throwable	exception()	サブタスクによってスローされた例外を返します。
T	get()	サブタスクの結果を返します。
StructuredTaskScope.Subtask.StatePREVIEW	state()	サブタスクの状態を返します。
Callable<? extends T>	task()	forkメソッドに指定されたタスクを返す値を返します。

メソッドの詳細

task

Callable<? extends T> task()

forkメソッドに指定されたタスクを返す値を返します。

APIのノート:

一意のアイデンティティを持つタスク・オブジェクトは、handleComplete^PREVIEWの実装による相関に使用できます。

戻り値:

forkメソッドに指定されたタスクを返す値

state

StructuredTaskScope.Subtask.StatePREVIEW state()

サブタスクの状態を返します。

戻り値:

サブタスクの状態

get

T get()

サブタスクの結果を返します。

正しい使用を確実にするために、スコープ所有者がサブタスクを「フォーク」^PREVIEWする場合、サブタスクの結果を取得する前に(join^PREVIEWまたはjoinUntil^PREVIEW)を結合する必要があります。

定義:

インタフェースSupplier<T>内のget

戻り値:

NULLの可能性がある結果

例外:

IllegalStateException - サブタスクが完了していないか、正常に完了しなかったか、現在のスレッドがタスク・スコープの所有者であり、フォーク後に結合しなかった場合

関連項目:

• StructuredTaskScope.Subtask.State.SUCCESS^PREVIEW

exception

Throwable exception()

サブタスクによってスローされた例外を返します。

正しい使用を確実にするために、スコープ所有者がサブタスクを「フォーク」^PREVIEWする場合、サブタスクによってスローされた例外を取得するには、(join^PREVIEWまたはjoinUntil^PREVIEW)を結合する必要があります。

戻り値:

サブタスクによってスローされた例外

例外:

IllegalStateException - サブタスクが完了していないか、結果で完了したか、現在のスレッドがタスク・スコープの所有者で、フォーク後に結合しなかった場合

関連項目:

• StructuredTaskScope.Subtask.State.FAILED^PREVIEW