インタフェースStructuredTaskScope.Configuration

含まれているインタフェース:
StructuredTaskScopePREVIEW<T,R>
パブリック静的シール済インタフェースStructuredTaskScope.Configuration
Configurationは、JavaプラットフォームのプレビューAPIです。
プレビュー機能が有効になっている場合のみ、プログラムでConfigurationを使用できます。
プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。
StructuredTaskScopeの構成を表します。

StructuredTaskScopeの構成は、スレッドを作成するためのThreadFactory、監視および管理を目的としたオプションの名前、およびオプションのタイムアウトで構成されます。

StructuredTaskScope.open()PREVIEWまたはStructuredTaskScope.open(Joiner)PREVIEWを使用してStructuredTaskScopeを作成するには、デフォルト構成を使用します。 デフォルトの構成は、名前のない仮想スレッドを作成するスレッド・ファクトリ、監視および管理目的の名前なし、タイムアウトなしで構成されます。

StructuredTaskScopeを2つの引数openPREVIEWメソッドで作成すると、異なる構成を使用できます。 openメソッドに指定された関数は、デフォルトの構成に適用され、作成中のStructuredTaskScopeの構成を返します。 このファンクションは、ここで定義したwith-接頭辞付きメソッドを使用して、使用する構成のコンポーネントを指定できます。

特に指定しないかぎり、このクラスのメソッドにnull引数を渡すと、NullPointerExceptionがスローされます。

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

  • メソッドの詳細

    • withThreadFactory

      StructuredTaskScope.ConfigurationPREVIEW withThreadFactory(ThreadFactory threadFactory)
      指定されたスレッド・ファクトリを持つ新しいConfigurationオブジェクトを返します。 他のコンポーネントは、このオブジェクトと同じです。 スレッド・ファクトリは、フォークPREVIEWサブタスク時にスレッドを作成するためにスコープで使用されます。
      APIのノート:
      スレッド・ファクトリは通常、仮想スレッドを作成します。監視目的の名前、捕捉されない例外ハンドラ、またはその他のプロパティが構成されている場合もあります。
      パラメータ:
      threadFactory - スレッド・ファクトリ
      戻り値:
      指定されたスレッド・ファクトリを持つ新しいConfigurationオブジェクト
      関連項目:

    • withName

      StructuredTaskScope.ConfigurationPREVIEW withName(String name)
      指定された名前を持つ新しいConfigurationオブジェクトを返します。 他のコンポーネントは、このオブジェクトと同じです。 スコープには、オプションで監視および管理の目的の名前が付けられます。
      パラメータ:
      name - 名前
      戻り値:
      指定された名前の新しいConfigurationオブジェクト

    • withTimeout

      StructuredTaskScope.ConfigurationPREVIEW withTimeout(Duration timeout)
      指定されたタイムアウトを持つ新しいConfigurationオブジェクトを返します。 他のコンポーネントは、このオブジェクトと同じです。
      APIのノート:
      期限(Instant)を使用するアプリケーションでは、Duration.between(Instant.now(), deadline)を使用してこのメソッドのタイムアウトを計算できます。
      パラメータ:
      timeout - タイムアウト
      戻り値:
      指定されたタイムアウトを持つ新しいConfigurationオブジェクト
      関連項目: