Spring源码阅读----Spring事件监听机制

概述

经过IoC的解析,我们需要将注意力再拉回到refresh方法中。我们还有这几个方法还没解析完:

image.png

这里继续,先来讲Spring事件监听机制。

Spring事件监听

在业务开发过程中为了解耦,我们可能或多或少接触过MQ消息队列这东西或者对设计模式中的观察者模式了解的话,实现事件监听需要的组成部分有这几个:

  • 事件(Event)
  • 事件生产者(Publisher)
  • 事件消费者(Consumer)
  • 管理中介(Broker)

是不是很熟悉?Spring中是用事件、事件监听器、事件发布者和事件广播器来实现

  • 事件(ApplicationEvent)
  • 事件监听器(ApplicationListener)
  • 事件发布者(ApplicationEventPublisher)
  • 事件广播器(ApplicationEventMulticaster)

它们的关系如下图:

Spring事件

那这里解析一下refresh中的这几个方法:
initApplicationEventMulticaster():初始化应用的事件广播器(见源码解析1)
registerListeners():注册监听器(见源码解析2)
finishRefresh():完成上下文的刷新工作(见源码解析3)

【源码解析1】 初始化应用的事件广播器:initApplicationEventMulticaster方法

    protected void initApplicationEventMulticaster() {
        ConfigurableListableBeanFactory beanFactory = getBeanFactory();

        // 如有有自己注册class Name 是 applicationEventMulticaster,使用自定义广播器
        //APPLICATION_EVENT_MULTICASTER_BEAN_NAME = "applicationEventMulticaster"
        if (beanFactory.containsLocalBean(APPLICATION_EVENT_MULTICASTER_BEAN_NAME)) {
            this.applicationEventMulticaster =
                    beanFactory.getBean(APPLICATION_EVENT_MULTICASTER_BEAN_NAME, ApplicationEventMulticaster.class);
            if (logger.isTraceEnabled()) {
                logger.trace("Using ApplicationEventMulticaster [" + this.applicationEventMulticaster + "]");
            }
        }
        else {
            // 没有自定义,使用默认的事件广播器
            this.applicationEventMulticaster = new SimpleApplicationEventMulticaster(beanFactory);
            beanFactory.registerSingleton(APPLICATION_EVENT_MULTICASTER_BEAN_NAME, this.applicationEventMulticaster);
            if (logger.isTraceEnabled()) {
                logger.trace("No '" + APPLICATION_EVENT_MULTICASTER_BEAN_NAME + "' bean, using " +
                        "[" + this.applicationEventMulticaster.getClass().getSimpleName() + "]");
            }
        }
    }

事件广播器beanName :applicationEventMulticaster。
如果有自定义的广播器已经在beanFactory中注册,则使用该广播器;
若没有自定义的广播器的情况下,创建一个默认的事件广播器SimpleApplicationEventMulticaster,查看一下其类图:

SimpleApplicationEventMulticaster

【源码解析2】 注册监听器 : registerListeners方法

    protected void registerListeners() {
        // Register statically specified listeners first.
        // 这里是硬编码注册的监听器((可以通过自定义ApplicationContextInitializer添加))
        for (ApplicationListener<?> listener : getApplicationListeners()) {
            getApplicationEventMulticaster().addApplicationListener(listener);
        }

        // Do not initialize FactoryBeans here: We need to leave all regular beans
        // uninitialized to let post-processors apply to them!
        // 不要在这里初始化 factoryBean : 我们需要保留所有常规 bean 未初始化,以便让后处理程序应用于它们!
        // 通过配置文件或注解注入BeanFactory的监听器处理
        String[] listenerBeanNames = getBeanNamesForType(ApplicationListener.class, true, false);
        for (String listenerBeanName : listenerBeanNames) {
            getApplicationEventMulticaster().addApplicationListenerBean(listenerBeanName);
        }

        // Publish early application events now that we finally have a multicaster...
        // 使用事件广播器,发布早期应用程序事件到相应的监听器
        Set<ApplicationEvent> earlyEventsToProcess = this.earlyApplicationEvents;
        this.earlyApplicationEvents = null;
        if (earlyEventsToProcess != null) {
            for (ApplicationEvent earlyEvent : earlyEventsToProcess) {
                getApplicationEventMulticaster().multicastEvent(earlyEvent);
            }
        }
    }

到这个阶段,事件广播器和监听器都在Spring容器里初始化和注册了,之后就可以实现监听者模式了,对事件的发布进行监听然后处理。继续看finishRefresh里的内容。

finishRefresh

finishRefresh方法源码如下:

    protected void finishRefresh() {
        // Clear context-level resource caches (such as ASM metadata from scanning).
        //清除resourceCaches资源缓存中的数据
        clearResourceCaches();

        // Initialize lifecycle processor for this context.
        //注释1. 为此上下文初始化生命周期处理器
        initLifecycleProcessor();

        // Propagate refresh to lifecycle processor first.
        //注释2. 首先将刷新完毕事件传播到生命周期处理器(触发isAutoStartup方法返回true的SmartLifecycle的start方法)
        getLifecycleProcessor().onRefresh();

        // Publish the final event.
        //注释3. 推送上下文刷新完毕事件到相应的监听器
        publishEvent(new ContextRefreshedEvent(this));

        // Participate in LiveBeansView MBean, if active.
        LiveBeansView.registerApplicationContext(this);
    }

这里主要讲注释3,另外的解析放到后文里详解。
注释3.推送上下文刷新完毕事件到相应的监听器 publishEvent(见源码解析4)

【源码解析4】 推送上下文刷新完毕事件到相应的监听器:publishEvent方法

    @Override
    public void publishEvent(Object event) {
        publishEvent(event, null);
    }

protected void publishEvent(Object event, @Nullable ResolvableType eventType) {
        Assert.notNull(event, "Event must not be null");

        // Decorate event as an ApplicationEvent if necessary
        //如果必需的话把event装饰成ApplicationEvent 
        ApplicationEvent applicationEvent;
        if (event instanceof ApplicationEvent) {
            applicationEvent = (ApplicationEvent) event;
        }
        else {
            applicationEvent = new PayloadApplicationEvent<>(this, event);
            if (eventType == null) {
                eventType = ((PayloadApplicationEvent<?>) applicationEvent).getResolvableType();
            }
        }

        // Multicast right now if possible - or lazily once the multicaster is initialized
        if (this.earlyApplicationEvents != null) {
            this.earlyApplicationEvents.add(applicationEvent);
        }
        else {
            //注释1. 使用事件广播器广播事件到相应的监听器
            getApplicationEventMulticaster().multicastEvent(applicationEvent, eventType);
        }

        // Publish event via parent context as well...
        // 通过parent发布事件
        if (this.parent != null) {
            if (this.parent instanceof AbstractApplicationContext) {
                ((AbstractApplicationContext) this.parent).publishEvent(event, eventType);
            }
            else {
                this.parent.publishEvent(event);
            }
        }
    }

注释1. 使用事件广播器广播事件到相应的监听器
getApplicationEventMulticaster()获取事件广播器
multicastEvent()广播事件到相应的监听器(见源码解析5)

【源码解析5】 SimpleApplicationEventMulticaster类的multicastEvent方法

    @Override
    public void multicastEvent(ApplicationEvent event) {
        multicastEvent(event, resolveDefaultEventType(event));
    }

    @Override
    public void multicastEvent(final ApplicationEvent event, @Nullable ResolvableType eventType) {
        ResolvableType type = (eventType != null ? eventType : resolveDefaultEventType(event));

        //获取任务执行器executor 
        Executor executor = getTaskExecutor();

        // 遍历注册的消息监听器(getApplicationListeners)
        for (ApplicationListener<?> listener : getApplicationListeners(event, type)) {
            if (executor != null) {
                //executor不为null,则使用executor调用监听器
                executor.execute(() -> invokeListener(listener, event));
            }
            else {
                // 直接调用监听器
                invokeListener(listener, event);
            }
        }
    }

在前面我们已经提到过SimpleApplicationEventMulticaster,是Spring默认的事件广播器。
调用监听器invokeListener方法(见源码解析6)

【源码解析6】 调用监听器:invokeListener方法,真正做事的为doInvokeListener方法

    protected void invokeListener(ApplicationListener<?> listener, ApplicationEvent event) {
        ErrorHandler errorHandler = getErrorHandler();
        if (errorHandler != null) {
            try {
                doInvokeListener(listener, event);
            }
            catch (Throwable err) {
                errorHandler.handleError(err);
            }
        }
        else {
            doInvokeListener(listener, event);
        }
    }

    //执行调用监听器
    private void doInvokeListener(ApplicationListener listener, ApplicationEvent event) {
        try {

            //触发监听器的onApplicationEvent方法,参数为给定的事件
            listener.onApplicationEvent(event);
        }
        catch (ClassCastException ex) {
            String msg = ex.getMessage();
            if (msg == null || matchesClassCastMessage(msg, event.getClass())) {
                // Possibly a lambda-defined listener which we could not resolve the generic event type for
                // -> let's suppress the exception and just log a debug message.
                Log logger = LogFactory.getLog(getClass());
                if (logger.isTraceEnabled()) {
                    logger.trace("Non-matching event type for listener: " + listener, ex);
                }
            }
            else {
                throw ex;
            }
        }
    }

好了,在这里我们可以发现,监听器里边的onApplicationEvent方法被触发了,所以,从这一个流程下来,我们可以看到一个事件的发布,可以筛选出对应的监听器并触发其onApplicationEvent,执行相应的操作。

自定义一个事件和监听器
1.创建一个下单事件OrderEvent

public class OrderEvent extends ApplicationEvent{
                
         public OrderEvent(ApplicationContext source) {
             super(source);
             System.out.println("构建下单事件");
         }
}
  1. 创建一个监听器监听下单事件
@Component
public class OrderListener implements ApplicationListener<OrderEvent>  {

    @Override
    public void onApplicationEvent(OrderEvent orderEvent) {
        System.out.println("订单监听器监听到下单事件,订单号为:20210201100001");
        //后续业务逻辑....
    }
}
  1. 在前文的demo基础上,修改main函数
public  class App {

    public static void main(String[] args) throws ClassNotFoundException {
        ClassPathXmlApplicationContext context =
                new ClassPathXmlApplicationContext("applicationContext.xml");
        OrderEvent orderEvent = new OrderEvent(context);
        context.publishEvent(orderEvent);
    }
}

这样容器初始化后,会执行发布下单事件,并将事件推送到OrderListener 监听器中,并触发onApplicationEvent,执行效果如下:

OrderEvent

※Spring的事件监听机制是同步处理的,具体留给大家自己探索一下,可以打印每个事件监听器处理时的线程名,是否跟主线程是同一个。是否可以进行异步改造?

如果一个事件有多个监听器,如何给这些监听器排序呢?
用前文解析代码的时候提到的 ,bean实现Ordered接口和PriorityOrdered接口
这样重写其getOrder方法,设置这些监听器的触发顺序。

总结

好了,事件监听机制就介绍到这里,掌握观察者模式以及ApplicationEventMulticaster、ApplicationListener、ApplicationEvent、ApplicationEventPublisher这几个组件的关系,以及事件触发执行流程。下一节介绍finishRefresh中剩下的几个方法。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 193,968评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,682评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,254评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,074评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,964评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,055评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,484评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,170评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,433评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,512评论 2 308
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,296评论 1 325
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,184评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,545评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,150评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,437评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,630评论 2 335