SpringApplication 將一個(gè)典型的 Spring 應(yīng)用啟動(dòng)的流程“模板化”(這里是動(dòng)詞),在沒有特殊需求的情況下率寡,默認(rèn)模板化后的執(zhí)行流程就可以滿足需求了但有特殊需求也沒關(guān)系貌夕,SpringApplication 在合適的流程結(jié)點(diǎn)開放了一系列不同類型的擴(kuò)展點(diǎn)整慎,我們可以通過這些擴(kuò)展點(diǎn)對(duì) SpringBoot 程序的啟動(dòng)和關(guān)閉過程進(jìn)行擴(kuò)展粱挡。
最“膚淺”的擴(kuò)展或者配置是 SpringApplication 通過一系列設(shè)置方法(setters)開放的定制方式层坠,比如,我們之前的啟動(dòng)類的 main 方法中只有一句:
SpringApplication.run(DemoApplication.class买猖,args);
但如果我們想通過 SpringApplication 的一系列設(shè)置方法來擴(kuò)展啟動(dòng)行為改橘,則可以用如下方式進(jìn)行:
public class DemoApplication {
public static void main(String[] args) {
// SpringApplication.run(DemoConfiguration.class, args);
SpringApplication bootstrap = new SpringApplication(Demo - Configuration.class);
bootstrap.setBanner(new Banner() {
@Override
public void printBanner(Environment environment, Class<?> aClass, PrintStream printStream) {
// 比如打印一個(gè)我們喜歡的ASCII Arts字符畫
}
});
bootstrap.setBannerMode(Banner.Mode.CONSOLE);
// 其他定制設(shè)置...
bootstrap.run(args);
}
}
設(shè)置自定義 banner 最簡(jiǎn)單的方式其實(shí)是把 ASCII Art 字符畫放到一個(gè)資源文件,然后通過 ResourceBanner 來加載:
bootstrap.setBanner(new ResourceBanner(new ClassPathResource("banner.txt")));
大部分情況下玉控,SpringApplication 已經(jīng)提供了很好的默認(rèn)設(shè)置飞主,所以,我們不再對(duì)這些表層進(jìn)行探究了高诺,因?yàn)閷?duì)表層之下的東西進(jìn)行探究才是我們的最終目的既棺。
深入探索 SpringApplication 執(zhí)行流程
SpringApplication 的 run 方法的實(shí)現(xiàn)是我們本次旅程的主要線路,該方法的主要流程大體可以歸納如下:
1)如果我們使用的是 SpringApplication 的靜態(tài) run 方法懒叛,那么丸冕,這個(gè)方法里面首先需要?jiǎng)?chuàng)建一個(gè) SpringApplication 對(duì)象實(shí)例,然后調(diào)用這個(gè)創(chuàng)建好的 SpringApplication 的實(shí)例 run方 法薛窥。在 SpringApplication 實(shí)例初始化的時(shí)候胖烛,它會(huì)提前做幾件事情:
根據(jù) classpath 里面是否存在某個(gè)特征類(org.springframework.web.context.ConfigurableWebApplicationContext)來決定是否應(yīng)該創(chuàng)建一個(gè)為 Web 應(yīng)用使用的 ApplicationContext 類型,還是應(yīng)該創(chuàng)建一個(gè)標(biāo)準(zhǔn) Standalone 應(yīng)用使用的 ApplicationContext 類型诅迷。
使用 SpringFactoriesLoader 在應(yīng)用的 classpath 中查找并加載所有可用的 ApplicationContextInitializer佩番。
使用 SpringFactoriesLoader 在應(yīng)用的 classpath 中查找并加載所有可用的 ApplicationListener。
推斷并設(shè)置 main 方法的定義類罢杉。
2)SpringApplication 實(shí)例初始化完成并且完成設(shè)置后趟畏,就開始執(zhí)行 run 方法的邏輯了,方法執(zhí)行伊始滩租,首先遍歷執(zhí)行所有通過 SpringFactoriesLoader 可以查找到并加載的 SpringApplicationRunListener赋秀,調(diào)用它們的 started() 方法,告訴這些 SpringApplicationRunListener律想,“嘿猎莲,SpringBoot 應(yīng)用要開始執(zhí)行咯!”技即。
3)創(chuàng)建并配置當(dāng)前 SpringBoot 應(yīng)用將要使用的 Environment(包括配置要使用的 PropertySource 以及 Profile)著洼。
4)遍歷調(diào)用所有 SpringApplicationRunListener 的 environmentPrepared()的方法,告訴它們:“當(dāng)前 SpringBoot 應(yīng)用使用的 Environment 準(zhǔn)備好咯而叼!”身笤。
5)如果 SpringApplication的showBanner 屬性被設(shè)置為 true,則打印 banner(SpringBoot 1.3.x版本葵陵,這里應(yīng)該是基于 Banner.Mode 決定 banner 的打印行為)液荸。這一步的邏輯其實(shí)可以不關(guān)心,我認(rèn)為唯一的用途就是“好玩”(Just For Fun)埃难。
6)根據(jù)用戶是否明確設(shè)置了applicationContextClass 類型以及初始化階段的推斷結(jié)果莹弊,決定該為當(dāng)前 SpringBoot 應(yīng)用創(chuàng)建什么類型的 ApplicationContext 并創(chuàng)建完成涤久,然后根據(jù)條件決定是否添加 ShutdownHook涡尘,決定是否使用自定義的 BeanNameGenerator忍弛,決定是否使用自定義的 ResourceLoader,當(dāng)然考抄,最重要的细疚,將之前準(zhǔn)備好的 Environment 設(shè)置給創(chuàng)建好的 ApplicationContext 使用。
7)ApplicationContext 創(chuàng)建好之后川梅,SpringApplication 會(huì)再次借助 Spring-FactoriesLoader疯兼,查找并加載 classpath 中所有可用的 ApplicationContext-Initializer,然后遍歷調(diào)用這些 ApplicationContextInitializer 的 initialize(applicationContext)方法來對(duì)已經(jīng)創(chuàng)建好的 ApplicationContext 進(jìn)行進(jìn)一步的處理贫途。
8)遍歷調(diào)用所有 SpringApplicationRunListener 的 contextPrepared()方法吧彪,通知它們:“SpringBoot 應(yīng)用使用的 ApplicationContext 準(zhǔn)備好啦!”
9)最核心的一步丢早,將之前通過 @EnableAutoConfiguration 獲取的所有配置以及其他形式的 IoC 容器配置加載到已經(jīng)準(zhǔn)備完畢的 ApplicationContext姨裸。
10)遍歷調(diào)用所有 SpringApplicationRunListener 的 contextLoaded() 方法,告知所有 SpringApplicationRunListener怨酝,ApplicationContext "裝填完畢"傀缩!
11)調(diào)用 ApplicationContext 的 refresh() 方法,完成 IoC 容器可用的最后一道工序农猬。
12)查找當(dāng)前 ApplicationContext 中是否注冊(cè)有 CommandLineRunner赡艰,如果有,則遍歷執(zhí)行它們斤葱。
13)正常情況下慷垮,遍歷執(zhí)行 SpringApplicationRunListener 的 finished() 方法,告知它們:“搞定揍堕!”换帜。(如果整個(gè)過程出現(xiàn)異常,則依然調(diào)用所有 SpringApplicationRunListener 的 finished() 方法鹤啡,只不過這種情況下會(huì)將異常信息一并傳入處理)惯驼。
至此,一個(gè)完整的 SpringBoot 應(yīng)用啟動(dòng)完畢递瑰!
整個(gè)過程看起來冗長(zhǎng)無比祟牲,但其實(shí)很多都是一些事件通知的擴(kuò)展點(diǎn),如果我們將這些邏輯暫時(shí)忽略抖部,那么说贝,其實(shí)整個(gè) SpringBoot 應(yīng)用啟動(dòng)的邏輯就可以壓縮到極其精簡(jiǎn)的幾步,如圖 1 所示慎颗。
圖 1 SpringBoot應(yīng)用啟動(dòng)步驟簡(jiǎn)要示意圖
前后對(duì)比我們就可以發(fā)現(xiàn)乡恕,其實(shí) SpringApplication 提供的這些各類擴(kuò)展點(diǎn)近乎“喧賓奪主”言询,占據(jù)了一個(gè) Spring 應(yīng)用啟動(dòng)邏輯的大部分“江山”,除了初始化并準(zhǔn)備好 ApplicationContext傲宜,剩下的大部分工作都是通過這些擴(kuò)展點(diǎn)完成的运杭,所以,我們接下來對(duì)各類擴(kuò)展點(diǎn)進(jìn)行逐一剖析函卒。
SpringApplicationRunListener
SpringApplicationRunListener 是一個(gè)只有 SpringBoot 應(yīng)用的 main 方法執(zhí)行過程中接收不同執(zhí)行時(shí)點(diǎn)事件通知的監(jiān)聽者:
public interface SpringApplicationRunListener {
void started();
void environmentPrepared(ConfigurableEnvironment environment);
void contextPrepared(ConfigurableApplicationContext context);
void contextLoaded(ConfigurableApplicationContext context);
void finished(ConfigurableApplicationContext context, Throwable exception);
}
對(duì)于我們來說辆憔,基本沒什么常見的場(chǎng)景需要自己實(shí)現(xiàn)一個(gè) Spring-ApplicationRunListener,即使 SpringBoot 默認(rèn)也只是實(shí)現(xiàn)了一個(gè) org.spring-framework.boot.context.event.EventPublishingRunListener报嵌,用于在 SpringBoot 啟動(dòng)的不同時(shí)點(diǎn)發(fā)布不同的應(yīng)用事件類型(ApplicationEvent)虱咧,如果有哪些 ApplicationListener 對(duì)這些應(yīng)用事件感興趣,則可以接收并處理锚国。
假設(shè)我們真的有場(chǎng)景需要自定義一個(gè) SpringApplicationRunListener 實(shí)現(xiàn)腕巡,那么有一點(diǎn)需要注意,即任何一個(gè) SpringApplicationRunListener 實(shí)現(xiàn)類的構(gòu)造方法(Constructor)需要有兩個(gè)構(gòu)造參數(shù)血筑,一個(gè)構(gòu)造參數(shù)的類型就是我們的 org.springframework.boot.SpringApplication绘沉,另外一個(gè)就是 args 參數(shù)列表的 String[]:
public class DemoSpringApplicationRunListener implements SpringApplicationRunListener {
@Override
public void started() {
// do whatever you want to do
}
@Override
public void environmentPrepared(ConfigurableEnvironment environment) {
// do whatever you want to do
}
@Override
public void contextPrepared(ConfigurableApplicationContext context) {
// do whatever you want to do
}
@Override
public void contextLoaded(ConfigurableApplicationContext context) {
// do whatever you want to do
}
@Override
public void finished(ConfigurableApplicationContext context, Throwable exception) {
// do whatever you want to do
}
}
之后,我們可以通過 SpringFactoriesLoader 立下的規(guī)矩云挟,在當(dāng)前 SpringBoot 應(yīng)用的 classpath 下的 META-INF/spring.factories 文件中進(jìn)行類似如下的配置:
org.springframework.boot.SpringApplicationRunListener=\com.keevol.springboot.demo.DemoSpringApplicationRunListener
然后 SpringApplication 就會(huì)在運(yùn)行的時(shí)候調(diào)用它啦梆砸!
ApplicationListener
ApplicationListener 其實(shí)是老面孔,屬于 Spring 框架對(duì) Java 中實(shí)現(xiàn)的監(jiān)聽者模式的一種框架實(shí)現(xiàn)园欣,這里唯一值得著重強(qiáng)調(diào)的是帖世,對(duì)于初次接觸 SpringBoot,但對(duì) Spring 框架本身又沒有過多接觸的開發(fā)者來說沸枯,可能會(huì)將這個(gè)名字與 SpringApplicationRunListener 混淆日矫。
關(guān)于 ApplicationListener 我們就不做過多介紹了,如果感興趣绑榴,請(qǐng)參考 Spring 框架相關(guān)的資料和書籍哪轿。
如果我們要為 SpringBoot 應(yīng)用添加自定義的 ApplicationListener,有兩種方式:
- 通過 SpringApplication.addListeners(..)或者 SpringApplication.setListeners(..)方法添加一個(gè)或者多個(gè)自定義的 ApplicationListener翔怎。
- 借助 SpringFactoriesLoader 機(jī)制窃诉,在 META-INF/spring.factories 文件中添加配置(以下代碼是為 SpringBoot 默認(rèn)注冊(cè)的 ApplicationListener 配置)。
org.springframework.context.ApplicationListener=
\org.springframework.boot.builder.ParentContextCloserApplicationListener,
\org.springframework.boot.cloudfoundry.VcapApplicationListener,
\org.springframework.boot.context.FileEncodingApplicationListener,
\org.springframework.boot.context.config.AnsiOutputApplicationListener,
\org.springframework.boot.context.config.ConfigFileApplicationListener,
\org.springframework.boot.context.config.DelegatingApplicationListener,
\org.springframework.boot.liquibase.LiquibaseServiceLocatorApplicat-ionListener,
\org.springframework.boot.logging.ClasspathLoggingApplicationListener,
\org.springframework.boot.logging.LoggingApplicationListener
關(guān)于 ApplicationListener赤套,我們就說這些飘痛。
ApplicationContextInitializer
ApplicationContextInitializer 也是 Spring 框架原有的概念,這個(gè)類的主要目的就是在 ConfigurableApplicationContext 類型(或者子類型)的 ApplicationContext 做 refresh 之前容握,允許我們對(duì) ConfigurableApplicationContext 的實(shí)例做進(jìn)一步的設(shè)置或者處理宣脉。
實(shí)現(xiàn)一個(gè) ApplicationContextInitializer 很簡(jiǎn)單,因?yàn)樗挥幸粋€(gè)方法需要實(shí)現(xiàn):
public class DemoApplicationContextInitializer implements ApplicationContextInitializer {
@Override
public void initialize(ConfigurableApplicationContext applicationContext) {
// do whatever you want with applicationContext,
// e.g.
applicationContext.registerShutdownHook();
}
}
不過剔氏,一般情況下我們基本不會(huì)需要自定義一個(gè) ApplicationContext-Initializer塑猖,即使 SpringBoot 框架默認(rèn)也只是注冊(cè)了三個(gè)實(shí)現(xiàn):
org.springframework.context.ApplicationContextInitializer=
\org.springframework.boot.context.ConfigurationWarningsApplication-ContextInitializer,
\org.springframework.boot.context.ContextIdApplicationContextInitia-lizer,
\org.springframework.boot.context.config.DelegatingApplicationContex-tInitializer
如果我們真的需要自定義一個(gè) ApplicationContextInitializer竹祷,那么只要像上面這樣,通過 SpringFactoriesLoader 機(jī)制進(jìn)行配置羊苟,或者通過 SpringApplication.addInitializers(..)設(shè)置即可塑陵。
CommandLineRunner
CommandLineRunner 是很好的擴(kuò)展接口,不是 Spring 框架原有的“寶貝”践险,它屬于 SpringBoot 應(yīng)用特定的回調(diào)擴(kuò)展接口猿妈。源碼如下所示:
public interface CommandLineRunner {
void run(String... args) throws Exception;
}
CommandLineRunner 需要大家關(guān)注的其實(shí)就兩點(diǎn):
1)所有 CommandLineRunner 的執(zhí)行時(shí)點(diǎn)在 SpringBoot 應(yīng)用的 Application-Context 完全初始化開始工作之后(可以認(rèn)為是 main 方法執(zhí)行完成之前最后一步)吹菱。
2)只要存在于當(dāng)前 SpringBoot 應(yīng)用的 ApplicationContext 中的任何 Command-LineRunner巍虫,都會(huì)被加載執(zhí)行(不管你是手動(dòng)注冊(cè)這個(gè) CommandLineRunner 到 IoC 容器,還是自動(dòng)掃描進(jìn)去的)鳍刷。
與其他幾個(gè)擴(kuò)展點(diǎn)接口類型相似占遥,建議 CommandLineRunner 的實(shí)現(xiàn)類使用 @org.springframework.core.annotation.Order 進(jìn)行標(biāo)注或者實(shí)現(xiàn) org.springframework.core.Ordered 接口,便于對(duì)它們的執(zhí)行順序進(jìn)行調(diào)整输瓜,這其實(shí)十分重要瓦胎,我們不希望順序不當(dāng)?shù)?CommandLineRunner 實(shí)現(xiàn)類阻塞了后面其他 CommandLineRunner 的執(zhí)行。