パッケージ org.springframework.transaction

インターフェース ReactiveTransactionManager

すべてのスーパーインターフェース:
TransactionManager
すべての既知の実装クラス:
AbstractReactiveTransactionManager, R2dbcTransactionManager
public interface ReactiveTransactionManager extends TransactionManager
これは、Spring のリアクティブトランザクションインフラストラクチャの中心的なインターフェースです。アプリケーションはこれを直接使用できますが、主に API として意図されたものではありません。通常、アプリケーションは、トランザクションオペレーターまたは AOP による宣言型トランザクション境界のいずれかで動作します。
導入:
5.2
作成者:
Mark Paluch, Juergen Hoeller
関連事項:

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    reactor.core.publisher.Mono<VoidSE>
    commit(ReactiveTransaction transaction)
    ステータスに関して、指定されたトランザクションをコミットします。
    reactor.core.publisher.Mono<ReactiveTransaction>
    getReactiveTransaction(TransactionDefinition definition)
    指定された伝播動作に従って、現在アクティブなリアクティブトランザクションを発行するか、新しいトランザクションを作成します。
    reactor.core.publisher.Mono<VoidSE>
    rollback(ReactiveTransaction transaction)
    指定されたトランザクションのロールバックを実行します。

  • メソッドの詳細

    • getReactiveTransaction

      reactor.core.publisher.Mono<ReactiveTransaction> getReactiveTransaction(@Nullable TransactionDefinition definition) throws TransactionException
      指定された伝播動作に従って、現在アクティブなリアクティブトランザクションを発行するか、新しいトランザクションを作成します。

      分離レベルやタイムアウトなどのパラメーターは新しいトランザクションにのみ適用されるため、アクティブなトランザクションに参加する場合は無視されることに注意してください。

      さらに、すべてのトランザクション定義設定がすべてのトランザクションマネージャーでサポートされるわけではありません。適切なトランザクションマネージャーの実装は、サポートされていない設定が発生した場合に例外をスローする必要があります。

      上記の規則の例外は読み取り専用フラグです。明示的な読み取り専用モードがサポートされていない場合は無視してください。基本的に、読み取り専用フラグは潜在的な最適化のヒントにすぎません。

      パラメーター:
      definition - TransactionDefinition インスタンス。伝播動作、分離レベル、タイムアウトなどを記述します。
      戻り値:
      新規または現在のトランザクションを表すトランザクションステータスオブジェクト
      例外:
      TransactionException - ルックアップ、作成、システムエラーの場合
      IllegalTransactionStateException - 指定されたトランザクション定義を実行できない場合 (たとえば、現在アクティブなトランザクションが指定された伝播動作と競合している場合)
      関連事項:

    • commit

      reactor.core.publisher.Mono<VoidSE> commit(ReactiveTransaction transaction) throws TransactionException
      ステータスに関して、指定されたトランザクションをコミットします。トランザクションがプログラムでロールバック専用としてマークされている場合、ロールバックを実行します。

      トランザクションが新しいものではない場合、周囲のトランザクションに適切に参加するためにコミットを省略します。以前のトランザクションが中断されて新しいトランザクションを作成できる場合は、新しいトランザクションをコミットした後に以前のトランザクションを再開します。

      コミットの呼び出しが完了すると、正常であるか例外をスローするかに関係なく、トランザクションを完全に完了してクリーンアップする必要があることに注意してください。このような場合、ロールバックコールは予期されません。

      このメソッドが TransactionException 以外の例外をスローした場合、コミット前のエラーが原因でコミットの試行が失敗しました。例: O/R マッピングツールがコミットの直前にデータベースへの変更をフラッシュしようとして、結果の DataAccessException がトランザクションを失敗させた可能性があります。このような場合、元の例外はこの commit メソッドの呼び出し元に伝播されます。

      パラメーター:
      transaction - getTransaction メソッドによって返されるオブジェクト
      例外:
      UnexpectedRollbackException - トランザクションコーディネーターが開始した予期しないロールバックの場合
      HeuristicCompletionException - トランザクションコーディネーター側のヒューリスティックな決定が原因でトランザクションが失敗した場合
      TransactionSystemException - コミットまたはシステムエラーの場合 (通常、根本的なリソース障害が原因)
      IllegalTransactionStateException - 指定されたトランザクションがすでに完了している場合 (つまり、コミットまたはロールバックされます)
      TransactionException
      関連事項:

    • rollback

      reactor.core.publisher.Mono<VoidSE> rollback(ReactiveTransaction transaction) throws TransactionException
      指定されたトランザクションのロールバックを実行します。

      トランザクションが新しいものではない場合は、周囲のトランザクションに適切に参加するために、ロールバックのみに設定します。新しいトランザクションを作成できるように以前のトランザクションが中断されている場合は、新しいトランザクションをロールバックしてから以前のトランザクションを再開します。

      コミットが例外をスローした場合、トランザクションでロールバックを呼び出さないでください。コミット例外が発生した場合でも、コミットが戻ると、トランザクションはすでに完了し、クリーンアップされています。その結果、コミットの失敗後のロールバック呼び出しは、IllegalTransactionStateException につながります。

      パラメーター:
      transaction - getTransaction メソッドによって返されるオブジェクト
      例外:
      TransactionSystemException - ロールバックまたはシステムエラーの場合 (通常、根本的なリソース障害が原因)
      IllegalTransactionStateException - 指定されたトランザクションがすでに完了している場合 (つまり、コミットまたはロールバックされます)
      TransactionException