public class ForkJoinPoolFactoryBean extends ObjectSE implements FactoryBean<ForkJoinPoolSE>, InitializingBean, DisposableBean
ForkJoinPoolSE を作成して公開する Spring FactoryBean。ForkJoinPool API および RecursiveActions でのその使用の詳細については、JDK 7 javadocSE を参照してください。
Java 6 の java.util.concurrent 更新を含む jsr166.jar は、並行性インタレスト Web サイトから入手できます。
| コンストラクターと説明 |
|---|
ForkJoinPoolFactoryBean() |
| 修飾子と型 | メソッドと説明 |
|---|---|
void | afterPropertiesSet() 指定されたすべての Bean プロパティを設定した(そして BeanFactoryAware と ApplicationContextAware を満たした)後に BeanFactory によって呼び出されます。 |
void | destroy() シングルトンの破棄時に BeanFactory によって呼び出されます。 |
ForkJoinPoolSE | getObject() このファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。 |
ClassSE<?> | getObjectType() この FactoryBean が作成するオブジェクトの型を返します。事前にわからない場合は null を返します。 |
boolean | isSingleton() このファクトリによって管理されるオブジェクトはシングルトンですか? つまり、 FactoryBean.getObject() は常に同じオブジェクト(キャッシュ可能な参照)を返しますか? |
void | setAsyncMode(boolean asyncMode) 結合されないフォークされたタスクに対してローカルの先入れ先出しスケジューリングモードを確立するかどうかを指定します。 |
void | setAwaitTerminationSeconds(int awaitTerminationSeconds) 残りのコンテナーが引き続きシャットダウンする前に、残りのタスクが実行を完了するのを待つために、シャットダウン時にこの ForkJoinPool がブロックする最大秒数を設定します。 |
void | setCommonPool(boolean commonPool)JDK 8 の「共通」 ForkJoinPoolSE を公開するかどうかを設定します。 |
void | setParallelism(int parallelism) 並列度を指定します。 |
void | setThreadFactory(ForkJoinPool.ForkJoinWorkerThreadFactorySE threadFactory) 新しい ForkJoinWorkerThreads を作成するためのファクトリを設定します。 |
void | setUncaughtExceptionHandler(Thread.UncaughtExceptionHandlerSE uncaughtExceptionHandler) タスクの実行中に発生した回復不可能なエラーが原因で終了する内部ワーカースレッドのハンドラーを設定します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSEpublic void setCommonPool(boolean commonPool)
ForkJoinPoolSE を公開するかどうかを設定します。 デフォルトは "false" で、この FactoryBean の "parallelism"、"threadFactory"、"uncaughtExceptionHandler"、"asyncMode" プロパティに基づいてローカル ForkJoinPoolSE インスタンスを作成します。
注意 : このフラグを "true" に設定すると、この FactoryBean の他のすべてのプロパティが事実上無視され、代わりに共有の共通 JDK ForkJoinPoolSE が再利用されます。これは JDK 8 の良い選択ですが、ForkJoinPool の動作をカスタマイズするアプリケーションの機能、特にカスタムスレッドの使用を削除します。
ForkJoinPool.commonPool()SEpublic void setParallelism(int parallelism)
Runtime.availableProcessors()SE です。public void setThreadFactory(ForkJoinPool.ForkJoinWorkerThreadFactorySE threadFactory)
ForkJoinPool.defaultForkJoinWorkerThreadFactorySE です。public void setUncaughtExceptionHandler(Thread.UncaughtExceptionHandlerSE uncaughtExceptionHandler)
public void setAsyncMode(boolean asyncMode)
true) は、ワーカースレッドがイベントスタイルの非同期タスクのみを処理するアプリケーションでは、デフォルトのローカルスタックベースモードよりも適切な場合があります。デフォルトは false です。public void setAwaitTerminationSeconds(int awaitTerminationSeconds)
デフォルトでは、この ForkJoinPool はタスクの終了をまったく待ちません。残りのコンテナーのシャットダウンと並行して、進行中のすべてのタスクとキュー内の残りのすべてのタスクを完全に実行し続けます。対照的に、このプロパティを使用して終了待機期間を指定した場合、このエグゼキュータは、タスクの終了のために指定された時間(最大)待機します。
この機能は "commonPool" モードでも機能することに注意してください。その場合、基になる ForkJoinPool は実際には終了しませんが、すべてのタスクが終了するまで待機します。
public void afterPropertiesSet()
InitializingBeanこのメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されている場合にのみ可能な初期化を実行し、設定ミスの場合に例外をスローできます。
InitializingBean の afterPropertiesSet @Nullable public ForkJoinPoolSE getObject()
FactoryBeanBeanFactory と同様に、これにより、シングルトンとプロトタイプの両方のデザインパターンをサポートできます。
この FactoryBean が呼び出し時にまだ完全に初期化されていない場合(たとえば、循環参照に関係しているため)、対応する FactoryBeanNotInitializedException をスローします。
Spring 2.0 以降、FactoryBeans は null オブジェクトを返すことができます。ファクトリはこれを通常の値として使用します。この場合、FactoryBeanNotInitializedException はスローされません。FactoryBean の実装では、必要に応じて FactoryBeanNotInitializedException 自体をすぐにスローすることをお勧めします。
FactoryBean<ForkJoinPoolSE> の getObject null にすることができます)FactoryBeanNotInitializedExceptionpublic ClassSE<?> getObjectType()
FactoryBeannull を返します。これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。
シングルトンオブジェクトを作成している実装の場合、このメソッドはシングルトンの作成を可能な限り回避しようとします。むしろ、事前に型を推定する必要があります。プロトタイプの場合、ここで意味のある型を返すこともお勧めします。
このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。
注意 : オートワイヤーは、ここで null を返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。
FactoryBean<ForkJoinPoolSE> の getObjectType null ListableBeanFactory.getBeansOfType(java.lang.Class<T>)public boolean isSingleton()
FactoryBeanFactoryBean.getObject() は常に同じオブジェクト(キャッシュ可能な参照)を返しますか? 注意 : FactoryBean がシングルトンオブジェクトを保持することを示す場合、getObject() から返されたオブジェクトは所有 BeanFactory によってキャッシュされる可能性があります。FactoryBean が常に同じ参照を公開しない限り、true を返さないでください。
FactoryBean 自体のシングルトンステータスは、通常、所有する BeanFactory によって提供されます。通常、そこではシングルトンとして定義する必要があります。
注意 : false を返すこのメソッドは、返されるオブジェクトが独立したインスタンスであることを必ずしも示しません。拡張 SmartFactoryBean インターフェースの実装は、SmartFactoryBean.isPrototype() メソッドを通じて独立したインスタンスを明示的に示す場合があります。この拡張インターフェースを実装しないプレーンな FactoryBean 実装は、isSingleton() 実装が false を返す場合、常に独立したインスタンスを返すと単純に想定されます。
FactoryBean は通常シングルトンインスタンスを管理するため、デフォルトの実装では true が返されます。
FactoryBean<ForkJoinPoolSE> の isSingleton FactoryBean.getObject(), SmartFactoryBean.isPrototype()public void destroy()
DisposableBeanDisposableBean の destroy