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

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

SpringApplication

SpringApplication

类提供了一种方便的方式从

main()

方法中启动应用，在许多情况下，你可以用

SpringApplication.run

这个静态方法。如下所示：

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

默认的日志级别是

INFO

级别。

启动失败

如果你的应用启动失败，则注册的

FailureAnalyzers

会提供专门的错误信息和具体操作来解决问题。例如，你应用的端口

8080

被占用，你将会看到如下信息：

4000
[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.

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

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

自定义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,你可以

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

流式构建API

如果你需要构建一个

ApplicationContext

分层（多个有父子关系的contexts）或者你更想用一个”fluent” 构建API，你可以使用

SpringApplicationBuilder

。

这个

SpringApplicationBuilder

让多个方法可以链式调用。包括父方法和子方法，如下所示：

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

注意：创建

ApplicationContext

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

应用的事件和监听器

除了Spring Framework 自带的事件以外，例如

ContextRefreshedEvent

，SpringApplication 还添加了一些额外的应用事件。

注意：一些事件实际上在创建

ApplicationContext

之前已经被触发。所以你不能通过

@Bean

注册这些监听器。你可以通过

SpringApplication.addListeners(…​)

方法或者通过

SpringApplicationBuilder.listeners(…​)

方法。如果你想这些监听器被自动注册，你可以在你的项目中添加一个

META-INF/spring.factories

文件。例如你可以

org.springframework.context.ApplicationListener=com.example.project.MyListener

应用事件在下面的列表中，当你的应用运行后：

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[]参数以及解析选项和非选项参数的访问：

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 也注册了

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

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

@Component
public class MyBean {

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

// ...

}

在应用程序类路径（例如：您的jar中），您可以拥有一个

application.properties

，它为name属性提供了默认属性值。在新环境中运行时，可以再您的jar外部提供了一个

application.properties

来覆盖 name属性。对于一次性测试，您可以使用特定的命令行开关启动（例如：java -jar app.jar -name=”Spring”）。

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

$ SPRING_APPLICATION_JSON='{"foo":{"bar":"spam"}}' java -jar myapp.jar

配置随机值

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

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]}

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中的值在使用时通过已有的环境进行过滤。以便您可以引用之前定义的值。例如：

app.name=MyApp
app.description=${app.name} is a Spring Boot application

您也可以使用此技术创建现有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文档：

environments:
dev:
url: http://dev.bar.com name: Developer Setup
prod:
url: http://foo.bar.com name: My Cool App

将转化为属性：

environments.dev.url=http://dev.bar.com
environments.dev.name=Developer Setup
environments.prod.url=http://foo.bar.com
env
a774
ironments.prod.name=My Cool App

YAML列表表示为具有[index] dereferencers的属性键，例如YAML：

my:
servers:
- dev.bar.com
- foo.bar.com

将转化为属性：

my.servers[0]=dev.bar.com
my.servers[1]=foo.bar.com

将YAML作为Spring环境中的属性文件

可以使用

YamlPropertySourceLoader

类在Spring环境中将YAML作为PropertySource暴露出来。这允许你使用熟悉@Value注解和占位符语法来访问YAML属性。

多个YAML文件

您可以使用

spring.profiles.active

键指定单个文件中的多个特定配置文件YAML文档，以指示文档何时应用。

YAML的缺点

YAML文件无法通过@PropertySource注解 加载。因此，在需要以这种方式加载值的情况下，需要使用Properties文件。

Spring Boot的特性就暂时介绍到此处。

参考

https://blog.csdn.net/qq_36348557/article/details/69396589

https://docs.spring.io/spring-boot/docs/2.0.0.RELEASE/reference/htmlsingle/#boot-features-external-config