パッケージ jakarta.resource.spi

インターフェース BootstrapContext


  • public interface BootstrapContext
    これは、ブートストラップされたときにブートストラップコンテキストをリソースアダプターインスタンスに渡すメカニズムを提供します。つまり、ResourceAdapter クラスの(start(BootstrapContext))メソッドが呼び出されたときです。ブートストラップコンテキストには、リソースアダプターインスタンスで使用できる便利な機能への参照が含まれています。
    作成者:
    Ram Jeyaraman, Sivakumar Thyagarajan
    • メソッドの詳細

      • 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