一、SpringApplication的几种常用方式
在之前的两篇SpringBoot 入门介绍中,都使用了在main方法中执行SpringApplication.run()这种方式来启动我们的工程
// 方式一
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
如果我们需要在SpringBoot启动过程中添加一些定制代码(如定制启动Banner,设置自定义监听器等),这种方式就无法满足我们的要求了,因此,官方文档提供了其他的启动方式来满足我们定制需求。在给出官方文档提供的启动方式之前,我们进入SpringApplication.run()方法简单看下底层做了些什么动作。
可以看到,SpringApplication.run()的底层其实就是new了一个SpringApplication的对象,并执行run()方法,run()方法里面执行了哪些动作在之后的文章中详细说明。接着我们来看官方文档提供的启动方式
// 方式二
public static void main(String[] args) {
SpringApplication app = new SpringApplication(MySpringConfiguration.class);
app.run(args);
}
到了这里,就不在多说什么了。
有时我们需要创建多层次的ApplicationContext (例如,父子关系的Spring的ApplicationContext 和SpringMVC),这时我们可以使用官方提供的另外一种“平滑”的API调用方式来启动工程,即使用SpringApplicationBuilder讲多个方法调用串起来,通过parent() 和 child()来创建多层次的ApplicationContext。如果查看底层代码,可以看到除了调用child()方法略有不同,其他的和前两种方法几乎一样。
// 方式三
public static void main(String[] args) {
new SpringApplicationBuilder()
.sources(Parent.class)
.child(Application.class)
.run(args);
}
以上三方式是SpringBoot最常用的启动方式,当然,官方还提供了通过配置application.properties文件在SpringBoot启动过程中添加一些定制逻辑的方案。
二、定制启动Banner
SpringBoot为我们提供了修改Banner的方法。我们可以在类路径下banner.txt、banner.gif、banner.jpg或者banner.png来定制Banner(banner.gif、banner.jpg或者banner.png会“翻译”成对应的ASCII艺术图案),当然,我们也可以在SpringBoot配置文件中指定banner.location或者banner.image.location对应的Banner路径来定制Banner。
需要注意的是,当文本文件(banner.txt)和图像文件(banner.gif/jpg/png)是可以同时在控制台显示,但如果有多个图像文件,只会显示其中排序靠后的一个(即优先级png>jpg>gif)。
在banner.txt中还支持使用一些变量:
spring−boot.version:SpringBoot的版本spring−boot.version:SpringBoot的版本{spring-boot.formatted-version}:格式化后的SpringBoot的版本
application.version:应用版本(在MANIFEST.MF文件中定义)application.version:应用版本(在MANIFEST.MF文件中定义){application.formatted-version}:格式化后的应用版本(在MANIFEST.MF文件中定义)
application.title:应用名称(在MANIFEST.MF文件中定义)application.title:应用名称(在MANIFEST.MF文件中定义){Ansi.NAME} (AnsiColor.NAME,AnsiColor.NAME,{AnsiBackground.NAME}, ${AnsiStyle.NAME}): ANSI控制码
如果我们通过代码生成定制的Banner,那么可以自己实现Banner接口,通过实现printBanner()方法,并结合使用SpringApplication.setBanner()或者SpringApplicationBuilder.banner()的方式来打印定制的Banner。
如果我们不想打印Banner,可以使用通过在代码中设置Banner.Mode.OFF的方式关闭Banner打印。当然,也可以通过在配置文件中设置 spring.main.banner-mode=off 的方式进行关闭。
public class Application {
public static void main(String[] args) {
SpringApplication application = new SpringApplication(Application.class);
// 方式一
application.setBannerMode(Banner.Mode.OFF);
application.run(args);
// 方式二
/*new SpringApplicationBuilder()
.sources(Application.class)
.bannerMode(Banner.Mode.OFF)
.run(args);*/
}
}
三、SpringBoot事件和监听器
事件是用来通知监听事件的监听器某件事情的处理状态,在SpringBoot启动过程中,除了Spring框架的事件外,SpringBoot还会触发其他的一些事件,这些事件按下列顺序触发:
(1)ApplicationStartingEvent:项目刚启动时触发,此时除了注册监听器和初始器之外,其他所有处理都没有开始;
(2)ApplicationEnvironmentPreparedEvent:上下文得到环境信息之后触发,此时上下文创建还没有创建;
(3)ApplicationPreparedEvent:bean的定义信息加载完成之后触发,此时bean还没有初始化;
(4)ApplicationReadyEvent:在所有bean初始化完毕,所有回调处理完成,系统准备处理服务请求时触发;
(5)ApplicationFailedEvent:启动过程出现异常时候触发。
知道SpringBoot启动时发送的时间后,我们就能自定义监听器对这些事件进行监听,从而达到扩展启动流程的目的。我们的自定义监听器需要实现ApplicationListener接口,同时指定需要监听哪个事件。
然后在main方法中,将自定义监听器加入到SpringApplication中。
除了上述代码的方式添加监听器外,还可以通过在classpath下创建META-INF/spring.factories文件,并将自定义监听器通过键值对的形式(org.springframework.context.ApplicationListener = com.qzc.demo4.MyListener)加入到SpringApplication中。
四、SpringBoot的Web环境信息
ApplicationContext是Spring框架中一个很重要的接口,它扩展了BeanFactory,增加了很多常用的功能。SpringBoot启动过程中,SpringApplication通常会选择合适的ApplicationContext实现类,在默认情况下,如果是Web应用,则会创建AnnotationConfigEmbeddedWebApplicationContext类的对象;否则会创建AnnotationConfigApplicationContext类的对象。
通过查看SpringApplication,run()的底层代码,可以看到,创建什么类型的ApplicationContext是由 webEnvironment 这个布尔变量来决定的,而 webEnvironment 这个变量是由项目的classpath下是否存在javax.servlet.Servlet或者org.springframework.web.context.ConfigurableWebApplicationContext,如果存在其中的一个,则为true;否则为false。
我们可以通过SpringApplication.setWebEnvironment()方法来改变webEnvironment 变量从而改变ApplicationContext的具体类型。当然,我们还可以通过setApplicationContextClass()方法来完全定制ApplicationContext。
SpringApplication application = new SpringApplication(Application.class);
application.setWebEnvironment(false);
// application.setApplicationContextClass(...);
application.run(args);
五、SpringBoot的ApplicationRunner接口 和 CommandLineRunner接口
如果我们想在SpringBoot启动时传入一些参数进行一些特殊的业务逻辑处理,此时我们可以去实现ApplicationRunner 或者 CommandLineRunner 接口,这两个接口都只有一个run()方法,该run()方法会在SpringApplication.run() 完成之前被调用。另外,如果我们有多个类实现了ApplicationRunner 或者 CommandLineRunner 接口,我们可以在该类上标注@Order注解或者让该类再实现org.springframework.core.Ordered接口来保证执行的顺序。
ApplicationRunner 和 CommandLineRunner 的区别就是封装参数的形式不一样,ApplicationRunner将参数封装到ApplicationArguments类中,而CommandLineRunner 将参数传到String可变数组中。
@Component
@Order(1) // 数值越小,优先级越高
public class MyCommandLineRunner implements CommandLineRunner {
//public class MyCommandLineRunner implements CommandLineRunner, Order {
@Override
public void run(String... args) {
if (args != null) {
for (String s : args) {
System.out.println("MyCommandLineRunner:" + s);
}
}
}
}
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication application = new SpringApplication(Application.class);
application.run(args);
}
}