パッケージ jakarta.resource.spi
インターフェース BootstrapContext
public interface BootstrapContextこれは、ブートストラップされたときにブートストラップコンテキストをリソースアダプターインスタンスに渡すメカニズムを提供します。つまり、ResourceAdapterクラスの(start(BootstrapContext))メソッドが呼び出されたときです。ブートストラップコンテキストには、リソースアダプターインスタンスで使用できる便利な機能への参照が含まれています。- 作成者:
- Ram Jeyaraman, Sivakumar Thyagarajan
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 TimerSEcreateTimer()新しいjava.util.Timerインスタンスを作成します。TransactionSynchronizationRegistrygetTransactionSynchronizationRegistry()TransactionSynchronizationインスタンスへのハンドルを提供します。WorkManagergetWorkManager()WorkManagerインスタンスへのハンドルを提供します。XATerminatorgetXATerminator()XATerminatorインスタンスへのハンドルを提供します。booleanisContextSupported(ClassSE<? extends WorkContext> workContextClass)リソースアダプターは、このメソッドを使用して、特定の WorkContext 型に対するアプリケーションサーバーのサポートを確認できます。
メソッドの詳細
getWorkManager
WorkManager getWorkManager()
WorkManagerインスタンスへのハンドルを提供します。WorkManagerインスタンスは、リソースアダプターが使用して、Workインスタンスを実行のために送信することによってその作業を実行できます。- 戻り値:
WorkManagerインスタンス。
getXATerminator
XATerminator getXATerminator()
XATerminatorインスタンスへのハンドルを提供します。XATerminatorインスタンスは、リソースアダプターによって使用され、EIS からのトランザクション完了とクラッシュリカバリ呼び出しをフローインすることができます。- 戻り値:
XATerminatorインスタンス。
createTimer
TimerSE createTimer() throws UnavailableException
新しいjava.util.Timerインスタンスを作成します。Timerインスタンスは、定期的なWork実行またはその他のタスクを実行するために使用できます。- 戻り値:
- 新しい
Timerインスタンス。 - 例外:
UnavailableException-Timerインスタンスが使用できないことを示します。リクエストは後で再試行される場合があります。
isContextSupported
boolean isContextSupported(ClassSE<? extends WorkContext> workContextClass)
リソースアダプターは、このメソッドを使用して、特定の WorkContext 型に対するアプリケーションサーバーのサポートを確認できます。このメカニズムにより、リソースアダプターの開発者は、アプリケーションサーバーによって提供されるサポートに基づいて、Work インスタンスで送信された WorkContexts を動的に変更できます。アプリケーションサーバーは、このメソッドで正確な型の同等性チェック(つまり、java.lang.Class.equals(java.lang.Class)チェック)を使用して、リソースアダプターによって提供される WorkContext 型をサポートしているかどうかを確認する必要があります。このメソッドはべき等である必要があります。つまり、特定のWorkContext型のリソースアダプターによるこのメソッドのすべての呼び出しは、そのリソースアダプターインスタンスのライフサイクル全体で同じブール値を返す必要があります。- パラメーター:
workContextClass- アプリケーションサーバーによるサポートがテストされている WorkContext 型。- 戻り値:
workContextClassがアプリケーションサーバーでサポートされている場合は true。workContextClassがサポートされていないか、アプリケーションサーバーに認識されていない場合は false。- 導入:
- 1.6
getTransactionSynchronizationRegistry
TransactionSynchronizationRegistry getTransactionSynchronizationRegistry()
TransactionSynchronizationインスタンスへのハンドルを提供します。TransactionSynchronizationRegistryインスタンスは、リソースアダプターが同期オブジェクトの登録、トランザクションの状態やステータスの取得などに使用できます。このインターフェースは、ステートレスサービスオブジェクトによってアプリケーションサーバーによって実装されます。同じオブジェクトは、スレッドセーフを備えた任意の数のリソースアダプターオブジェクトで使用できます。- 戻り値:
TransactionSynchronizationRegistryインスタンス。- 導入:
- 1.6