如何更優(yōu)雅地獲取spring boot yml中的值
前言
偶然看到國外論壇有人在吐槽同事從配置文件獲取值的方式,因此查閱了相關(guān)資料發(fā)現(xiàn)確實有更便于管理更優(yōu)雅的獲取方式。
github demo地址: springboot-yml-value
1.什么是yml文件
application.yml取代application.properties,用來配置數(shù)據(jù)可讀性更強,尤其是當我們已經(jīng)制定了很多的層次結(jié)構(gòu)配置的時候。
下面是一個非?;镜膟ml文件:
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)雅的方法可以確保強類型bean的管理以及更方便的驗證我們的程序配置。
為了實現(xià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é)點) * @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屬性??梢韵袢魏纬R?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上手測試哦,地址在文首。有幫助的話點個贊吧,筆芯。轉(zhuǎn)載需附上原文鏈接。
5.補充
因為有小伙伴不太清楚具體用途。筆者補充一下兩者的優(yōu)缺點吧。
Spring Boot通過ConfigurationProperties注解從配置文件中獲取屬性。從上面的例子可以看出ConfigurationProperties注解可以通過設(shè)置prefix指定需要批量導(dǎo)入的數(shù)據(jù)。支持獲取字面值,集合,Map,對象等復(fù)雜數(shù)據(jù)。ConfigurationProperties注解還有其他特點呢?它和Spring的Value注解又有什么區(qū)別呢?
一)ConfigurationProperties和@Value優(yōu)缺點
ConfigurationProperties注解的優(yōu)缺點
一、可以從配置文件中批量注入屬性;
二、支持獲取復(fù)雜的數(shù)據(jù)類型;
三、對屬性名匹配的要求較低,比如user-name,user_name,userName,USER_NAME都可以取值;
四、支持JAVA的JSR303數(shù)據(jù)校驗;
五、缺點是不支持SpEL表達式;
六、確保強類型bean的管理,更方便的驗證程序配置;
Value注解的優(yōu)缺點正好相反,它只能一個個配置注入值;不支持數(shù)組、集合等復(fù)雜的數(shù)據(jù)類型;不支持數(shù)據(jù)校驗;對屬性名匹配有嚴格的要求。最大的特點是支持SpEL表達式,使其擁有更豐富的功能。
總結(jié)
以上就是這篇文章的全部內(nèi)容了,希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,謝謝大家對腳本之家的支持。
相關(guān)文章
Spring常用注解 使用注解來構(gòu)造IoC容器的方法
下面小編就為大家分享一篇Spring常用注解 使用注解來構(gòu)造IoC容器的方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-01-01SpringCloud?分布式微服務(wù)架構(gòu)操作步驟
SpringCloud是一種微服務(wù)的框架,利用它我們可以去做分布式服務(wù)開發(fā),這篇文章主要介紹了SpringCloud?分布式微服務(wù)架構(gòu),需要的朋友可以參考下2022-07-07