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

型パラメータ:
T - 結果の型
すべてのスーパー・インタフェース:
Supplier<T>
含まれているインタフェース:
StructuredTaskScopePREVIEW<T,R>
public static sealed interface StructuredTaskScope.Subtask<T> extends Supplier<T>
Subtaskは、JavaプラットフォームのプレビューAPIです。
プレビュー機能が有効な場合のみ、プログラムでSubtaskを使用できます。
プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。
StructuredTaskScope.fork(Callable)PREVIEWまたはStructuredTaskScope.fork(Runnable)PREVIEWでフォークされたサブタスクを表します。

サブタスクをフォークするコードは、get()メソッドを結合PREVIEW後に使用して、正常に完了したサブタスクの結果を取得できます。 exception()メソッドを使用して、失敗したサブタスクによってスローされた例外を取得できます。

導入されたバージョン:
21

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

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    Throwable
    exception()
    失敗した場合、このサブタスクによってスローされた例外またはエラーを返します。
    T
    get()
    このサブタスクが正常に完了した場合、結果を返します。
    StructuredTaskScope.Subtask.StatePREVIEW
    state()
    サブタスク状態を返します。

  • メソッドの詳細

    • state

      StructuredTaskScope.Subtask.StatePREVIEW state()
      サブタスク状態を返します。
      戻り値:
      サブタスクの状態

    • get

      T get()
      このサブタスクが正常に完了した場合、結果を返します。 サブタスクがfork(Callable)PREVIEWでフォークされた場合は、callメソッドの結果が返されます。 サブタスクがfork(Runnable)PREVIEWでフォークされた場合は、nullが返されます。

      スコープ所有者スレッドで実行されているコードは、このメソッドを使用して、成功したサブタスクの結果を結合PREVIEWした後にのみ取得できます。

      Joiner onCompletePREVIEWメソッドで実行されているコードは、このメソッドを使用して結果を取得する前に、サブタスク状態がSUCCESSPREVIEWであることをテストする必要があります。

      定義:
      インタフェースSupplier<T>内のget
      戻り値:
      NULLの可能性がある結果
      スロー:
      IllegalStateException - サブタスクが完了していない場合、正常に完了しなかった場合、または現在のスレッドが結合PREVIEWの前にこのメソッドを起動するスコープ所有者である場合
      関連項目:

    • exception

      Throwable exception()
      失敗した場合、このサブタスクによってスローされた例外またはエラーを返します。 サブタスクがfork(Callable)PREVIEWでフォークされた場合は、callメソッドによってスローされた例外またはエラーが返されます。 サブタスクがfork(Runnable)PREVIEWでフォークされた場合は、runメソッドによってスローされた例外またはエラーが返されます。

      スコープ所有者スレッドで実行されているコードは、このメソッドを使用して、失敗したサブタスクによってスローされた例外を結合PREVIEWした後にのみ取得できます。

      Joiner onCompletePREVIEWメソッドで実行されているコードは、このメソッドを使用して例外を取得する前に、サブタスク状態がFAILEDPREVIEWであることをテストする必要があります。

      戻り値:
      失敗した場合、このサブタスクによってスローされる例外またはエラー
      スロー:
      IllegalStateException - サブタスクが完了していない場合、結果で完了した場合、または現在のスレッドが、結合PREVIEWの前にこのメソッドを起動するスコープ所有者である場合
      関連項目: