クラス ThreadPoolTaskExecutorBuilder

java.lang.ObjectSE
org.springframework.boot.task.ThreadPoolTaskExecutorBuilder

public class ThreadPoolTaskExecutorBuilder extends ObjectSE
ThreadPoolTaskExecutor の構成と作成に使用できるビルダー。一般的な ThreadPoolTaskExecutor 設定を設定し、taskDecorator(TaskDecorator) を登録するための便利なメソッドを提供します。高度な設定については、ThreadPoolTaskExecutorCustomizer の使用を検討してください。

典型的な自動構成 Spring Boot アプリケーションでは、このビルダーは Bean として利用でき、ThreadPoolTaskExecutor が必要なときにいつでも注入できます。

導入:
3.2.0
作成者:
Stephane Nicoll, Filip Hrisafov
  • コンストラクターの詳細

    • ThreadPoolTaskExecutorBuilder

      public ThreadPoolTaskExecutorBuilder()
  • メソッドの詳細

    • queueCapacity

      public ThreadPoolTaskExecutorBuilder queueCapacity(int queueCapacity)
      キューの容量を設定します。無制限の容量はプールを増加させないため、maxPoolSize を無視します。
      パラメーター:
      queueCapacity - 設定するキュー容量
      戻り値:
      新しいビルダーインスタンス
    • corePoolSize

      public ThreadPoolTaskExecutorBuilder corePoolSize(int corePoolSize)
      スレッドのコア数を設定します。キューがいっぱいでない限り、事実上その最大スレッド数。

      allowCoreThreadTimeOut(boolean) が有効になっている場合、コアスレッドは拡大および縮小できます。

      パラメーター:
      corePoolSize - 設定するコアプールサイズ
      戻り値:
      新しいビルダーインスタンス
    • maxPoolSize

      public ThreadPoolTaskExecutorBuilder maxPoolSize(int maxPoolSize)
      スレッドの最大許容数を設定します。queue がいっぱいになると、プールはそのサイズまで拡張して、負荷に対応できます。

      queue capacity が無制限の場合、この設定は無視されます。

      パラメーター:
      maxPoolSize - 設定する最大プールサイズ
      戻り値:
      新しいビルダーインスタンス
    • allowCoreThreadTimeOut

      public ThreadPoolTaskExecutorBuilder allowCoreThreadTimeOut(boolean allowCoreThreadTimeOut)
      コアスレッドのタイムアウトを許可するかどうかを設定します。有効にすると、プールの動的な拡大と縮小が可能になります。
      パラメーター:
      allowCoreThreadTimeOut - コアスレッドのタイムアウトが許可されている場合
      戻り値:
      新しいビルダーインスタンス
    • keepAlive

      public ThreadPoolTaskExecutorBuilder keepAlive(DurationSE keepAlive)
      スレッドが終了する前にアイドル状態を維持できる時間制限を設定します。
      パラメーター:
      keepAlive - 設定するキープアライブ
      戻り値:
      新しいビルダーインスタンス
    • awaitTermination

      public ThreadPoolTaskExecutorBuilder awaitTermination(boolean awaitTermination)
      executor が、実行中のタスクを中断したり、キュー内のすべてのタスクを実行したりせずに、シャットダウン時にスケジュールされたタスクが完了するのを待つかどうかを設定します。
      パラメーター:
      awaitTermination - executor がシャットダウン時にタスクが完了するのを待つ必要があるかどうか
      戻り値:
      新しいビルダーインスタンス
      関連事項:
    • awaitTerminationPeriod

      public ThreadPoolTaskExecutorBuilder awaitTerminationPeriod(DurationSE awaitTerminationPeriod)
      シャットダウン時に executor がブロックする最大時間を設定します。設定すると、コンテナーの残りがシャットダウンを続ける前に、残りのタスクが実行を完了するのを待つために、executor はシャットダウン時にブロックします。これは、残りのタスクがコンテナーによって管理されている他のリソースへのアクセスを必要とする可能性がある場合に特に役立ちます。
      パラメーター:
      awaitTerminationPeriod - 設定する終了待ち期間
      戻り値:
      新しいビルダーインスタンス
    • threadNamePrefix

      public ThreadPoolTaskExecutorBuilder threadNamePrefix(StringSE threadNamePrefix)
      新しく作成されたスレッドの名前に使用する接頭辞を設定します。
      パラメーター:
      threadNamePrefix - 設定するスレッド名の接頭辞
      戻り値:
      新しいビルダーインスタンス
    • taskDecorator

      public ThreadPoolTaskExecutorBuilder taskDecorator(TaskDecorator taskDecorator)
      TaskDecorator を使用するように設定するか、null を使用しないように設定します。
      パラメーター:
      taskDecorator - 使用するタスクデコレータ
      戻り値:
      新しいビルダーインスタンス
    • customizers

      ThreadPoolTaskExecutor に適用する ThreadPoolTaskExecutorCustomizers を設定します。カスタマイザーは、ビルダー構成が適用された後に追加された順序で適用されます。この値を設定すると、以前に構成されたカスタマイザーが置き換えられます。
      パラメーター:
      customizers - 設定するカスタマイザー
      戻り値:
      新しいビルダーインスタンス
      関連事項:
    • customizers

      public ThreadPoolTaskExecutorBuilder customizers(IterableSE<? extends ThreadPoolTaskExecutorCustomizer> customizers)
      ThreadPoolTaskExecutor に適用する ThreadPoolTaskExecutorCustomizers を設定します。カスタマイザーは、ビルダー構成が適用された後に追加された順序で適用されます。この値を設定すると、以前に構成されたカスタマイザーが置き換えられます。
      パラメーター:
      customizers - 設定するカスタマイザー
      戻り値:
      新しいビルダーインスタンス
      関連事項:
    • additionalCustomizers

      public ThreadPoolTaskExecutorBuilder additionalCustomizers(ThreadPoolTaskExecutorCustomizer... customizers)
      ThreadPoolTaskExecutor に適用する必要がある ThreadPoolTaskExecutorCustomizers を追加します。カスタマイザーは、ビルダー構成が適用された後に追加された順序で適用されます。
      パラメーター:
      customizers - 追加するカスタマイザー
      戻り値:
      新しいビルダーインスタンス
      関連事項:
    • additionalCustomizers

      public ThreadPoolTaskExecutorBuilder additionalCustomizers(IterableSE<? extends ThreadPoolTaskExecutorCustomizer> customizers)
      ThreadPoolTaskExecutor に適用する必要がある ThreadPoolTaskExecutorCustomizers を追加します。カスタマイザーは、ビルダー構成が適用された後に追加された順序で適用されます。
      パラメーター:
      customizers - 追加するカスタマイザー
      戻り値:
      新しいビルダーインスタンス
      関連事項:
    • build

      public ThreadPoolTaskExecutor build()
      新しい ThreadPoolTaskExecutor インスタンスをビルドし、このビルダーを使用して構成します。
      戻り値:
      構成済みの ThreadPoolTaskExecutor インスタンス。
      関連事項:
    • build

      public <T extends ThreadPoolTaskExecutor> T build(ClassSE<T> taskExecutorClass)
      指定された型の新しい ThreadPoolTaskExecutor インスタンスをビルドし、このビルダーを使用して構成します。
      型パラメーター:
      T - タスク実行者の型
      パラメーター:
      taskExecutorClass - 作成するテンプレート型
      戻り値:
      構成済みの ThreadPoolTaskExecutor インスタンス。
      関連事項:
    • configure

      public <T extends ThreadPoolTaskExecutor> T configure(T taskExecutor)
      このビルダーを使用して、提供された ThreadPoolTaskExecutor インスタンスを構成します。
      型パラメーター:
      T - タスク実行者の型
      パラメーター:
      taskExecutor - 構成する ThreadPoolTaskExecutor
      戻り値:
      タスク実行者インスタンス
      関連事項: