パッケージ jakarta.resource.spi.work

クラス ExecutionContext

  • 既知の直属サブクラス
    TransactionContext
    public class ExecutionContext
extends ObjectSE
    このクラスは、Work インスタンスを実行する必要がある実行コンテキスト（トランザクション、セキュリティなど）をモデル化します。このクラスは、このクラスを継承し、対象のメソッドのみをオーバーライドすることにより、ExecutionContext インスタンスを簡単に作成するための便利な機能として提供されています。

    ExecutionContext がインターフェースよりもクラスである方が良い理由はいくつかあります。

    • このクラスを実装するためにリソースアダプターは必要ありません。トランザクションなどのコンテキスト情報を実装するだけで済みます。
    • ExecutionContext クラスが進化するときに、リソースアダプターコードを変更する必要はありません。例: リソースアダプターの実装を強制的に変更せずに、（将来的に） ExecutionContext クラスにさらに多くのコンテキスト型を追加できる可能性があります。
    メモ: Jakarta Connectors 仕様に準拠したアプリケーションサーバー用に開発されたリソースアダプターは、このクラスの代わりに TransactionContext インターフェースを使用することをお勧めします。詳細については、コネクター 1.6 仕様の第 11 章一般的な作業コンテキストを参照してください。
    バージョン:
    1.0
    作成者:
    Ram Jeyaraman

    • コンストラクターの詳細

      • ExecutionContext

        public ExecutionContext()

    • メソッドの詳細

      • setXid

        public void setXid​(XidSE xid)
        トランザクションコンテキストを設定します。
        パラメーター:
        xid - トランザクションコンテキスト。

      • getXid

        public XidSE getXid()
        戻り値:
        トランザクションコンテキストを保持する Xid オブジェクト（存在する場合）。

      • setTransactionTimeout

        public void setTransactionTimeout​(long timeout)
                           throws NotSupportedException
        インポートされたトランザクションのトランザクションタイムアウト値を設定します。
        パラメーター:
        timeout - 秒単位のトランザクションタイムアウト値。ゼロ以外の正の値のみが受け入れられます。他の値は不正であり、NotSupportedException で拒否されます。
        例外:
        NotSupportedException - 不正なタイムアウト値を示すためにスローされます。

      • getTransactionTimeout

        public long getTransactionTimeout()
        インポートされたトランザクションのトランザクションタイムアウト値を取得します。
        戻り値:
        指定されたトランザクションタイムアウト値（秒単位）。タイムアウト値が指定されていないか、不正なタイムアウト値が指定されている場合、値 -1（WorkManager.UNKNOWN）が返されます。このようなトランザクションのタイムアウト処理は、アプリケーションサーバーの実装によって異なります。