パッケージ 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
- 関連事項:
方法の概要
方法の詳細
begin
EIS インスタンスでローカルトランザクションを開始します。- 例外:
ResourceException- ローカルトランザクションの開始に失敗しました。エラーケースの例は次のとおりです。- リソースアダプターの内部エラーまたは EIS 固有のエラー
- 接続はすでにローカルまたは Jakarta™ Transactions トランザクションに参加しています
commit
現在のローカルトランザクションをコミットし、基盤となる EIS インスタンスによって保持されているすべてのロックを解放します。- 例外:
ResourceException- ローカルトランザクションのコミットに失敗しました。エラーケースの例は次のとおりです。- リソースアダプターの内部エラーまたは EIS 固有のエラー
- 整合性制約の違反、デッドロックの検出、トランザクション完了中の通信障害、再試行要件
- 接続はアクティブな Jakarta Transactions トランザクションに参加しています
- 無効なトランザクションコンテキスト。アクティブなトランザクションコンテキストなしで呼び出されたコミット操作
rollback
現在のリソースマネージャーのローカルトランザクションをロールバックします。- 例外:
ResourceException- ローカルトランザクションのロールバックに失敗しました。エラーケースの例は次のとおりです。- リソースアダプターの内部エラーまたは EIS 固有のエラー
- 接続はアクティブな Jakarta Transactions トランザクションに参加しています
- 無効なトランザクションコンテキスト。アクティブなトランザクションコンテキストなしで呼び出されたロールバック操作