org.springframework.transaction.event

Annotation Type TransactionalEventListener

@EventListener
 @Target(value={METHOD,ANNOTATION_TYPE})
 @Retention(value=RUNTIME)
 @Documented
public @interface TransactionalEventListener

An EventListener that is invoked according to a TransactionPhase.

If the event is not published within the boundaries of a managed transaction, the event is discarded unless the fallbackExecution() flag is explicitly set. If a transaction is running, the event is processed according to its TransactionPhase.

Adding @Order on your annotated method allows you to prioritize that listener amongst other listeners running in the same phase.

Since:

4.2

Author:

Stephane Nicoll, Sam Brannen

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
java.lang.Class<?>[]	classes The event classes that this listener handles.
java.lang.String	condition Spring Expression Language (SpEL) attribute used for making the event handling conditional.
boolean	fallbackExecution Whether the event should be processed if no transaction is running.
TransactionPhase	phase Phase to bind the handling of an event to.
java.lang.Class<?>[]	value Alias for classes().

Element Detail

phase

public abstract TransactionPhase phase

Phase to bind the handling of an event to.

If no transaction is in progress, the event is not processed at all unless fallbackExecution() has been enabled explicitly.

Default:

org.springframework.transaction.event.TransactionPhase.AFTER_COMMIT

fallbackExecution

public abstract boolean fallbackExecution

Whether the event should be processed if no transaction is running.

Default:

false

value

@AliasFor(annotation=EventListener.class,
          attribute="classes")
public abstract java.lang.Class<?>[] value

Alias for classes().

Default:

{}

classes

@AliasFor(annotation=EventListener.class,
          attribute="classes")
public abstract java.lang.Class<?>[] classes

The event classes that this listener handles.

If this attribute is specified with a single value, the annotated method may optionally accept a single parameter. However, if this attribute is specified with multiple values, the annotated method must not declare any parameters.

Default:

{}

condition

public abstract java.lang.String condition

Spring Expression Language (SpEL) attribute used for making the event handling conditional.

Default is "", meaning the event is always handled.

See Also:

EventListener.condition()

Default:

""