インターフェース TransactionSynchronization

メソッドの詳細

• getOrder

  default int getOrder()

  このトランザクション同期の実行順序を返します。

  デフォルトは Ordered.LOWEST_PRECEDENCE です。

  次で指定:

  インターフェース Ordered の getOrder 

  戻り値:

  オーダー額

  関連事項:

  • Ordered.HIGHEST_PRECEDENCE
  • Ordered.LOWEST_PRECEDENCE

• suspend

  default void suspend()

  この同期を一時停止します。いずれかを管理している場合、TransactionSynchronizationManager からリソースのバインドを解除することになっています。

  関連事項:

  • TransactionSynchronizationManager.unbindResource(java.lang.Object)

• resume

  default void resume()

  この同期を再開します。リソースを管理している場合、リソースを TransactionSynchronizationManager に再バインドするとします。

  関連事項:

  • TransactionSynchronizationManager.bindResource(java.lang.Object, java.lang.Object)

• flush

  default void flush()

  該当する場合は、基になるセッションをデータストアにフラッシュします（例: Hibernate/JPA セッション）。

  次で指定:

  インターフェース FlushableSE の flush 

  関連事項:

  • TransactionStatus.flush()

• savepoint

  default void savepoint(ObjectSE savepoint)

  既存のトランザクションに対してネストされたトランザクションが開始されたとき、または TransactionStatus を介したプログラムによるセーブポイントで、新しいセーブポイントの作成時に呼び出されます。

  この同期コールバックは、指定されたセーブポイントオブジェクトがすでにアクティブになっているリソースセーブポイントの作成直後に呼び出されます。

  パラメーター:

  savepoint - 関連するセーブポイントオブジェクト (主にセーブポイントを識別するためのキーとして使用されますが、リソースセーブポイント型にキャストすることもできます。)

  導入:

  6.2

  関連事項:

  • SavepointManager.createSavepoint()
  • TransactionDefinition.PROPAGATION_NESTED

• savepointRollback

  default void savepointRollback(ObjectSE savepoint)

  以前に作成されたセーブポイントへのロールバックの場合に呼び出されます。

  この同期コールバックは、指定されたセーブポイントオブジェクトがまだアクティブな状態で、リソースセーブポイントのロールバックの直前に呼び出されます。

  パラメーター:

  savepoint - 関連するセーブポイントオブジェクト (主にセーブポイントを識別するためのキーとして使用されますが、リソースセーブポイント型にキャストすることもできます。)

  導入:

  6.2

  関連事項:

  • savepoint(java.lang.Object)
  • SavepointManager.rollbackToSavepoint(java.lang.Object)

• beforeCommit

  default void beforeCommit(boolean readOnly)

  トランザクションのコミット前 ( "beforeCompletion" の前) に呼び出されます。たとえば、トランザクション O/R マッピングセッションをデータベースにフラッシュできます。

  このコールバックは、トランザクションが実際にコミットされることを意味するものではありません。このメソッドが呼び出された後でも、ロールバックの決定が発生する可能性があります。このコールバックは、SQL ステートメントをデータベースにフラッシュするなど、コミットがまだ発生する可能性がある場合にのみ関連する作業を実行することを目的としています。

  例外はコミット呼び出し元に伝播され、トランザクションのロールバックが発生することに注意してください。

  パラメーター:

  readOnly - トランザクションが読み取り専用トランザクションとして定義されているかどうか

  例外:

  RuntimeExceptionSE - エラーの場合 ; 呼び出し元に伝播されます (注意: ここで TransactionException サブクラスをスローしないでください！ )

  関連事項:

  • beforeCompletion()

• beforeCompletion

  default void beforeCompletion()

  トランザクションのコミット / ロールバックの前に呼び出されます。トランザクションの完了前にリソースのクリーンアップを実行できます。

  beforeCommit が例外をスローした場合でも、このメソッドは beforeCommit の後に呼び出されます。このコールバックにより、トランザクションの完了前にリソースを閉じることができます。

  例外:

  RuntimeExceptionSE - エラーの場合 ; ログに記録されますが、伝播されません (注意: ここで TransactionException サブクラスをスローしないでください！ )

  関連事項:

  • beforeCommit(boolean)
  • afterCompletion(int)

• afterCommit

  default void afterCommit()

  トランザクションのコミット後に呼び出されます。メイントランザクションが正常にコミットされた直後に、さらに操作を実行できます。

  たとえば、確認メッセージやメールなど、メイントランザクションのコミットが成功した後に続くはずの追加操作をコミットできます。

  注 : トランザクションはすでにコミットされていますが、トランザクションリソースはまだアクティブでアクセス可能です。結果として、この時点でトリガーされたデータアクセスコードは元のトランザクションに「参加」し、別のトランザクションで実行する必要があることを明示的に宣言しない限り、クリーンアップを実行できるようになります。、 ここから呼び出されるトランザクション操作には PROPAGATION_REQUIRES_NEW を使用します。

  例外:

  RuntimeExceptionSE - エラーの場合 ; 呼び出し元に伝播されます (注意: ここで TransactionException サブクラスをスローしないでください！ )

• afterCompletion

  default void afterCompletion(int status)

  トランザクションのコミット / ロールバック後に呼び出されます。トランザクションの完了後にリソースのクリーンアップを実行できます。

  注 : トランザクションはすでにコミットまたはロールバックされていますが、トランザクションリソースはまだアクティブでアクセス可能です。結果として、この時点でトリガーされたデータアクセスコードは元のトランザクションに「参加」し、別のトランザクションで実行する必要があることを明示的に宣言しない限り、クリーンアップを実行できるようになります。、 ここから呼び出されるトランザクション操作には PROPAGATION_REQUIRES_NEW を使用します。

  パラメーター:

  status - STATUS_* 定数に従った完了ステータス

  例外:

  RuntimeExceptionSE - エラーの場合 ; ログに記録されますが、伝播されません (注意: ここで TransactionException サブクラスをスローしないでください！ )

  関連事項:

  • STATUS_COMMITTED
  • STATUS_ROLLED_BACK
  • STATUS_UNKNOWN
  • beforeCompletion()