事务绑定的事件
从 Spring 4.2 开始,事件的监听器可以绑定到事务的某个阶段。典型的例子是在事务成功完成后处理事件。这样做使得事件在当前事务的结果对监听器确实重要时,可以更灵活地使用。
您可以使用 @EventListener
注解注册常规事件监听器。如果需要将其绑定到事务,请使用 @TransactionalEventListener
。这样做时,监听器默认绑定到事务的提交阶段。
下一个示例展示了这个概念。假设某个组件发布了一个订单创建事件,并且我们希望定义一个监听器,该监听器只有在该事件发布所在的事务成功提交后才处理该事件。以下示例设置了这样一个事件监听器
-
Java
-
Kotlin
@Component
public class MyComponent {
@TransactionalEventListener
public void handleOrderCreatedEvent(CreationEvent<Order> creationEvent) {
// ...
}
}
@Component
class MyComponent {
@TransactionalEventListener
fun handleOrderCreatedEvent(creationEvent: CreationEvent<Order>) {
// ...
}
}
@TransactionalEventListener
注解暴露了一个 phase
属性,允许您自定义监听器应绑定到的事务阶段。有效阶段包括 BEFORE_COMMIT
、AFTER_COMMIT
(默认)、AFTER_ROLLBACK
,以及聚合了事务完成(无论是提交还是回滚)的 AFTER_COMPLETION
。
如果没有事务正在运行,则监听器根本不会被调用,因为我们无法满足所需的语义。但是,您可以通过将注解的 fallbackExecution
属性设置为 true
来覆盖该行为。
从 6.1 版本开始, |