Spring Boot 特性 —— SpringApplication

使用 SpringApplication 引导项目启动

SpringApplication 类为我们引导项目提供了一种便利的方式——通过 main() 方法直接启动。大多数情况下，我们可以把项目启动这个任务直接委托给 SpringApplication.run 方法：

public  static  void  main(String\[\] args) { SpringApplication.run(MySpringConfiguration.class, args); }

启动完成以后，你可以看到控制台输出如下：

 .   ____          _            __ _ _

 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::   v1.4.1.RELEASE

2013-07-31 00:08:16.117  INFO 56603 --- [           main] o.s.b.s.app.SampleApplication            : Starting SampleApplication v0.1.0 on mycomputer with PID 56603 (/apps/myapp.jar started by pwebb)
2013-07-31 00:08:16.166  INFO 56603 --- [           main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@6e5a8246: startup date [Wed Jul 31 00:08:16 PDT 2013]; root of context hierarchy
2014-03-04 13:09:54.912  INFO 41370 --- [           main] .t.TomcatEmbeddedServletContainerFactory : Server initialized with port: 8080
2014-03-04 13:09:56.501  INFO 41370 --- [           main] o.s.b.s.app.SampleApplication            : Started SampleApplication in 2.992 seconds (JVM running for 3.658)```
Spring Boot 默认会输出`INFO`级别的日志，还包括一些相关的启动详细信息。

如果启动失败，Spring Boot 的`FailureAnalyzers`就会输出相关的错误信息，然后一个专用的处理器会对这个错误进行相关的处理。Spring Boot 提供了很多这样的失败分析器，如果还不能满足要求，你也可以自己通过实现`FailureAnalyzer`接口来构建自己的错误分析器。当然，如果你想看到更详细的异常输出，你可以通过设置以下日志处理类的debug属性或者设置日志级别为`DEBUG`模式来达到这个目的。

org.springframework.boot.autoconfigure.logging.AutoConfigurationReportLoggingInitializer

如果你使用`java -jar`命令来启动项目，那么你可以通过如下方式来设置debug属性：

$ java -jar myproject-0.0.1-SNAPSHOT.jar --debug

配置Banner
--------

你可以通过添加一个`banner.txt`文件到你的classpath路径下，来改变在启动的时候打印的banner信息，或者通过设置`banner.location`属性来设置该文件的位置，通过`banner.charset`来设置文件的编码，你也可以添加`banner.gif`,`banner.jpg`,`` `banner.png``图片文件到classpath，或者通过设置`banner.image.location`属性来作为banner信息，这些图片会被转换为有艺术感的ASCII，并且打印在文本的顶部。`banner.txt`中可以设置如下的占位符：

|变量|描述|
| - | :-: | -: |
|`${application.version}`|The version number of your application as declared in`MANIFEST.MF`. For example`Implementation-Version: 1.0`is printed as`1.0`.|
|`${application.formatted-version}`|The version number of your application as declared  in`MANIFEST.MF`formatted for display (surrounded with brackets and prefixed with`v`). For example`(v1.0)`.|
|`${spring-boot.version}`|The Spring Boot version that you are using. For example`1.4.1.RELEASE`.|
|`${spring-boot.formatted-version}`|The Spring Boot version that you are using formatted for display (surrounded with brackets and prefixed with`v`). For example`(v1.4.1.RELEASE)`.|
|`${Ansi.NAME}`(or`${AnsiColor.NAME}`,`${AnsiBackground.NAME}`,`${AnsiStyle.NAME}`)|Where`NAME`is the name of an ANSI escape code. See[AnsiPropertySource](https://github.com/spring-projects/spring-boot/blob/v1.4.1.RELEASE/spring-boot/src/main/java/org/springframework/boot/ansi/AnsiPropertySource.java)for details.|
|`${application.title}`|The title of your application as declared in`MANIFEST.MF`. For example`Implementation-Title: MyApp`is printed as`MyApp`.|

可以通过设置`spring.main.banner-mode`属性来控制输出，如下，在`application.properties`文件中添加如下属性，将会覆盖SpringApplication中的默认配置：

打印到控制台

spring.main.banner-mode=console

打印到日志文件

spring.main.banner-mode=log

不打印

spring.main.banner-mode=off```

配置 SpringApplication

如果 SpringApplication 无法满足要求，你可以自己创建一个局部实例，然后对其进行设置：

public static void main(String[] args) {

    SpringApplication app = new SpringApplication(MySpringConfiguration.class);
    //关闭Banner打印
    app.setBannerMode(Banner.Mode.OFF);
    //添加监听器
    app.addListeners(new MyListener());
    ...
    app.run(args);
}```

SpringApplication的相关配置将会被`@Configuration`注解的类，XML配置文件，以及Spring扫描的包引用。更详细的配置选项，参见[SpringApplication](http://docs.spring.io/spring-boot/docs/1.4.1.RELEASE/api/org/springframework/boot/SpringApplication.html)Javadoc。

你也可以通过`SpringApplicationBuilder`来对SpringApplication的属性进行配置，这样的结构更有层次感。`SpringApplicationBuilder`为构建[SpringApplication](http://docs.spring.io/spring-boot/docs/1.4.1.RELEASE/api/org/springframework/boot/SpringApplication.html)和[ApplicationContext](http://docs.spring.io/spring-framework/docs/4.3.3.RELEASE/javadoc-api/org/springframework/context/ApplicationContext.html?is-external=true)实例提供了一套便利的流式API：

new SpringApplicationBuilder()
.sources(Parent.class)
.child(Application.class)
.bannerMode(Banner.Mode.OFF)
.listeners(new MyListener())
...
.run(args);```

SpringApplication 将会根据需要创建一个 ApplicationContext，默认情况下，如果是非 web 应用，则会创建一个 AnnotationConfigApplicationContext 上下文，如果是 web 应用，则会创建一个 AnnotationConfigEmbeddedWebApplicationContext 上下文。当然，你也可以通过 setWebEnvironment(boolean webEnvironment) 来覆盖默认的设置。

ApplicationRunner 和 CommandLineRunner

如果你希望在 SpringApplication 启动之前完成某些操作，你可以通过实现 ApplicationRunner 或者 CommandLineRunner 接口来实现。这两个接口提供了一个 run 方法，会在 SpringApplication.run(…) 完成之前被调用。适用于系统初始化配置的加载，启动检查等等。

import org.springframework.boot.*

import org.springframework.stereotype.*

@Component
public class MyBean implements CommandLineRunner {

    public void run(String... args) {
        // Do something...
    }

}```

如果有多个`CommandLineRunner`或者`ApplicationRunner`的实现，并且这些都需要按照一定的顺序来执行，你可以通过实现`org.springframework.core.Ordered`接口或者使用`org.springframework.core.annotation.Order`注解来设置这些的执行顺序。