Spring Boot 学习03-----Spring Boot 特性

接着来学习Spring Boot，虽然现在很困。

SpringApplication

SpringApplication 类提供了一种方便的方式从main()方法中启动应用，在许多情况下，你可以用SpringApplication.run这个静态方法。如下所示：

<span style="color:#333333"><code>public static void main(String[] args) {
    SpringApplication.run(MySpringConfiguration.class, args);
}</code></span>

默认的日志级别是INFO 级别。

启动失败

如果你的应用启动失败，则注册的FailureAnalyzers会提供专门的错误信息和具体操作来解决问题。例如，你应用的端口8080被占用，你将会看到如下信息：

<span style="color:#333333"><code>***************************
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.
</code></span>

可以通过命令行开启调试模式

<span style="color:#333333"><code>java -jar myproject-0.0.1-SNAPSHOT.jar --debug</code></span>

自定义Banner

可以通过添加 banner.txt文件改变应用启动时打印的banner，这个文件要添加到classpath下，如果不在classpath下，需要通过spring.banner.location 来指定该文件的位置。如果该文件的编码不是UTF-8,你需要设置spring.banner.charset 。另外，你可以添加banner.gif, banner.jpg, or banner.png等图片文件到你的classpath下或者通过spring.banner.image.location 来设置。更多知识参见 banner

自定义SpringApplication

如果默认的SpringApplication 不满足你的需求，你可以创建一个局部变量，然后自定义它，例如：你想关闭banner,你可以

<span style="color:#333333"><code>public static void main(String[] args) {
    SpringApplication app = new SpringApplication(MySpringConfiguration.class);
    app.setBannerMode(Banner.Mode.OFF);
    app.run(args);
}</code></span>

流式构建API

如果你需要构建一个ApplicationContext 分层（多个有父子关系的contexts）或者你更想用一个”fluent” 构建API，你可以使用SpringApplicationBuilder。
这个SpringApplicationBuilder 让多个方法可以链式调用。包括父方法和子方法，如下所示：

<span style="color:#333333"><code>new SpringApplicationBuilder()
        .sources(Parent.class)
        .child(Application.class)
        .bannerMode(Banner.Mode.OFF)
        .run(args);
</code></span>

注意：创建ApplicationContext时有一些限制。例如：web的组成元素中必须包含子context,父context和子context必须使用相同的环境。

应用的事件和监听器

除了Spring Framework 自带的事件以外，例如ContextRefreshedEvent，SpringApplication 还添加了一些额外的应用事件。
注意：一些事件实际上在创建ApplicationContext之前已经被触发。所以你不能通过@Bean注册这些监听器。你可以通过SpringApplication.addListeners(…​) 方法或者通过SpringApplicationBuilder.listeners(…​) 方法。如果你想这些监听器被自动注册，你可以在你的项目中添加一个META-INF/spring.factories 文件。例如你可以

<span style="color:#333333"><code>org.springframework.context.ApplicationListener=com.example.project.MyListener</code></span>

应用事件在下面的列表中，当你的应用运行后：
1. ApplicationStartingEvent： 在运行开始时发送，但是在注册listeners 和注册初始化器之后。
2. ApplicationEnvironmentPreparedEvent 当已经知道要使用的上下文（context）环境，并在context创建之前。
3. ApplicationPreparedEvent在启动 刷新之前，但在加载bean定义之后。
4. ApplicationStartedEvent 上下文被刷新，但是应用和命令行运行被唤起。
5. ApplicationReadyEvent 应用和命令行被唤起。并且处理了相关的回调以指示应用程序准备好服务请求。
6. ApplicationFailedEvent 当启动时出现异常时。
注意：一般您不需要使用应用程序时间，但可以方便的知道它们存在，在内部，Spring Boot使用事件来处理各种任务。

Web环境

SpringApplication 将代替您创建一个正确的的ApplicationContext，默认的，会创建一个AnnotationConfigApplicationContext或者AnnotationConfigServletWebServerApplicationContext具体取决于你开发的Web 应用。
用于确定”Web环境”的算法是相当简单的（基于几个类的存在）。如果需要覆盖默认，可以设置setWebEnvironment（boolean webEnvironment）
也可以通过调用setApplicationContextClass()对ApplicationContext完全控制。
注意：在Junit测试汇总常常需要setWebEnvironment(false)

访问应用程序参数

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

<span style="color:#333333"><code>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"]
    }

}</code></span>

注意： Spring Boot 也注册了CommandLinePropertySource，这个可以让你可以通过@Value注解注入简单应用参数。

使用ApplicationRunner 或者CommandLineRunner

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

外部配置

Spring Boot 允许您外部化您的配置，以便您可以在不同的环境中使用相同的应用程序代码。您可以使用properties文件，YAML文件，环境变量和命令行参数来外部化配置，可以使用@Value注释将属性值直接注入到您的bean中。该注释可通过Spring环境（Environment）抽象访问，或通过@ConfigurationProperties 绑定到结构化对象
Spring Boot 使用非常特别的PropertySource命令，旨在允许合理的覆盖值。属性按以下顺序选择。
1. 在您的HOME目录设置的Devtools全局属性（~/.spring-boot-devtools.properties）。
2. 单元测试中的@TestPropertySource注解。
3. 单元测试中的 @SpringBootTest#properties 注解属性
4. 命令行参数
5. SPRING_APPLICATION_JSON 中的属性值（内嵌JSON嵌入到环境变量或系统属性中）
6. ServletConfig 初始化参数
7. ServletContext 初始化参数
8. 来自java:comp/env 的JNDI属性
9. Java系统属性（System.getProperties()）
10. 操作系统环境变量
11. RandomValuePropertySource，只有随机的属性 random.* 中。
12. jar包外面的 Profile-specific application properties （application- {profile} .properties和YAML变体）
13. jar包内的 Profile-specific application properties （application-{profile}.properties和YAML变体）
14. jar包外的应用属性文件（application.properties和YAML变体）。
15. jar包内的应用属性文件（application.properties和YAML变体）。
16. 在@Configuration 上@PropertySource注解
17. 默认属性（使用SpringApplication.setDefaultProperties设置）。
例如：假设你正在开发一个使用name属性的@Component

<span style="color:#333333"><code>import org.springframework.stereotype.*
import org.springframework.beans.factory.annotation.*

@Component
public class MyBean {

    @Value("${name}")
    private String name;

    // ...

}
</code></span>

在应用程序类路径（例如：您的jar中），您可以拥有一个application.properties，它为name属性提供了默认属性值。在新环境中运行时，可以再您的jar外部提供了一个application.properties 来覆盖 name属性。对于一次性测试，您可以使用特定的命令行开关启动（例如：java -jar app.jar -name=”Spring”）。

SPRING_APPLICATION_JSON属性可以在命令行中提供一个环境变量。 例如在UN*X shell中：

<span style="color:#333333"><code>$ SPRING_APPLICATION_JSON='{"foo":{"bar":"spam"}}' java -jar myapp.jar</code></span>

配置随机值

RandomValuePropertySource 可用于注入随机值（例如，进入秘密或测试用例）。它可以产生整数，uuid或字符串，例如：

<span style="color:#333333"><code>my.secret=${random.value}
my.number=${random.int}
my.bignumber=${random.long}
my.uuid=${random.uuid}
my.number.less.than.ten=${random.int(10)}
my.number.in.range=${random.int[1024,65536]}</code></span>

random.int *语法是 OPEN value (,max) CLOSE ，其中OPEN，CLOSE是任何字符和值，max是整数。 如果提供max，则值为最小值，max为最大值（独占）。

应用程序属性文件

SpringApplication 将从以下位置的 application.propeties文件中加载属性，并将它们添加到Spring Environment中：
1. 当前目录的/config 子目录
2. 当前目录
3. classpath 中/config包
4. classpath root路径
该列表按照优先级从高到低排序。
也可以 使用YAML（’.yml’）文件 替代”.properties”。

properties文件中的占位符

application.properties中的值在使用时通过已有的环境进行过滤。以便您可以引用之前定义的值。例如：

<span style="color:#333333"><code>app.name=MyApp
app.description=${app.name} is a Spring Boot application</code></span>

您也可以使用此技术创建现有Spring Boot属性的“简写“。 有关详细信息，请参见第72.4节“使用”短命令行参数“how-to”。

使用YAML 替代Properties

YAML 是JSON的超集，因此这是分层配置数据一种非常方便的格式。每当您的类路径中都有SnakeYAML 库时。SpringApplication类将自动支持YAML作为properties的替代方法。

加载YAML

Spring Framework提供了两个方便的类，可用于加载YAML文档。YamlPropertiesFactoryBean将YAML作为Properties加载，YamlMapFactoryBean将YAML作为Map加载。
例如，下面YAML文档：

。。。。。。。。。。。。。。。。。

版权原因，完整文章，请参考如下：

Spring Boot 学习03-----Spring Boot 特性