パッケージ 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
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 void
begin()
EIS インスタンスでローカルトランザクションを開始します。void
commit()
現在のローカルトランザクションをコミットし、基盤となる EIS インスタンスによって保持されているすべてのロックを解放します。void
rollback()
現在のリソースマネージャーのローカルトランザクションをロールバックします。
メソッドの詳細
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 トランザクションに参加しています
- 無効なトランザクションコンテキスト。アクティブなトランザクションコンテキストなしで呼び出されたロールバック操作