パッケージ jakarta.resource.cci

インターフェース LocalTransaction


  • public interface LocalTransaction
    LocalTransaction は、リソースマネージャーのローカルトランザクションのトランザクション境界インターフェースを定義します。このインターフェースは、アプリケーションレベルのローカルトランザクションの境界設定に使用されることに注意してください。システム契約レベルの LocalTransaction インターフェース(jakarta.resource.spi パッケージで定義されている)は、ローカルトランザクション管理のコンテナーによって使用されます。

    ローカルトランザクションは、リソースマネージャーの内部で管理されます。このようなトランザクションの調整に関与する外部トランザクションマネージャーはありません。

    CCI 実装は、LocalTransaction インターフェースを実装できます(必須ではありません)。LocalTransaction インターフェースが CCI 実装でサポートされている場合、メソッド Connection.getLocalTransaction は LocalTransaction インスタンスを返す必要があります。コンポーネントは、返された LocalTransaction を使用して、基になる EIS インスタンス上のリソースマネージャーローカルトランザクション(接続インスタンスに関連付けられている)を区別できます。

    導入:
    0.8
    作成者:
    Rahul Sharma
    関連事項:
    Connection
    • メソッドのサマリー

      すべてのメソッド   インスタンスメソッド   抽象メソッド  
      修飾子と型 メソッド 説明
      voidbegin()
      EIS インスタンスでローカルトランザクションを開始します。
      voidcommit()
      現在のローカルトランザクションをコミットし、基盤となる EIS インスタンスによって保持されているすべてのロックを解放します。
      voidrollback()
      現在のリソースマネージャーのローカルトランザクションをロールバックします。
    • メソッドの詳細

      • begin

        void begin()
            throws ResourceException
        EIS インスタンスでローカルトランザクションを開始します。
        例外:
        ResourceException - ローカルトランザクションの開始に失敗しました。エラーケースの例は次のとおりです。
        • リソースアダプターの内部エラーまたは EIS 固有のエラー
        • 接続はすでにローカルまたは Jakarta™ Transactions トランザクションに参加しています
      • commit

        void commit()
             throws ResourceException
        現在のローカルトランザクションをコミットし、基盤となる EIS インスタンスによって保持されているすべてのロックを解放します。
        例外:
        ResourceException - ローカルトランザクションのコミットに失敗しました。エラーケースの例は次のとおりです。
        • リソースアダプターの内部エラーまたは EIS 固有のエラー
        • 整合性制約の違反、デッドロックの検出、トランザクション完了中の通信障害、再試行要件
        • 接続はアクティブな Jakarta Transactions トランザクションに参加しています
        • 無効なトランザクションコンテキスト。アクティブなトランザクションコンテキストなしで呼び出されたコミット操作
      • rollback

        void rollback()
               throws ResourceException
        現在のリソースマネージャーのローカルトランザクションをロールバックします。
        例外:
        ResourceException - ローカルトランザクションのロールバックに失敗しました。エラーケースの例は次のとおりです。
        • リソースアダプターの内部エラーまたは EIS 固有のエラー
        • 接続はアクティブな Jakarta Transactions トランザクションに参加しています
        • 無効なトランザクションコンテキスト。アクティブなトランザクションコンテキストなしで呼び出されたロールバック操作