クラス ForkJoinPoolFactoryBean

メソッドの詳細

• setCommonPool

  public void setCommonPool(boolean commonPool)

  JDK 8 の「共通」ForkJoinPoolSE を公開するかどうかを設定します。

  デフォルトは "false" で、この FactoryBean の "parallelism"、"threadFactory"、"uncaughtExceptionHandler"、"asyncMode" プロパティに基づいてローカル ForkJoinPoolSE インスタンスを作成します。

  注意 : このフラグを "true" に設定すると、この FactoryBean の他のすべてのプロパティが事実上無視され、代わりに共有の共通 JDK ForkJoinPoolSE が再利用されます。これは JDK 8 の良い選択ですが、ForkJoinPool の動作をカスタマイズするアプリケーションの機能、特にカスタムスレッドの使用を削除します。

  導入:

  3.2

  関連事項:

  • ForkJoinPool.commonPool()

• setParallelism

  public void setParallelism(int parallelism)

  並列度を指定します。デフォルトは Runtime.availableProcessors() です。

• setThreadFactory

  public void setThreadFactory(ForkJoinPool.ForkJoinWorkerThreadFactorySE threadFactory)

  新しい ForkJoinWorkerThreads を作成するためのファクトリを設定します。デフォルトは ForkJoinPool.defaultForkJoinWorkerThreadFactorySE です。

• setUncaughtExceptionHandler

  public void setUncaughtExceptionHandler(Thread.UncaughtExceptionHandlerSE uncaughtExceptionHandler)

  タスクの実行中に発生した回復不可能なエラーが原因で終了する内部ワーカースレッドのハンドラーを設定します。デフォルトはなしです。

• setAsyncMode

  public void setAsyncMode(boolean asyncMode)

  結合されないフォークされたタスクに対してローカルの先入れ先出しスケジューリングモードを確立するかどうかを指定します。このモード（asyncMode = true）は、ワーカースレッドがイベントスタイルの非同期タスクのみを処理するアプリケーションでは、デフォルトのローカルスタックベースのモードよりも適切な場合があります。デフォルトは false です。

• setAwaitTerminationSeconds

  public void setAwaitTerminationSeconds(int awaitTerminationSeconds)

  残りのコンテナーが引き続きシャットダウンする前に、残りのタスクが実行を完了するのを待つために、シャットダウン時にこの ForkJoinPool がブロックする最大秒数を設定します。これは、残りのタスクがコンテナーによって管理されている他のリソースへのアクセスを必要とする可能性がある場合に特に役立ちます。

  デフォルトでは、この ForkJoinPool はタスクの終了をまったく待ちません。残りのコンテナーのシャットダウンと並行して、進行中のすべてのタスクとキュー内の残りのすべてのタスクを完全に実行し続けます。対照的に、このプロパティを使用して終了待機期間を指定した場合、このエグゼキュータは、タスクの終了のために指定された時間（最大）待機します。

  この機能は "commonPool" モードでも機能することに注意してください。その場合、基になる ForkJoinPool は実際には終了しませんが、すべてのタスクが終了するまで待機します。

  関連事項:

  • ForkJoinPool.shutdown()
  • ForkJoinPool.awaitTermination(long, java.util.concurrent.TimeUnit)SE

• afterPropertiesSet

  public void afterPropertiesSet()

  インターフェースからコピーされた説明: InitializingBean

  すべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。

  このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。

  次で指定:

  インターフェース InitializingBean の afterPropertiesSet 

• getObject

  @Nullable public ForkJoinPoolSE getObject()

  インターフェースからコピーされた説明: FactoryBean

  このファクトリによって管理されるオブジェクトのインスタンス（おそらく共有または独立）を返します。

  BeanFactory と同様に、これにより、シングルトンとプロトタイプの両方のデザインパターンをサポートできます。

  この FactoryBean が呼び出し時にまだ完全に初期化されていない場合（たとえば、循環参照に関係しているため）、対応する FactoryBeanNotInitializedException をスローします。

  Spring 2.0 以降、FactoryBeans は null オブジェクトを返すことができます。ファクトリはこれを通常の値として使用します。この場合、FactoryBeanNotInitializedException はスローされません。FactoryBean の実装では、必要に応じて FactoryBeanNotInitializedException 自体をすぐにスローすることをお勧めします。

  次で指定:

  インターフェース FactoryBean<ForkJoinPoolSE> の getObject 

  戻り値:

  Bean のインスタンス (null にすることができます)

  関連事項:

  • FactoryBeanNotInitializedException

• getObjectType

  public ClassSE<?> getObjectType()

  インターフェースからコピーされた説明: FactoryBean

  この FactoryBean が作成するオブジェクトの型、または事前に不明な場合は null を返します。

  これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。

  シングルトンオブジェクトを作成している実装の場合、このメソッドはシングルトンの作成を可能な限り回避しようとします。むしろ、事前に型を推定する必要があります。プロトタイプの場合、ここで意味のある型を返すこともお勧めします。

  このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。

  注意 : オートワイヤーは、ここで null を返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。

  次で指定:

  インターフェース FactoryBean<ForkJoinPoolSE> の getObjectType 

  戻り値:

  この FactoryBean が作成するオブジェクトの型、または呼び出し時に不明な場合は null 

  関連事項:

  • ListableBeanFactory.getBeansOfType(java.lang.Class<T>)

• isSingleton

  public boolean isSingleton()

  インターフェースからコピーされた説明: FactoryBean

  このファクトリによって管理されるオブジェクトはシングルトンですか？ つまり、FactoryBean.getObject() は常に同じオブジェクト（キャッシュ可能な参照）を返しますか？

  注意 : FactoryBean がシングルトンオブジェクトを保持することを示す場合、getObject() から返されたオブジェクトは所有 BeanFactory によってキャッシュされる可能性があります。FactoryBean が常に同じ参照を公開しない限り、true を返さないでください。

  FactoryBean 自体のシングルトンステータスは、通常、所有する BeanFactory によって提供されます。通常、そこではシングルトンとして定義する必要があります。

  注意 : false を返すこのメソッドは、返されるオブジェクトが独立したインスタンスであることを必ずしも示しません。拡張 SmartFactoryBean インターフェースの実装は、SmartFactoryBean.isPrototype() メソッドを通じて独立したインスタンスを明示的に示す場合があります。この拡張インターフェースを実装しないプレーンな FactoryBean 実装は、isSingleton() 実装が false を返す場合、常に独立したインスタンスを返すと単純に想定されます。

  FactoryBean は通常シングルトンインスタンスを管理するため、デフォルトの実装は true を返します。

  次で指定:

  インターフェース FactoryBean<ForkJoinPoolSE> の isSingleton 

  戻り値:

  公開されたオブジェクトがシングルトンかどうか

  関連事項:

  • FactoryBean.getObject()
  • SmartFactoryBean.isPrototype()

• destroy

  public void destroy()

  インターフェースからコピーされた説明: DisposableBean

  Bean の破棄時に、包含 BeanFactory によって呼び出されます。

  次で指定:

  インターフェース DisposableBean の destroy