前言

本文將重點講解一下Spring中@PropertySource注解的使用，如何通過PropertySource注解加載指定的配置文件。以及PropertySource注解與@ConfigurationProperties兩個注解的配合使用。下面話不多說了，來隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧。

1.1. PropertySource注解加載指定的屬性文件

Spring框架提供了PropertySource注解，目的是加載指定的屬性文件，接下來我們看一下如何使用該注解。首先我們定義一個配置類，并在類中添加PropertySource注解，如下所示：

@Component
@PropertySource(value= {"classpath:config/jdbc-bainuo-dev.properties"},ignoreResourceNotFound=false,encoding="UTF-8",name="jdbc-bainuo-dev.properties",)
public class CustomerDataSourceConfig1 {
private String url;
 public String getUrl() {
  return url;
 }
 public void setUrl(String url) {
  this.url = url;
 }
 @Override
 public String toString() {
  return "CustomerDataSourceConfig{" +
    "url='" + url + '\'' +
    '}';
 }
}

上述的代碼目的是加載classpath路徑中config文件中的jdbc-bainuo-dev.properties。其中encoding用于指定讀取屬性文件所使用的編碼，我們通常使用的是UTF-8；ignoreResourceNotFound含義是當(dāng)指定的配置文件不存在是否報錯，默認(rèn)是false;比如上文中指定的加載屬性文件是jdbc-bainuo-dev.properties。如果該文件不存在，則ignoreResourceNotFound為true的時候，程序不會報錯，如果ignoreResourceNotFound為false的時候，程序直接報錯。實際項目開發(fā)中，最好設(shè)置ignoreResourceNotFound為false。該參數(shù)默認(rèn)值為false。

value值是設(shè)置需要加載的屬性文件，可以一次性加載多個。name的值我們設(shè)置的是jdbc-bainuo-dev.properties。這個值在Springboot的環(huán)境中必須是唯一的，如果不設(shè)置，則值為：“class path resource [config/jdbc-bainuo-dev.properties] “。

可能很多人比較納悶，為什么是“class path resource [config/jdbc-bainuo-dev.properties] “呢？這個就涉及到了Spring中對資源文件的封裝類Resource。上文我們配置的value值為"classpath:config/jdbc-bainuo-dev.properties"，因此Spring發(fā)現(xiàn)是classpath開頭的，因此最終使用的是Resource的子類ClassPathResource。如果是file開頭的，則最終使用的類是FileSystemResource。

了解了上文所述的Resource類之后。我們再次明確一點，如果@PropertySource中如果沒有設(shè)置name值，則name值的生成規(guī)則是：根據(jù)value值查找到最終封裝的Resource子類，然后調(diào)用具體的Resource子類實例對象中的getDescription方法，getDescription方法的返回值為最終的name值。

比如ClassPathResource類中的getDescription方法實現(xiàn)如下：

public String getDescription() {
 StringBuilder builder = new StringBuilder("class path resource [");
 String pathToUse = path;
 if (this.clazz != null && !pathToUse.startsWith("/")) {
 builder.append(ClassUtils.classPackageAsResourcePath(this.clazz));
 builder.append('/');
 }
 if (pathToUse.startsWith("/")) {
 pathToUse = pathToUse.substring(1);
 }
 builder.append(pathToUse);
 builder.append(']');
 return builder.toString();
}

上述的name處理邏輯暫時先有個印象即可，后續(xù)會詳細(xì)地跟蹤源碼進(jìn)行講解。

1.2. PropertySource注解加載指定的屬性文件測試

上文我們設(shè)置了PropertySource注解來加載"classpath:config/jdbc-bainuo-dev.properties"文件。該文件的目錄結(jié)構(gòu)如下圖所示：

jdbc-bainuo-dev.properties文件內(nèi)容如下：

spring.datasource.shareniu.url=shareniu

application.properties文件內(nèi)容如下：

spring.profiles.active=dev

上面的配置文件中，spring.profiles.active屬性配置了當(dāng)前使用的環(huán)境是dev。spring.datasource.shareniu.url只是一個普通的屬性，本身并沒有什么特殊的含義。

下面開始書寫Springboot的啟動類，如下所示：

@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
 SpringApplication springApplication = new SpringApplication(DemoApplication.class);
 ConfigurableApplicationContext configurableApplicationContext = springApplication.run(args);
 CustomerDataSourceConfig1 customerDataSourceConfig = configurableApplicationContext
 .getBean(CustomerDataSourceConfig1.class);
 System.out.print(customerDataSourceConfig);
}
}

運(yùn)行上述的代碼，程序的輸出如下：

CustomerDataSourceConfig{url='null'}

奇怪了，怎么url是空呢？PropertySource注解不是已經(jīng)將jdbc-bainuo-dev.properties文件加載到當(dāng)前的環(huán)境中了嗎？我們不妨試一下看看jdbc-bainuo-dev.properties中的spring.datasource.shareniu.url屬性是否可以獲取到，進(jìn)而從側(cè)面驗證PropertySource注解已經(jīng)將jdbc-bainuo-dev.properties文件加載到當(dāng)前的環(huán)境中。

修改上述啟動類的代碼如下：

@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
 SpringApplication springApplication = new SpringApplication(DemoApplication.class);
 ConfigurableApplicationContext configurableApplicationContext = springApplication.run(args);
 CustomerDataSourceConfig1 customerDataSourceConfig = configurableApplicationContext.getBean(CustomerDataSourceConfig1.class);
 String property = configurableApplicationContext.getEnvironment().getProperty("spring.datasource.shareniu.url");
 System.out.println(property);
 System.out.print(customerDataSourceConfig);
}
}

運(yùn)行上述的代碼，程序的輸出如下：

Shareniu

通過上述的代碼可以看出PropertySource確實是生效了。那么我們怎么將spring.datasource.shareniu.url屬性值自動注入到CustomerDataSourceConfig1 類中的url屬性中呢？

1.3. PropertySource注解讀取指定文件并將屬性注入到配置類

Spring中提供了@Value注解，用于將配置文件中的屬性值讀取出來并設(shè)置到相應(yīng)的屬性中。在這里我們學(xué)習(xí)一下如何使用@Value注解。同樣的還是以上文的兩個類為例進(jìn)行詳細(xì)說明，首先需要修改CustomerDataSourceConfig1類，修改部分如下所示：

@Component
@PropertySource( name="jdbc-bainuo-dev.properties",value= {"classpath:config/jdbc-bainuo-dev.properties"},ignoreResourceNotFound=false,encoding="UTF-8")
public class CustomerDataSourceConfig1 {
 @Value("${spring.datasource.shareniu.url}")
 private String url;
}

上述的類中，在url字段中增加了@Value注解，并指定了SPEL表達(dá)式為${spring.datasource.shareniu.url} 。再次運(yùn)行springboot啟動類，控制臺的輸出為shareniu。表明確實可以通過@Value進(jìn)行屬性值的注入。但是使用@Value注解方式有一個不太友好的地方就是，當(dāng)項目中有大量的屬性進(jìn)行配置的時候，我們需要一個個的在類的字段中增加@Value注解，這樣確實很費勁，不過我們可以通過Springboot提供的@ConfigurationProperties注解解決這個問題。

1.4. ConfigurationProperties注解使用

@ConfigurationProperties是類級別的注解，具體使用方式如下：

@Component
@ConfigurationProperties(prefix = "spring.datasource.shareniu") 
@PropertySource( name="jdbc-bainuo-dev.properties",value= {"classpath:config/jdbc-bainuo-dev.properties"},ignoreResourceNotFound=false,encoding="UTF-8")
public class CustomerDataSourceConfig1 {
 private String url;
 }

上述代碼中，在CustomerDataSourceConfig1類中增加了ConfigurationProperties注解，并且指明了屬性的前綴為spring.datasource.shareniu。這樣Springboot在處理的時候，會去掃描當(dāng)前類中的所有字段并進(jìn)行屬性的查找以及組裝。比如我們配置的prefix = "spring.datasource.shareniu" ，CustomerDataSourceConfig1類中有一個url字段，則url字段需要匹配的屬性是prefix+字段=spring.datasource.shareniu.url 。

那不僅有個疑問？如果指定的字段沒有找到屬性怎么辦呢？這個可以進(jìn)行如下的配置：

@ConfigurationProperties(prefix = "spring.datasource.shareniu",ignoreUnknownFields=true,ignoreInvalidFields=true) 

ignoreUnknownFields：忽略未知的字段。

ignoreInvalidFields：是否忽略驗證失敗的字段。這個怎么理解呢？比如我們在配置文件中配置了一個字符串類型的變量，類中的字段是int類型，那肯定會報錯的。如果出現(xiàn)這種情況我們可以容忍，則需要配置該屬性值為true。該參數(shù)值默認(rèn)為false。

本文暫且講解到這里，后續(xù)的文章我們來講解@PropertySource注解如何實現(xiàn)讀取不同環(huán)境中的配置文件，這個不同環(huán)境的文件動態(tài)切換讀取，PropertySource默認(rèn)是不支持的，因此我們需要擴(kuò)展該注解對應(yīng)的源碼。

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，如果有疑問大家可以留言交流，謝謝大家對腳本之家的支持。