本文翻译自：http://docs.spring.io/spring-boot/docs/2.0.0.M2/reference/htmlsingle/

详细介绍Spring boot的关键特征，针对有一定springboot基础的同学。

1. SpringApplication

SpringApplication类提供一个简单的方法启动spring应用，通过启动amin（）方法。在许多情况下，您只需委派静态SpringApplication.run方法：

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

当你的应用启动，你应该看到如下：

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::   v2.0.0.M2

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] ationConfigServletWebServerApplicationContext : Refreshing org.springframework.boot.web.servlet.context.AnnotationConfigServletWebServerApplicationContext@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.TomcatServletWebServerFactory : 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)

默认的INFOlog信息将会显示，包含一些启动的详情，比如启动应用程序的用户。

1.1 启动错误

如果你启动失败，已经注册的FailureAnalyzers会产生专用消息，和提供修复操作。比如，你启动web应用，占用了8080端口，但是8080已经在用，你会看到如下信息：

***************************
APPLICATION FAILED TO START
***************************

Description:

Embedded servlet container failed to start. Port 8080 was already in use.

Action:

Identify and stop the process that's listening on port 8080 or configure this application to listen on another port.

注意：springboot提供FailureAnalyzer的实现，你能轻松的把它添加到你的应用中。

如果analyzers没能捕获异常，你任然能够看到全自动配置的报告，以更好的了解出现的问题。要得到这样的效果，你需要启动debug属性，或者开始debug级别的日志。

org.springframework.boot.autoconfigure.logging.AutoConfigurationReportLoggingInitializer

针对应用，你使用java -jar来启动应用，你可以向下面这样开启debug模式：

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

1.2 定制banner

banner是开启应用后打印的内容，可以通过添加banner.txt到classpath来修改，或者通过设置本地文件中的banner.location来修改。如果文件用了不一样的编码，你可以设置banner.charset（默认是UTF-8）。在添加的文本文件中，你能添加banner.gif,banner.jpg或者banner.png图像文件到classpath，或者设置banner.image.location属性。图像会被编码成ascii艺术表现形式，并打印在任何文字banner上方。

在你的banner.txt文件中你能使用任何以下的占位符：

Banner变量

你也能使用spring.main.banner-mode属性来确定是否必须在System.out（console）中打印banner，用配置过的logger（log）或者禁用log（off）。

打印banner会被注册为一个单例bean，名称叫springBootBanner。

注意：如果你想在应用中禁用banner，YAML数据格式能映射off到false，所以需确认加了引号。

spring:
    main:
        banner-mode: "off"

1.3 定制SpringApplication

如果SpringApplication默认值不符合您的想法，您可以创建本地实例并进行自定义。例如，关闭banner你会写：

public static void main(String[] args) {
    SpringApplication app = new SpringApplication(MySpringConfiguration.class);
    app.setBannerMode(Banner.Mode.OFF);
    app.run(args);
}

注意：传递给SpringApplication的构造函数参数是spring bean的配置源。在大多数情况下，这些将引用@Configuration类，但它们也可以引用XML配置或应扫描的包。

也可以配置SpringApplication使用application.properties文件。

1.4 流式构建API

如果您需要构建一个ApplicationContext层次结构（具有父/子关系的多个上下文），或者如果您只想使用"流式"构建器API，则可以使用SpringApplicationBuilder。

SpringApplicationBuilder允许您链接多个方法调用，并包括允许您创建层次结构的父和子方法。

例如：

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

注意：创建ApplicationContext层次结构时有一些限制，例如Web组件必须包含在子上下文中，并且相同的环境将用于父和子上下文。有关详细信息，请参阅SpringApplicationBuilder Javadoc。

1.5 Application事件和监听器

除了常见的Spring Framework事件（如ContextRefreshedEvent）之外，SpringApplication还会发送一些其他应用程序事件。

注意：在创建ApplicationContext之前，实际上触发了一些事件，因此您不能在@Bean上注册一个监听器（因为先后顺序的问题）。您可以通过SpringApplication.addListeners（...）或SpringApplicationBuilder.listeners（...）方法注册它们。如果您希望自动注册这些侦听器，无论创建应用程序的方式如何，都可以将META-INF / spring.factories文件添加到项目中，并使用org.springframework.context.ApplicationListener键引用您的侦听器。 org.springframework.context.ApplicationListener = com.example.project.MyListener

应用程序事件按照以下顺序发送，因为您的应用程序运行：

• ApplicationStartingEvent在运行开始时发送，但在除了注册侦听器和初始化器之外的任何处理之前发送。
• 当上下文中要使用的环境已知但在创建上下文之前，将发送ApplicationEnvironmentPreparedEvent。
• ApplicationPreparedEvent在启动刷新之前发送，但在加载了bean定义之后。
• ApplicationReadyEvent在刷新之后被发送，并且处理了任何相关的回调以指示应用程序准备好服务请求。
• 如果启动时发生异常，则发送ApplicationFailedEvent。

1.6 Web环境

SpringApplication将尝试代表您创建正确类型的ApplicationContext。默认情况下，将使用AnnotationConfigApplicationContext或AnnotationConfigServletWebServerApplicationContext，具体取决于您是否正在开发Web应用程序。

用于确定"Web environment"的算法是相当简单的（基于几个类的存在）。如果需要覆盖默认值，可以使用setWebEnvironment（boolean webEnvironment）。

也可以完全控制将通过调用setApplicationContextClass（...）使用的ApplicationContext类型。

注意：在JUnit测试中使用SpringApplication时，通常需要调用setWebEnvironment（false）。

1.7 访问应用参数

如果您需要访问传递给SpringApplication.run（...）的应用程序参数，则可以注入org.springframework.boot.ApplicationArguments bean。 ApplicationArguments接口提供对原始String []参数以及解析选项和非选项参数的访问：

import org.springframework.boot.*
import org.springframework.beans.factory.annotation.*
import org.springframework.stereotype.*

@Component
public class MyBean {

    @Autowired
    public MyBean(ApplicationArguments args) {
        boolean debug = args.containsOption("debug");
        List<String> files = args.getNonOptionArgs();
        // if run with "--debug logfile.txt" debug=true, files=["logfile.txt"]
    }

}

注意：Spring Boot还将向Spring环境注册一个CommandLinePropertySource。这允许您也使用@Value注释注入单个应用程序参数。

1.8 使用 ApplicationRunner or CommandLineRunner

一旦SpringApplication启动，您需要运行一些特定的代码，就可以实现ApplicationRunner或CommandLineRunner接口。两个接口都以相同的方式工作，并提供一个单独的运行方法，这将在SpringApplication.run（...）完成之前调用。

CommandLineRunner接口提供对应用程序参数的访问，作为一个简单的字符串数组，而ApplicationRunner使用上述的ApplicationArguments接口。

import org.springframework.boot.*
import org.springframework.stereotype.*

@Component
public class MyBean implements CommandLineRunner {

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

}

您可以额外实现org.springframework.core.Ordered接口，也可以使用org.springframework.core.annotation.Order注释，如果定义了多个CommandLineRunner或ApplicationRunner bean，这些bean必须按特定顺序调用。

1.9 退出应用

每个SpringApplication将注册一个关闭钩子与JVM，以确保ApplicationContext在退出时正常关闭。可以使用所有标准的Spring生命周期回调（例如DisposableBean接口或@PreDestroy注释）。

另外，如果bean希望在应用程序结束时返回特定的退出代码，那么bean可以实现org.springframework.boot.ExitCodeGenerator接口。

1.10 admin特性

可以通过指定spring.application.admin.enabled属性为应用程序启用与管理相关的功能。这会在平台MBeanServer上公开SpringApplicationAdminMXBean。您可以使用此功能来远程管理您的Spring Boot应用程序。这对于任何服务包装器实现也是有用的。

注意：如果您想知道应用程序在哪个HTTP端口上运行，请使用local.server.port键获取该属性。

注意：启用此功能时请小心，因为MBean公开了关闭应用程序的方法。