Update How-to_ guides.md
parent
7e099b9835
commit
0f6d50b358
|
@ -66,12 +66,82 @@ spring.main.show_banner=false
|
||||||
|
|
||||||
详情参考[ConfigFileApplicationListener](http://github.com/spring-projects/spring-boot/tree/master/spring-boot/src/main/java/org/springframework/boot/context/config/ConfigFileApplicationListener.java)
|
详情参考[ConfigFileApplicationListener](http://github.com/spring-projects/spring-boot/tree/master/spring-boot/src/main/java/org/springframework/boot/context/config/ConfigFileApplicationListener.java)
|
||||||
|
|
||||||
|
### 使用'short'命令行参数
|
||||||
|
|
||||||
|
有些人喜欢使用(例如)`--port=9000`代替`--server.port=9000`来设置命令行配置属性。你可以通过在application.properties中使用占位符来启用该功能,比如:
|
||||||
|
```java
|
||||||
|
server.port=${port:8080}
|
||||||
|
```
|
||||||
|
**注**:如果你继承自`spring-boot-starter-parent` POM,为了防止和Spring-style的占位符产生冲突,`maven-resources-plugins`默认的过滤令牌(filter token)已经从`${*}`变为`@`(即`@maven.token@`代替了`${maven.token}`)。如果已经直接启用maven对application.properties的过滤,你可能也想使用[其他的分隔符](http://maven.apache.org/plugins/maven-resources-plugin/resources-mojo.html#delimiters)替换默认的过滤令牌。
|
||||||
|
|
||||||
|
**注**:在这种特殊的情况下,端口绑定能够在一个PaaS环境下工作,比如Heroku和Cloud Foundry,因为在这两个平台中`PORT`环境变量是自动设置的,并且Spring能够绑定`Environment`属性的大写同义词。
|
||||||
|
|
||||||
|
### 使用YAML配置外部属性
|
||||||
|
|
||||||
|
YAML是JSON的一个超集,可以非常方便的将外部配置以层次结构形式存储起来。比如:
|
||||||
|
```json
|
||||||
|
spring:
|
||||||
|
application:
|
||||||
|
name: cruncher
|
||||||
|
datasource:
|
||||||
|
driverClassName: com.mysql.jdbc.Driver
|
||||||
|
url: jdbc:mysql://localhost/test
|
||||||
|
server:
|
||||||
|
port: 9000
|
||||||
|
```
|
||||||
|
创建一个application.yml文件,将它放到classpath的根目录下,并添加snakeyaml依赖(Maven坐标为`org.yaml:snakeyaml`,如果你使用`spring-boot-starter`那就已经被包含了)。一个YAML文件会被解析为一个Java `Map<String,Object>`(和一个JSON对象类似),Spring Boot会平伸该map,这样它就只有1级深度,并且有period-separated的keys,跟人们在Java中经常使用的Properties文件非常类似。
|
||||||
|
上面的YAML示例对应于下面的application.properties文件:
|
||||||
|
```java
|
||||||
|
spring.application.name=cruncher
|
||||||
|
spring.datasource.driverClassName=com.mysql.jdbc.Driver
|
||||||
|
spring.datasource.url=jdbc:mysql://localhost/test
|
||||||
|
server.port=9000
|
||||||
|
```
|
||||||
|
查看'Spring Boot特性'章节的[Section 23.6, “Using YAML instead of Properties”](http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#boot-features-external-config-yaml)可以获取更多关于YAML的信息。
|
||||||
|
|
||||||
|
### 设置生效的Spring profiles
|
||||||
|
|
||||||
|
Spring `Environment`有一个API可以设置生效的profiles,但通常你会设置一个系统profile(`spring.profiles.active`)或一个OS环境变量(`SPRING_PROFILES_ACTIVE`)。比如,使用一个`-D`参数启动应用程序(记着把它放到main类或jar文件之前):
|
||||||
|
```shell
|
||||||
|
$ java -jar -Dspring.profiles.active=production demo-0.0.1-SNAPSHOT.jar
|
||||||
|
```
|
||||||
|
在Spring Boot中,你也可以在application.properties里设置生效的profile,例如:
|
||||||
|
```java
|
||||||
|
spring.profiles.active=production
|
||||||
|
```
|
||||||
|
通过这种方式设置的值会被系统属性或环境变量替换,但不会被`SpringApplicationBuilder.profiles()`方法替换。因此,后面的Java API可用来在不改变默认设置的情况下增加profiles。
|
||||||
|
|
||||||
|
想要获取更多信息可查看'Spring Boot特性'章节的[Chapter 24, Profiles](http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#boot-features-profiles)。
|
||||||
|
|
||||||
|
### 根据环境改变配置
|
||||||
|
|
||||||
|
一个YAML文件实际上是一系列以`---`线分割的文档,每个文档都被单独解析为一个平坦的(flattened)map。
|
||||||
|
|
||||||
|
如果一个YAML文档包含一个`spring.profiles`关键字,那profiles的值(以逗号分割的profiles列表)将被传入Spring的`Environment.acceptsProfiles()`方法,并且如果这些profiles的任何一个被激活,对应的文档被包含到最终的合并中(否则不会)。
|
||||||
|
|
||||||
|
示例:
|
||||||
|
```json
|
||||||
|
server:
|
||||||
|
port: 9000
|
||||||
|
---
|
||||||
|
|
||||||
|
spring:
|
||||||
|
profiles: development
|
||||||
|
server:
|
||||||
|
port: 9001
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
spring:
|
||||||
|
profiles: production
|
||||||
|
server:
|
||||||
|
port: 0
|
||||||
|
```
|
||||||
|
在这个示例中,默认的端口是9000,但如果Spring profile 'development'生效则该端口是9001,如果'production'生效则它是0。
|
||||||
|
|
||||||
|
YAML文档以它们遇到的顺序合并(所以后面的值会覆盖前面的值)。
|
||||||
|
|
||||||
|
想要使用profiles文件完成同样的操作,你可以使用`application-${profile}.properties`指定特殊的,profile相关的值。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue