パッケージ 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
関連事項:
  • 方法の概要

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

    • 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 トランザクションに参加しています
      • 無効なトランザクションコンテキスト。アクティブなトランザクションコンテキストなしで呼び出されたロールバック操作