快捷導(dǎo)航

如何更優(yōu)雅地獲取spring boot yml中的值

更新時間：2019年06月05日 11:21:06 作者：連理枝_

這篇文章主要給大家介紹了關(guān)于如何更優(yōu)雅地獲取spring boot yml中值的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家學(xué)習(xí)或者使用spring boot具有一定的參考學(xué)習(xí)價值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧

前言

偶然看到國外論壇有人在吐槽同事從配置文件獲取值的方式，因此查閱了相關(guān)資料發(fā)現(xiàn)確實(shí)有更便于管理更優(yōu)雅的獲取方式。

github demo地址： springboot-yml-value

1.什么是yml文件

application.yml取代application.properties，用來配置數(shù)據(jù)可讀性更強(qiáng)，尤其是當(dāng)我們已經(jīng)制定了很多的層次結(jié)構(gòu)配置的時候。

下面是一個非常基本的yml文件：

server:
 url: http://localhost 
 myapp:
  name: MyApplication
  threadCount: 4
...

等同于以下的application.properties文件：

server.url=http://localhost
server.myapp.name=MyApplication
server.myapp.threadCount=4
...

demo中的yml文件如下：

server:
 url: http://myapp.org 
 app:
  name: MyApplication
  threadCount: 10
  users: 
   - Jacob
   - James

2.yml屬性獲取配置

訪問yml屬性的一種方法是使用@Value("$ {property}")注釋,但是隨著配置樹形結(jié)構(gòu)以及數(shù)量的增加，代碼可讀性也隨之降低，更不利于bean的管理。筆者發(fā)現(xiàn)另一種優(yōu)雅的方法可以確保強(qiáng)類型bean的管理以及更方便的驗(yàn)證我們的程序配置。

為了實(shí)現(xiàn)這一點(diǎn)，我們將創(chuàng)建一個@ConfigurationProperties類ServerProperties，它映射一組相關(guān)的屬性：

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;

import java.util.ArrayList;
import java.util.List;

/**
 * @program: simple-demo
 * @description: 映射屬性 (server節(jié)點(diǎn))
 * @author: CaoTing
 * @date: 2019/6/3
 **/
@Data
@ConfigurationProperties("server")
public class ServerProperties {
 
 private String url;
 
 private final App app = new App();
 
 public App getApp() {
  return app;
 }
 
 public static class App {
 
  private String name;
  private String threadCount;
  private List<String> users = new ArrayList<>();
  // TODO getter and setter
 }
 
}

請注意，我們可以創(chuàng)建一個或多個@ConfigurationProperties類。

定義我們的springboot 注冊配置類ApplicationConfig：

import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Configuration;

/**
 * @program: simple-demo
 * @description: 注冊所有映射屬性類 { }中用逗號分隔即可注冊多個屬性類
 * @author: CaoTing
 * @date: 2019/6/3
 **/
@Configuration
@EnableConfigurationProperties({ServerProperties.class})
public class ApplicationConfig {
}

這里已經(jīng)提到了要在@EnableConfigurationProperties中注冊的屬性類列表。

3.訪問yml屬性

現(xiàn)在可以通過使用創(chuàng)建的@ConfigurationProperties bean來訪問yml屬性。可以像任何常規(guī)的Spring bean一樣注入這些屬性bean，測試類如下：

import com.caotinging.ymldemo.application.YmlValueApplication;
import com.caotinging.ymldemo.config.ServerProperties;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

/**
 * @program: simple-demo
 * @description: 單元測試類
 * @author: CaoTing
 * @date: 2019/6/3
 **/
@RunWith(SpringJUnit4ClassRunner.class)
@SpringBootTest(classes = YmlValueApplication.class)
public class AppYmlValueTest {

 @Autowired
 private ServerProperties config;

 @Test
 public void printConfigs() {
   System.out.println(this.config.getUrl());
   System.out.println(this.config.getApp().getName());
   System.out.println(this.config.getApp().getThreadCount());
   System.out.println(this.config.getApp().getUsers());
 }
}

測試結(jié)果如下:

4.總結(jié)

歡迎移步github上手測試哦，地址在文首。有幫助的話點(diǎn)個贊吧，筆芯。轉(zhuǎn)載需附上原文鏈接。

5.補(bǔ)充

因?yàn)橛行』锇椴惶宄唧w用途。筆者補(bǔ)充一下兩者的優(yōu)缺點(diǎn)吧。

Spring Boot通過ConfigurationProperties注解從配置文件中獲取屬性。從上面的例子可以看出ConfigurationProperties注解可以通過設(shè)置prefix指定需要批量導(dǎo)入的數(shù)據(jù)。支持獲取字面值，集合，Map，對象等復(fù)雜數(shù)據(jù)。ConfigurationProperties注解還有其他特點(diǎn)呢？它和Spring的Value注解又有什么區(qū)別呢？

一）ConfigurationProperties和@Value優(yōu)缺點(diǎn)

ConfigurationProperties注解的優(yōu)缺點(diǎn)

一、可以從配置文件中批量注入屬性；

二、支持獲取復(fù)雜的數(shù)據(jù)類型；

三、對屬性名匹配的要求較低，比如user-name，user_name，userName，USER_NAME都可以取值；

四、支持JAVA的JSR303數(shù)據(jù)校驗(yàn)；

五、缺點(diǎn)是不支持SpEL表達(dá)式；

六、確保強(qiáng)類型bean的管理，更方便的驗(yàn)證程序配置；

Value注解的優(yōu)缺點(diǎn)正好相反，它只能一個個配置注入值；不支持?jǐn)?shù)組、集合等復(fù)雜的數(shù)據(jù)類型；不支持?jǐn)?shù)據(jù)校驗(yàn)；對屬性名匹配有嚴(yán)格的要求。最大的特點(diǎn)是支持SpEL表達(dá)式，使其擁有更豐富的功能。

總結(jié)

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

您可能感興趣的文章: