SpringBoot源码-启动

SpringBoot源码-启动

源码解析

SpringBoot 的启动很简单,一行代码就能完成:

@SpringBootApplication
public class MySpringApplication {
    public static void main(String[] args) {
        ApplicationContext applicationContext = SpringApplication.run(MySpringApplication.class, args);
    }
}

但在这简单的代码背后,SpringBoot帮助我们完成了事件的注册,容器的生成。今天追踪源码,看一下SpringBoot的启动背后,究竟做了哪些事情。

SpringApplication.run()的执行会首先新建一个SpringApplication的实例,然后调用实例的run函数。

    public static ConfigurableApplicationContext run(Object source, String... args) {
        return run(new Object[] { source }, args);
    }
    
    public static ConfigurableApplicationContext run(Object[] sources, String[] args) {
        return new SpringApplication(sources).run(args);
    }

新建SpringApplication实例,会调用initialize方法。

    public SpringApplication(Object... sources) {
        initialize(sources);
    }

    private void initialize(Object[] sources) {
        // 将source加载近实例的sources属性中
        if (sources != null && sources.length > 0) {
            this.sources.addAll(Arrays.asList(sources));
        }
        // bool类型,用来标识当前的环境是否为web环境
        this.webEnvironment = deduceWebEnvironment();
        // 将spring.factories中的ApplicationContextInitializer加载入实例的属性中
        setInitializers((Collection) getSpringFactoriesInstances(
                ApplicationContextInitializer.class));
        // 将spring.factories中的ApplicationListener加载入实例的属性中
        setListeners((Collection) getSpringFactoriesInstances(ApplicationListener.class));
        // trace 递归找出main函数所在的类
        this.mainApplicationClass = deduceMainApplicationClass();
    }

其中:

  1. deduceWebEnvironment函数用来判断当前的Application是否为web环境,判断的方法是去尝试实例化Servlet,ConfigurableWebApplicationContext,如果成功,则认为是,反之则为否。
  2. setInitializerssetListeners是通过扫描spring.factories文件来完成的。该文件的位置为jar包的resource/META-INF文件夹下,需要注意的是,文件可以存在于多个jar包中,这不影响springboot启动时的扫描,所以如果需要自定义启动类和监听类,只需要在自己的jar包中添加文件即可。

SpringApplication的实例化完成后,就是执行run方法:

   public ConfigurableApplicationContext run(String... args) {
        // 构建了一个任务执行的观察器,通过start和stop可以完成任务的计时
        StopWatch stopWatch = new StopWatch();
        stopWatch.start();
        ConfigurableApplicationContext context = null;
        configureHeadlessProperty();
        // 获取SpringApplicationRunListeners,内部只有一个EventPublishingRunListener
        SpringApplicationRunListeners listeners = getRunListeners(args);
        // 通过EventPublishingRunListener向所有注册的listener类发送ApplicationStartedEvent事件
        listeners.started();
        try {
            // 构造一个应用程序参数持有类
            ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
            // 创建spring容器
            context = createAndRefreshContext(listeners, applicationArguments);
            // spring容器创建完成后的回调任务
            afterRefresh(context, applicationArguments);
            // 通过EventPublishingRunListener向所有注册的listener类发送getFinishedEvent事件
            listeners.finished(context, null);
            // stop记录point
            stopWatch.stop();
            if (this.logStartupInfo) {
                new StartupInfoLogger(this.mainApplicationClass)
                        .logStarted(getApplicationLog(), stopWatch);
            }
            // 返回ConfigurableApplicationContext
            return context;
        }
        catch (Throwable ex) {
            handleRunFailure(context, listeners, ex);
            throw new IllegalStateException(ex);
        }
    }

首先来说明一下SpringApplicationRunListeners,这个类在SpringBoot中只有一个实现:EventPublishingRunListener。该类的ApplicationEventMulticaster成员,其实充当了一个送报员的角色,在收到了报纸(主线程的通知)后,将根据订阅的人员名单(在Application中注册的Listener列表),进行事件的分发通知。执行的步骤如图:

@SpringApplicationRunListener执行步骤|center

具体的代码简略如下:

public class EventPublishingRunListener implements SpringApplicationRunListener, Ordered {

    private final ApplicationEventMulticaster multicaster;
    
    ……

    @Override
    public void finished(ConfigurableApplicationContext context, Throwable exception) {
        publishEvent(getFinishedEvent(context, exception));
    }

    ……

    // 事件的分发
    private void publishEvent(SpringApplicationEvent event) {
        this.multicaster.multicastEvent(event);
    }
    
}

这样就很容易理解run函数中的listener.start()listener.stop()的作用了,用来标记启动的状态并通知各个注册的listener作出相应的操作。

createAndRefreshContext 是创建Spring容器的过程:

   private ConfigurableApplicationContext createAndRefreshContext(
            SpringApplicationRunListeners listeners,
            ApplicationArguments applicationArguments) {
        // 定义spring容器 context
        ConfigurableApplicationContext context;
        // 根据之前的webEnvironment来初始化相应的环境
        //(StandardEnvironment或者StandardServletEnvironment)
        ConfigurableEnvironment environment = getOrCreateEnvironment();
        // 配置环境信息
        configureEnvironment(environment, applicationArguments.getSourceArgs());
        // 通过EventPublishingRunListener向所有注册的listener类
        // 发送ApplicationEnvironmentPreparedEvent事件
        listeners.environmentPrepared(environment);
        // 重新校验环境信息
        if (isWebEnvironment(environment) && !this.webEnvironment) {
            environment = convertToStandardEnvironment(environment);
        }
        
        // print 环境信息
        if (this.bannerMode != Banner.Mode.OFF) {
            printBanner(environment);
        }

        // Create, load, refresh and run the ApplicationContext
        // 创建Spring容器
        context = createApplicationContext();
        // 配置Spring容器
        context.setEnvironment(environment);
        // Spring容器创建之后需要做的回调方法
        postProcessApplicationContext(context);
        // 执行 SpringApplication 的初始化器
        applyInitializers(context);
        // 遍历调用SpringApplicationRunListener的contextPrepared方法
        // 查看代码来看,只是将ApplicationEventMulticaster注册到Spring容器中
        listeners.contextPrepared(context);
        if (this.logStartupInfo) {
            logStartupInfo(context.getParent() == null);
            logStartupProfileInfo(context);
        }

        // Add boot specific singleton beans
        // 把应用程序参数持有类注册到Spring容器中,并且是一个单例
        context.getBeanFactory().registerSingleton("springApplicationArguments",
                applicationArguments);

        // Load the sources
        Set<Object> sources = getSources();
        Assert.notEmpty(sources, "Sources must not be empty");
        load(context, sources.toArray(new Object[sources.size()]));
        // 通过EventPublishingRunListener广播发送ApplicationPreparedEvent给所有注册的listener类
        listeners.contextLoaded(context);

        // Refresh the context
        // 刷新Spring容器
        refresh(context);
        if (this.registerShutdownHook) {
            try {
                context.registerShutdownHook();
            }
            catch (AccessControlException ex) {
                // Not allowed in some environments.
            }
        }
        return context;
    }

Spring容器的创建:

   protected ConfigurableApplicationContext createApplicationContext() {
        Class<?> contextClass = this.applicationContextClass;
        if (contextClass == null) {
            try {
                // 如果是web程序,那么构造AnnotationConfigEmbeddedWebApplicationContext容器
                // 否则构造AnnotationConfigApplicationContext容器
                // 这里也是利用了初始化SpringApplication的webEnvironment变量
                contextClass = Class.forName(this.webEnvironment
                        ? DEFAULT_WEB_CONTEXT_CLASS : DEFAULT_CONTEXT_CLASS);
            }
            catch (ClassNotFoundException ex) {
                throw new IllegalStateException(
                        "Unable create a default ApplicationContext, "
                                + "please specify an ApplicationContextClass",
                        ex);
            }
        }
        return (ConfigurableApplicationContext) BeanUtils.instantiate(contextClass);
    }

Spring容器创建之后的后续操作:

   protected void postProcessApplicationContext(ConfigurableApplicationContext context) {
        if (this.webEnvironment) {
            // web环境 && Spring环境 注册实例命名生成器(后续章节详细讲)
            if (context instanceof ConfigurableWebApplicationContext) {
                ConfigurableWebApplicationContext configurableContext = (ConfigurableWebApplicationContext) context;
                if (this.beanNameGenerator != null) {
                    configurableContext.getBeanFactory().registerSingleton(
                            AnnotationConfigUtils.CONFIGURATION_BEAN_NAME_GENERATOR,
                            this.beanNameGenerator);
                }
            }
        }

        // 设置资源loader
        if (this.resourceLoader != null) {
            if (context instanceof GenericApplicationContext) {
                ((GenericApplicationContext) context)
                        .setResourceLoader(this.resourceLoader);
            }
            if (context instanceof DefaultResourceLoader) {
                ((DefaultResourceLoader) context)
                        .setClassLoader(this.resourceLoader.getClassLoader());
            }
        }
    }

applyInitialzers,遍历初始化时加载的Initialzer类,并执行initialize方法。
比如ContextIdApplicationContextInitializer会设置应用程序的id;AutoConfigurationReportLoggingInitializer会给应用程序添加一个条件注解解析器报告等:

    protected void applyInitializers(ConfigurableApplicationContext context) {
        for (ApplicationContextInitializer initializer : getInitializers()) {
            Class<?> requiredType = GenericTypeResolver.resolveTypeArgument(
                    initializer.getClass(), ApplicationContextInitializer.class);
            Assert.isInstanceOf(requiredType, context, "Unable to call initializer.");
            initializer.initialize(context);
        }
    }

Spring容器的refresh方法中会执行很多事情:例如BeanFactory的设置,BeanFactoryPostProcessor接口的执行、BeanPostProcessor接口的执行、自动化配置类的解析、条件注解的解析、国际化的初始化等等。后续详细说明。

run方法中在执行完毕createAndRefreshContext后,还执行了afterRefresh函数

   protected void afterRefresh(ConfigurableApplicationContext context,
            ApplicationArguments args) {
        // 已弃用
        afterRefresh(context, args.getSourceArgs());
        // 加载runner
        callRunners(context, args);
    }
    
    private void callRunners(ApplicationContext context, ApplicationArguments args) {
        List<Object> runners = new ArrayList<Object>();
        // 找出Spring容器中ApplicationRunner接口的实现类
        runners.addAll(context.getBeansOfType(ApplicationRunner.class).values());
        // 找出Spring容器中CommandLineRunner接口的实现类
        runners.addAll(context.getBeansOfType(CommandLineRunner.class).values());
        // 排序
        AnnotationAwareOrderComparator.sort(runners);
        // 遍历执行run
        for (Object runner : new LinkedHashSet<Object>(runners)) {
            if (runner instanceof ApplicationRunner) {
                callRunner((ApplicationRunner) runner, args);
            }
            if (runner instanceof CommandLineRunner) {
                callRunner((CommandLineRunner) runner, args);
            }
        }
    }

自此而止,整个SpringBoot的启动就已经完成了,各种监听器,各种初始化器,各种Runner也已经完成了对于的工作

总结

SpringBoot在启动的过程中主要分为两个部分:SpringApplication的初始化实例的run方法:

1. SpringApplication的初始化
  1. 设置source到实例的属性
  2. 检验web环境并标识
  3. 找出需要处理的所有initializerslistener,设置到实例的属性中
  4. 找出main函数所在的类
2. 实例的run方法
  • 1.设置事件分发器,充当送报员的角色
  • 2.构造Spring容器
    • 2.1 创建Spring容器
    • 2.2 遍历执行initializersinitialize方法
    • 2.3 Spring容器的刷新(完成bean的解析、各种processor接口的执行、条件注解的解析等)
  • 3.从Spring容器中找出ApplicationRunnerCommandLineRunner接口的实现类并排序后依次执行
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,772评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,458评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,610评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,640评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,657评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,590评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,962评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,631评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,870评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,611评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,704评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,386评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,969评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,944评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,179评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,742评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,440评论 2 342

推荐阅读更多精彩内容