最近在项目中引入了一个事务提交后的监听器,现对这些功能做一个阶段性的总结:
什么是监听器?
- 就是用来监听程序执行的。监听器可以做什么事?可以监听程序执行,使程序在不同的阶段做不同的事情,并且与程序主业务逻辑解耦.
- web监听器就是Servlet中特殊的类,他们能帮助开发者监听web中的特定事件,比如ServletContext、HttpSession、ServletRequest的创建和销毁;变量的创建、销毁和修改等。可以在某些动作前后增加处理,实现监控等等。
Spring 监听器包含一下模块:
发布器(ApplicationEventPublisher):用来在业务逻辑中发布事件。 复制代码
广播器(ApplicationEventMulticaster):用来把发布的事件广播给支持当前事件的监听器。 复制代码
监听器(ApplicationListener):用来监听自己感兴趣的事件,当程序发布事件时,可以执行一些相应的业务逻辑。ApplicationListener定义了onApplicationEvent方法,监听器监听到事件发布后执行onApplicationEvent方法。 复制代码
事件(ApplicationEvent):用来定义事件。 复制代码
Spring的监听器执行步骤:
- 小知识:Spring boot项目启动时会扫描项目中的监听器并加载到广播器中,所以广播器广播的时候能获取到所有的监听器。 Spring boot识别项目中的监听器规则是:@EventListener注解标注的方法,ApplicationListener接口的实现类。
程序在执行时调用SpringBoot的发布器(ApplicationEventPublisher)发布事件(ApplicationEvent) 复制代码
发布器(ApplicationEventPublisher)调用广播器(ApplicationEventMulticaster)把事件广播给支持当前事件的监听器(ApplicationListener)。通俗的话描述,就是广播器根据发布的事件,从所有的监听器中筛选出支持当前事件的监听器。 复制代码
执行监听器。Spring boot的监听器必须实现ApplicationListener接口并重写onApplicationEvent(Eevent)方法。执行监听器就是广播器筛选出符合条件的监听器后执行onApplicationEvent方法。 复制代码
对于网上查询的一些监听器的应用,很多都是根据上下文初始化一些数据,做一些统计等,而针对于监听事务提交后触发事件这一个,springboot提供了一个@TransactionalEventListener
具体的实现如下:
- 需要我们创建3个类,对应的分别是 事件, 监听器, 发布器,
//发布器中实现ApplicationEventPublisherAware接口,同时初始化ApplicationEventPublisher @Slf4j @Component public class cachePublisher implements ApplicationEventPublisherAware { //spring boot的事件发布器 private ApplicationEventPublisher applicationEventPublisher; @Override public void setApplicationEventPublisher(ApplicationEventPublisher applicationEventPublisher) { this.applicationEventPublisher = applicationEventPublisher; } /** * Desc: 发布事件,根据发布缓存事件的参数类型先构造对应的Event对象再发布事件 <br> * date: 2022/9/3 * @param event * @return void */ public void publishEvent(Object event){ applicationEventPublisher.publishEvent(new RefreshCacheEvent(this,(RefreshCache)event)); } } 复制代码
- 事件继承ApplicationEvent 声明事件的类型,同时监听器中通过入参的类型确定是哪一种事件监听
public class RefreshCacheEvent extends ApplicationEvent { private final RefreshCache refreshCache; public RefreshCache getRefreshCache() { return refreshCache; } public RefreshEvent(Object source, RefreshCache refreshCache) { super(source); Assert.notNull(refreshCache, "refreshCache must not be null"); this.refreshCache = refreshCache; } } 复制代码
- 监听器采用注解方式实现,@TransactionalEventListener 中间制定了监听器生效的时间,事件的类型,发生异常后如何处理
@Slf4j @Component @ConditionalOnBean(name={"refreshCacheService"}) public class RefreshCacheListener { @Resource private RefreshCacheService refreshCacheService; /*** * Desc: 门户缓存刷新事件 <br> * @TransactionalEventListener 注解表示此监听器是一个事务监听器,在事件发布方事务的对应阶段执行此监听器事件。 * phase 表示事务的阶段 * classes 表示监听的事件类型 * fallbackExecution 没有事务运行是否处理此事件,默认false */ @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT, classes = {RefreshCacheEvent.class}, fallbackExecution = true) public void onApplicationEvent(RefreshCacheEvent event){ //发送刷新缓存的消息 refreshCacheService.sendMessage(event.getRefreshCache().getType()); } } 复制代码
使用的地方注入 RefreshPublisher
refreshCachePublisher.publishEvent(refreshSingleJournalCache);