Update How-to_ guides.md

master
qibaoguang 2015-03-22 17:01:43 +08:00
parent 7e099b9835
commit 0f6d50b358
1 changed files with 76 additions and 6 deletions

View File

@ -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文件实际上是一系列以`---`线分割的文档每个文档都被单独解析为一个平坦的flattenedmap。
如果一个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相关的值。