对于最新的稳定版本,请使用 Spring Framework 6.2.0spring-doc.cadn.net.cn

事务绑定事件

从 Spring 4.2 开始,事件的侦听器可以绑定到事务的某个阶段。 典型的示例是在事务成功完成时处理事件。 这样做可以更灵活地使用事件,当当前 transaction 实际上对侦听器很重要。spring-doc.cadn.net.cn

您可以使用@EventListener注解。 如果需要将其绑定到事务,请使用@TransactionalEventListener. 执行此作时,默认情况下,侦听器将绑定到事务的提交阶段。spring-doc.cadn.net.cn

下一个示例显示了这个概念。假设组件发布 order-created 事件,并且我们想要定义一个侦听器,该侦听器应该只处理该事件一次 已成功提交已发布的事务。以下内容 example 设置这样的事件侦听器:spring-doc.cadn.net.cn

@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它聚合事务完成(无论是提交还是回滚)。spring-doc.cadn.net.cn

如果没有事务正在运行,则根本不会调用侦听器,因为我们无法遵循 必需的语义。但是,您可以通过设置fallbackExecution注解的属性设置为true.spring-doc.cadn.net.cn

@TransactionalEventListener仅适用于由PlatformTransactionManager.由ReactiveTransactionManager使用 Reactor 上下文而不是线程本地属性,因此从 事件侦听器,则没有它可以参与的兼容活动事务。spring-doc.cadn.net.cn