インターフェース TransactionalApplicationListener<E extends ApplicationEvent>
- 型パラメーター:
E- 待機する特定のApplicationEventサブクラス
- すべてのスーパーインターフェース:
ApplicationListener<E>、EventListenerSE、Ordered
public interface TransactionalApplicationListener<E extends ApplicationEvent>
extends ApplicationListener<E>, Ordered
TransactionPhase に従って呼び出される ApplicationListener。これは、TransactionalEventListener アノテーションとプログラム的に同等です。 リスナーの実装に Ordered を追加すると、トランザクションの補完前または完了後に実行されている他のリスナーの中で、そのリスナーに優先順位を付けることができます。
注: トランザクションイベントリスナーは、PlatformTransactionManager によって管理されるスレッドバウンドトランザクションでのみ機能します。ReactiveTransactionManager によって管理されるリアクティブトランザクションは、スレッドローカル変数の代わりに Reactor コンテキストを使用するため、イベントリスナーの観点からは、参加できる互換性のあるアクティブトランザクションはありません。
- 導入:
- 5.3
- 作成者:
- Juergen Hoeller, Oliver Drotbohm
- 関連事項:
ネストされたクラスのサマリー
ネストされたクラスフィールドサマリー
インターフェース org.springframework.core.Ordered から継承されたフィールド
HIGHEST_PRECEDENCE, LOWEST_PRECEDENCEメソッドのサマリー
修飾子と型メソッド説明voidトランザクション同期内の処理時に呼び出されるコールバックを追加します。static <T> TransactionalApplicationListener<PayloadApplicationEvent<T>>forPayload(ConsumerSE<T> consumer) 指定されたペイロードコンシューマー用に新しいTransactionalApplicationListenerを作成し、デフォルトのフェーズTransactionPhase.AFTER_COMMITに適用します。static <T> TransactionalApplicationListener<PayloadApplicationEvent<T>>forPayload(TransactionPhase phase, ConsumerSE<T> consumer) 指定されたペイロードコンシューマー用に新しいTransactionalApplicationListenerを作成します。default StringSEリスナーが個別に参照できるように識別子を返します。default intgetOrder()トランザクション同期内で実行順序を返します。default TransactionPhaseリスナーが呼び出されるTransactionPhaseを返します。voidprocessEvent(E event) 指定されたApplicationEventをすぐに処理します。インターフェース org.springframework.context.ApplicationListener から継承されたメソッド
onApplicationEvent
メソッドの詳細
getOrder
default int getOrder()トランザクション同期内で実行順序を返します。デフォルトは
Ordered.LOWEST_PRECEDENCEです。getListenerId
リスナーが個別に参照できるように識別子を返します。特定の補完コールバックの実装では特定の ID を提供する必要がある場合がありますが、他のシナリオでは、空の文字列（共通のデフォルト値として）も使用できます。
getTransactionPhase
リスナーが呼び出されるTransactionPhaseを返します。デフォルトのフェーズは
TransactionPhase.AFTER_COMMITです。addCallback
トランザクション同期内の処理時、つまり実際のトランザクション中にprocessEvent(E)がトリガーされたときに呼び出されるコールバックを追加します。- パラメーター:
callback- 適用する同期コールバック
processEvent
指定されたApplicationEventをすぐに処理します。ApplicationListener.onApplicationEvent(ApplicationEvent)とは対照的に、このメソッドの呼び出しは、関連付けられたtransaction phaseに延期することなく、指定されたイベントを直接処理します。- パラメーター:
event- ターゲットリスナーの実装を通じて処理するイベント
forPayload
static <T> TransactionalApplicationListener<PayloadApplicationEvent<T>> forPayload(ConsumerSE<T> consumer) 指定されたペイロードコンシューマー用に新しいTransactionalApplicationListenerを作成し、デフォルトのフェーズTransactionPhase.AFTER_COMMITに適用します。- 型パラメーター:
T- イベントペイロードの型- パラメーター:
consumer- イベントペイロードコンシューマー- 戻り値:
- 対応する
TransactionalApplicationListenerインスタンス - 関連事項:
forPayload
static <T> TransactionalApplicationListener<PayloadApplicationEvent<T>> forPayload(TransactionPhase phase, ConsumerSE<T> consumer) 指定されたペイロードコンシューマー用に新しいTransactionalApplicationListenerを作成します。- 型パラメーター:
T- イベントペイロードの型- パラメーター:
phase- リスナーを呼び出すトランザクションフェーズconsumer- イベントペイロードコンシューマー- 戻り値:
- 対応する
TransactionalApplicationListenerインスタンス - 関連事項: