パッケージ jakarta.resource.spi
インターフェース BootstrapContext
public interface BootstrapContext
これは、ブートストラップされたときにブートストラップコンテキストをリソースアダプターインスタンスに渡すメカニズムを提供します。つまり、ResourceAdapter
クラスの(start(BootstrapContext)
)メソッドが呼び出されたときです。ブートストラップコンテキストには、リソースアダプターインスタンスで使用できる便利な機能への参照が含まれています。- 作成者:
- Ram Jeyaraman, Sivakumar Thyagarajan
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 TimerSE
createTimer()
新しいjava.util.Timer
インスタンスを作成します。TransactionSynchronizationRegistry
getTransactionSynchronizationRegistry()
TransactionSynchronization
インスタンスへのハンドルを提供します。WorkManager
getWorkManager()
WorkManager
インスタンスへのハンドルを提供します。XATerminator
getXATerminator()
XATerminator
インスタンスへのハンドルを提供します。boolean
isContextSupported(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