詳解SpringBoot讀取配置文件的N種方法

更新時間：2021年02月10日 09:39:51 作者：程序員Mark_Chou

這篇文章主要介紹了詳解SpringBoot讀取配置文件的N種方法，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧

我們在項目開發(fā)中經常會用到配置信息，例如數據庫連接的帳號、密碼等，而為了方便維護，我們通常將這些信息放到配置文件中。在需要用到這些配置信息時，可以通過代碼獲取。下面我們看看Spring中有哪些獲取配置信息的方法。

PropertiesLoaderUtils讀取

通過ClassPathResource加載配置文件資源，結合PropertiesLoaderUtils類讀取，源碼如下：

ClassPathResource resource = new ClassPathResource("application.properties");  
try {    
 Properties properties = PropertiesLoaderUtils.loadProperties(resource);       String account = properties.getProperty("jdbc.account");        
} catch (IOException e) {    
 …… 
}

@Value注解讀取指定屬性

配置信息

jdbc:
 account: zhangsan
 pwd: 123456

讀取方法

@Component
public class JdbcService {
  @Value("${jdbc.account}")
  private String account;
  @Value("${jdbc.pwd}")
  private String pwd;

  public void connectDb() {
    System.out.println("Database has connected, jdbc account is "
      + account + ", password is " + pwd);
  }
}

@Value 注解通過 ${key}獲取配置文件中和 key 對應的 value 值，并將value值賦給對應的變量，之后就像使用正常變量一樣就可以獲取到配置信息。

@ConfigurationProperties讀取一組配置信息

@ConfigurationProperties注解用于讀取指定前綴的一組配置信息并與bean綁定，具體的配置屬性會綁定到bean的成員屬性中，即前綴名+成員屬性名等于配置文件中的key。之后可以像使用其他bean一樣使用該bean并讀取配置信息。

配置信息

user:
 name: zhangsan
 sex: 男
 homeUrl: www.xxx.com

綁定bean

@Component
@Data
@ConfigurationProperties(prefix = "user")
public class User {
  private String name;
  private String sex;
  private String homeUrl;
}

使用bean

@Service
public class UserService {
  @Autowired
  User user;

  public void getUserInfo() {
    System.out.println(user.toString());
  }
}

@Value適用與少量配置信息的場景，在一些較復雜的場景下（業(yè)務繁瑣、配置項多），需要考慮把相關一組配置信息封裝成一個或多個配置信息類，這時就可以使用@ConfigurationProperties。

@PropertySource讀取指定配置文件

當我們項目比較大配置信息比較多的時，如果所有的配置信息都放在一個配置文件中，就會顯得比較臃腫且不易理解和維護。此時，我們可以按照需求將該配置文件拆分為多個，并使用@PropertySource注解配合@Value或@ConfigurationProperties讀取指定配置文件中的配置信息。假設我們存儲數據連接信息的配置文件為jdbc.properties，內容如下：

jdbc:
 account: zhangsan
 pwd: 123456

@Component
@Data
@PropertySource(value = {"classpath:jdbc.properties"})
@ConfigurationProperties(prefix = "jdbc")
public class JdbcCfg {
  private String account;
  private String pwd;

  public void connectDb() {
    System.out.println("Database has connected, jdbc account is "
      + account + ", password is " + pwd);
  }
}

也可以和@Value配合使用。

@Component
@PropertySource(value = {"classpath:jdbc.properties"})
public class JdbcCfg {
 @Value("${jdbc.account}")
  private String account;
  @Value("${jdbc.pwd}")
  private String pwd;
  
  public void connectDb() {
   System.out.println("Database has connected, jdbc account is "
     + account + ", password is " + pwd);
}

指定項目的配置文件

在實際開發(fā)中，我們一般最少會有兩個環(huán)境——開發(fā)環(huán)境和線上環(huán)境，可能還會存在測試環(huán)境，這些環(huán)境往往會使用不同的配置信息，比如端口、數據庫鏈接地址等。如果我們把項目部署到線上環(huán)境后，在把配置信息一項一項的改成線上環(huán)境對應的會比較麻煩。比較科學的解決方法是，線上環(huán)境對應一套配置信息，開發(fā)環(huán)境對應一套，當我們在開發(fā)環(huán)境時指定讀取開發(fā)的配置，在線上時指定讀取線上的配置。

假設開發(fā)環(huán)境對應的配置文件為application-d.yml，線上環(huán)境對應的配置文件為application-d.yml。然后在application.yml文件中配置要使用的哪個配置文件即可，如在線上環(huán)境可按如下指定。

spring:
 profiles:
  active:
  - p

讀取復雜配置信息

看下如下配置文件

#http協(xié)議下消息傳輸
msgtransfer.tranprocol.http.orderid = order1
msgtransfer.tranprocol.http.count = 100

#fix協(xié)議下消息傳輸
msgtransfer.tranprocol.fix.orderid = order2
msgtransfer.tranprocol.fix.count = 200

上面的配置文件是為了支持不同協(xié)議的消息傳輸，該配置的key中也存在變量，這樣的配置信息如何讀取呢？

@Component
@Data
@ConfigurationProperties(prefix = "msgtransfer")
public class MsgTransferCfg {
  private Map<String, MsgInfo> tranprocol;
  
  public static class MsgInfo {
    private String orderid;
    private int count;
  }  
}

關鍵點在private Map<String, MsgInfo> tranprocol;，http和fix會自動映射為tranprocol的key，orderid和count會映射到MsgInfo的成員屬性上。

如果在配置文件的key中使用變量的，需要在相應的bean中定義map，配置文件和map的對應規(guī)則如下：