第4章 零XML配置的Spring Boot Application

Spring Boot 提供了一種統(tǒng)一的方式來管理應用的配置，允許開發(fā)人員使用屬性properties文件互订、YAML 文件缚态、環(huán)境變量和命令行參數來定義優(yōu)先級不同的配置值余蟹。零XML配置的Spring Boot Application曲掰，是基于Spring JavaConfig贞瞒。

application.properties配置文件使用

我們在上一章中，默認的服務端口是8080靶衍，如果我們想自定義端口號沦辙，在SpringBoot中怎么搞?

OK夫植，很簡單。SpringBootApplication有個系統(tǒng)級的配置文件application.properties

我們只需要在里面加一行配置即可：

server.port=5678

啟動應用油讯，你講看到：

2017-04-04 23:31:21.673  INFO 90250 --- [           main] o.s.j.e.a.AnnotationMBeanExporter        : Registering beans for JMX exposure on startup
2017-04-04 23:31:21.774  INFO 90250 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 5678 (http)
2017-04-04 23:31:21.780  INFO 90250 --- [           main] com.example.DemoApplication              : Started DemoApplication in 4.712 seconds (JVM running for 5.511)

TomcatEmbeddedServletContainer已經在5678端口監(jiān)聽請求了详民。

瀏覽器訪問：http://localhost:5678/hello
你會看到成功輸出：

Hello World! Tue Apr 04 23:32:38 CST 2017

application.properties是Spring Boot約定的配置文件。Spring Boot基于這個配置文件的配置機制充分體現(xiàn)了Spring Boot遵循的“約定優(yōu)于配置”的原則陌兑。

Spring Boot幾乎所有的配置項都可以在這個文件中配置沈跨，如果不配置，則使用默認項兔综。Spring Boot會檢測配置項的key饿凛，啟動相應的自動配置模塊。

下面具體介紹一些在application.properties配置中的特性和使用方法软驰。

1.數據源datasource配置

spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

當Spring Boot一旦檢測到數據庫配置相關的配置項（spring.datasoure.*）涧窒，Spring Boot會自動根據相應的配置項，建立數據庫連接池锭亏。

這個application.properties里面到底有哪些key是可配置的呢纠吴？在SpringBoot官網文檔給出了詳盡的配置以及說明。在Appendix A. Common application properties中： http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#common-application-properties

不完全統(tǒng)計慧瘤，這個完整的application properties文件戴已，有1183行固该。其中，屬性key有950個糖儡。當你看到如此龐大的配置伐坏，你一定會被嚇到。不過休玩，在實際項目中著淆，我們如果遵循Spring Boot的約定，通常不需要我們單獨指定太多配置拴疤。

雖然是零XML配置永部，但是“有些配置的事情”，還是必須要做的呐矾。這里SpringBoot的實現(xiàn)方案苔埋，充分體現(xiàn)了Spring框架的“約定優(yōu)于配置”理念。通過約定俗成的規(guī)范蜒犯，很多問題的解決講得到大大的簡化组橄。

2.在application.properties自定義屬性與加載

我們可以將自己自定義的屬性配置在application.properties中（注意不要和Spring Boot的默認配置的key重復），然后在java類中通過@Value("${屬性名}")注解來加載對應的配置屬性罚随，例如：application.properties文件中有如下自定義配置項：

com.easy.springboot.h5perf.app.name = H5性能測試平臺

則在java中有如下應用：

@Component
public class TestProperties {

    @Value("${com.easy.springboot.h5perf.app.name }")
    private String appName;
}

3.配置項值的引用

在application.properties中的各個參數之間可以直接通過“${keyname}”引用來使用玉工。

在application.properties中也可以通過“@keyname@”來引用pom文件中的元素節(jié)點值，例如：

pom文件中有如下定義：

<properties>
    <project.name >easy-springboot-demo </ project.name >
    <project.version>1.0</ project.version >
</properties>

則在application.properties文件中可以通過如下方式引用：

# 項目名稱
com.easy.springboot.project.name = @project.name@
# 項目版本
com.easy.springboot.project.version = @project.version@

4.隨機數屬性value

在一些情況下淘菩，有些參數我們需要希望它不是一個固定的值遵班，Spring Boot的屬性配置文件中可以通過${random}來產生int值、long值或者string字符串潮改，來支持屬性的隨機值狭郑。

例如：

# 隨機字符串
com.easy.springboot.string=${random.value} 
# 隨機int
com.easy.springboot.number=${random.int} 
# 隨機long
com.easy.springboot.bignumber=${random.long} 
# 100以內的隨機數
com.easy.springboot.range1=${random.int(100)} 
# 100-200的隨機數
com.easy.springboot.range2=${random.int[100,200]}

屬性配置文件的位置

spring會從classpath下的/config目錄或者classpath的根目錄查找application.properties或application.yml。

/config優(yōu)先于classpath根目錄汇在。

Spring Boot 配置的管理

一般在一個項目中翰萨，總是會有好多個環(huán)境。比如：

開發(fā)環(huán)境 -> 測試環(huán)境 -> 預發(fā)布環(huán)境 -> 生產環(huán)境

在應用中管理配置是一個重要的問題糕殉，尤其是在應用需要部署到多個環(huán)境中時亩鬼。通常會需要為每個環(huán)境提供一個對應的屬性文件，用來配置各自的數據庫連接信息阿蝶、服務器信息和第三方服務賬號等辛孵。通常的應用部署會包含開發(fā)、測試和生產等若干個環(huán)境赡磅。

常規(guī)情況下，我們都知道Spring Boot的配置會從application.properties中讀取宝与。實際上焚廊，從resource目錄下的application.properties文件讀取是Spring Boot配置鏈中的一環(huán)而已冶匹。

配置的優(yōu)先級

Spring Boot提供了一種優(yōu)先級配置讀取的機制來幫助我們從這種困境中走出來。

Spring Boot 所提供的配置優(yōu)先級順序比較復雜咆瘟。按照優(yōu)先級從高到低的順序嚼隘，具體的列表（從高到低）如下所示。

1.命令行參數（優(yōu)先級最高）袒餐。
2.通過 System.getProperties() 獲取的 Java 系統(tǒng)參數飞蛹。
3.操作系統(tǒng)環(huán)境變量。
4.從 java:comp/env 得到的 JNDI 屬性灸眼。
5.通過 RandomValuePropertySource 生成的random.*屬性卧檐。
6.jar包外部的application-{profile}.properties或application.yml(帶spring.profile)配置文件，通過spring.config.location參數指定
7.jar包內部的application-{profile}.properties或application.yml(帶spring.profile)配置文件
8.jar包外部的application.properties或application.yml(不帶spring.profile)配置文件
9.jar包內部的application.properties或application.yml(不帶spring.profile)配置文件
10.應用 Java配置類焰宣，包含@Configuration注解的 Java 類霉囚，通過@PropertySource注解聲明的屬性文件。
11.通過SpringApplication.setDefaultProperties聲明的默認屬性匕积。

如果Spring Boot在優(yōu)先級更高的位置找到了配置盈罐，那么它就會忽略優(yōu)先級低的配置。下面我們簡單講講這些優(yōu)先級闪唆。

命令行參數配置

Spring Boot 的這個配置優(yōu)先級看似復雜盅粪，其實是很合理的。命令行參數的優(yōu)先級之所以被設置為最高悄蕾，是因為可以方便我們在測試或生產環(huán)境中快速地修改配置參數值票顾，而不需要重新打包和部署應用。

SpringApplication 類默認會把以“--”開頭的命令行參數轉化成應用中可以使用的配置參數笼吟，如 “--name=Alex” 會設置配置參數 “name” 的值為 “Alex”库物。

如果不需要這個功能，可以通過

SpringApplication.setAddCommandLineProperties(false)

禁用解析命令行參數贷帮。

random.*屬性

RandomValuePropertySource 可以用來生成測試所需要的各種不同類型的隨機值戚揭，從而免去了在代碼中生成的麻煩。RandomValuePropertySource 可以生成數字和字符串撵枢。數字的類型包含 int 和 long民晒，可以限定數字的大小范圍。以“random.”作為前綴的配置屬性名稱由 RandomValuePropertySource 來生成锄禽，代碼示例：

user.id=${random.value}
user.count=${random.int}
user.max=${random.long}
user.number=${random.int(100)}
user.range=${random.int[100, 1000]}

屬性文件配置

屬性文件是最常見的管理配置屬性的方式潜必。Spring Boot 提供的 SpringApplication 類會搜索并加載 application.properties 文件來獲取配置屬性值。SpringApplication 類會在下面位置搜索該文件：

1.當前目錄的/config子目錄
2.當前目錄
3.classpath 中的/config包
4.classpath

上面的順序也表示了該位置上包含的屬性文件的優(yōu)先級沃但。優(yōu)先級按照從高到低的順序排列磁滚。

可以通過spring.config.name這個key的配置屬性來指定不同的屬性文件名稱。也可以通過spring.config.location來添加額外的屬性文件的搜索路徑。

對于配置屬性垂攘，可以在代碼中通過“@Value”來使用维雇，例如

@RestController
@EnableAutoConfiguration
public class Application {
 @Value("${name}")
 private String name;
 @RequestMapping("/")
 String home() {
 return String.format("Hello %s!", name);
 }
}

其中，@Value("${name}")注解的意思就是晒他，變量 name 的值來自配置屬性中的name屬性吱型。

YAML格式的配置文件

相對于屬性文件來說，YAML 是一個更好的配置文件格式陨仅。
當有前綴的情況下津滞，使用.yml格式的配置文件更簡單。

注意：使用.yml時灼伤，屬性名的值和冒號中間必須有空格触徐，如name: SpringBoot正確，SpringBoot就是錯的饺蔑。

YAML 在 Ruby on Rails 中得到了很好的應用锌介。YAML是JSON的一個超集，也是一種方便的定義層次配置數據的格式猾警。它的基本語法規(guī)則如下：

大小寫敏感
使用縮進表示層級關系
縮進時不允許使用Tab鍵孔祸，只允許使用空格。
縮進的空格數目不重要发皿，只要相同層級的元素左側對齊即可
# 表示注釋崔慧，從這個字符一直到行尾，都會被解析器忽略穴墅。

只要你將SnakeYAML 庫放到classpath下惶室，SpringApplication就會自動支持YAML，以作為properties的替換玄货。當然皇钞，我們通常不需要這么做，因為我們一般都會使用Starters松捉，在spring-boot-starter里會自動加載SnakeYAML夹界。

Spring框架提供兩個便利的類用于加載YAML文檔，YamlPropertiesFactoryBean會將YAML加載為Properties隘世，YamlMapFactoryBean會將YAML加載為Map可柿。

Spring Boot使用application.properties默認了很多配置。但需要自己添加一些配置的時候丙者，我們應該怎么做呢复斥。

例如，下面這段yml格式的配置

environments:
    dev:
        url: http://dev.easy.springboot.com
        name: Easy Spring Boot

會轉化為：

environments.url=http://dev.easy.springboot.com
environments.name=Easy Spring Boot

如果我們自定義了屬性key械媒，在代碼中怎樣使用上面的配置信息呢目锭？利用Spring DataBinder工具集，Spring Boot通過注解@ConfigurationProperties 和@EnableConfigurationProperties 來完成這件事情。

在代碼中對應的Bean對象：

@ConfigurationProperties(prefix="environments")
public class EnvironmentsConfig { 
    private String url; 
    private String name;
     
    public String getUrl(){ return this.url; }  
    public void setUrl(String url){ this.url = url; }  
    public String getName(){ return this.name; } 
    public void setName(){ this.name = name; } 

}

有些時候侣集，我們還會配置類似下面這樣的列表的屬性

my:
   servers:
       - dev1.easy.com
       - dev2.easy.com

會轉化為：

my.servers[0]=dev1.easy.com
my.servers[1]=dev2.easy.com

使用@ConfigurationProperties這個注解來實現(xiàn)屬性Bean的綁定键俱，需要在Bean里面添加一個java.util.List(或者Set)類型的屬性，然后寫好setter（setter也可以換成初始化一個對象）世分，getter：

@ConfigurationProperties(prefix="my")
public class ServersConfig {
    private List<String> servers = new ArrayList<String>();//initialize it with a mutable value， equals a setter
    public List<String> getServers() {
        return this.servers;
    }    

}

因為YamlPropertySourceLoader類能夠將YAML作為PropertySource導出到Spring Environment缀辩。所以我們可以使用常用的@Value注解配合占位符語法訪問YAML屬性臭埋。

另外，當我們使用@ConfigurationProperties注解定義配置的Bean時臀玄，需要在SpringBoot Application啟動類上標注@EnableConfigurationProperties瓢阴。

使用 Java配置類

Spring 框架本身提供了多種的方式來管理配置屬性文件。Spring 3.1 之前可以使用 PropertyPlaceholderConfigurer健无。Spring 3.1 引入了新的環(huán)境（Environment）和概要信息（Profile）API荣恐，是一種更加靈活的處理不同環(huán)境和配置文件的方式。

Spring Profiles提供了一種隔離應用程序配置的方式累贤，并讓這些配置只在特定的環(huán)境下生效叠穆。任何@Component或@Configuration都能注解@Profile，從而限制加載它的環(huán)境：

@Configuration
@Profile("production")
public class ProductionConfiguration {

    // ...

}

指定的屬性方式常用的有2種：

1.配置在application.properties中：

spring.profiles.active=production

2.或使用命令行開關：

--spring.profiles.active=production

如果應用中包含多個 profile臼膏，可以為每個 profile 定義各自的屬性文件硼被，按照application-{profile}.properties(.yml)來命名。

使用CommandLineRunner

實際應用中渗磅，有時候我們在項目服務啟動的時候就去加載一些數據或做一些事情這樣的需求嚷硫。 以前比較常見的做法是寫再static代碼塊中。

在Spring Boot中始鱼，它提供了一個CommandLineRunner接口仔掸，實現(xiàn)這個接口的類總是會被優(yōu)先啟動，并優(yōu)先執(zhí)行CommandLineRunner接口中提供的run()方法医清。例如

public class ApplicationConfigure implements CommandLineRunner { 
    @Override 
    public void run(String... strings) throws Exception {
        //TODO : 比如說起暮，在這里預先加載的一些方法，類状勤，屬性等鞋怀。
    }
}

如果有多個CommandLineRunner接口實現(xiàn)類，那么可以通過注解@Order
來規(guī)定所有實現(xiàn)類的運行順序持搜。

小結

Spring Boot 它拋棄了Spring 中繁瑣的xml配置文件的方式密似，聲明式注解的方法為服務開發(fā)提供快速簡潔的配置方式。在Spring Boot 中葫盼，我們會發(fā)現(xiàn)残腌，我們其實不用做一些基本的配置也能直接運行剛創(chuàng)建好的工程項目，因為它內嵌了很多基本的通用的配置組件而不需要我們自己來做一些重復的配置工作。

Spring Boot讓環(huán)境配置變得輕松很多抛猫。

參考資料：
1.https://www.ibm.com/developerworks/cn/java/j-lo-spring-boot/index.html
2.http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#common-application-properties