小編這次要給大家分享的是SpringBoot如何獲取配置文件,文章內(nèi)容豐富,感興趣的小伙伴可以來(lái)了解一下,希望大家閱讀完這篇文章之后能夠有所收獲。
創(chuàng)新互聯(lián)主營(yíng)柴桑網(wǎng)站建設(shè)的網(wǎng)絡(luò)公司,主營(yíng)網(wǎng)站建設(shè)方案,重慶APP開發(fā),柴桑h5小程序制作搭建,柴桑網(wǎng)站營(yíng)銷推廣歡迎柴桑等地區(qū)企業(yè)咨詢
前言
在講SpringBoot 獲取配置文件之前我們需要對(duì)SpringBoot 的項(xiàng)目有一個(gè)整體的了解,如何創(chuàng)建SpringBoot 項(xiàng)目,項(xiàng)目結(jié)構(gòu)等等知識(shí)點(diǎn),我在這里就不一一講述了,沒有學(xué)過的小伙伴可以自己在網(wǎng)上找一些資料進(jìn)行學(xué)習(xí),很簡(jiǎn)單的。
下面讓我們開始今天的內(nèi)容講解吧。
一、SpringBoot 全局配置文件的加載順序
在SpringBoot 當(dāng)中,全局配置文件有兩種不同的格式,一個(gè)是我們常見的properties, 一種是yml.
這兩種格式的文件其實(shí)也沒什么太大的區(qū)別,使用的時(shí)候按照個(gè)人的習(xí)慣來(lái)就行,下面我們用的是yml文件。
首先,當(dāng)我們創(chuàng)建SpringBoot 的項(xiàng)目時(shí),默認(rèn)在resources目錄下創(chuàng)建一個(gè)application.properties文件,這時(shí)我們可以在
這個(gè)文件當(dāng)中對(duì)項(xiàng)目進(jìn)行配置即可。但是在SpringBoot 中application.properties可以存放在以下幾個(gè)位置:
file:./config/ 項(xiàng)目根目錄下的config文件夾下
file:./ 項(xiàng)目根目錄下
classpath:/config/ 類路徑下的config文件夾下
classpath:/ 類路徑下
文件的加載順序:即根目錄下的config目錄下,然后是 根目錄下,然后是classpath路徑下的config目錄下,最后是classpath路徑下。
優(yōu)先級(jí)由高到低,高優(yōu)先級(jí)的配置會(huì)覆蓋低優(yōu)先級(jí)的配置。
假如:根目錄下的config目錄下定義端口為8084, 根目錄下定義端口為8083 ,classpath路徑下的config目錄定義端口為8082,classpath路徑下定義端口為8081,最后啟動(dòng),啟動(dòng)的端口為8084 ,高優(yōu)先級(jí)會(huì)覆蓋低優(yōu)先級(jí)。
注意:并不是高優(yōu)先級(jí)的被加載了,低優(yōu)先級(jí)的就不會(huì)再加載,實(shí)際上是SpringBoot會(huì)從這四個(gè)位置全部加載主配置文件,并且還能產(chǎn)生互相配置的效果。
除此外,我們還可以通過spring.config.location來(lái)改變默認(rèn)的配置文件位置。
項(xiàng)目打包好以后,我們可以使用命令行參數(shù)的形式,啟動(dòng)項(xiàng)目的時(shí)候來(lái)指定配置文件的新位置;指定默認(rèn)加載的這些配置文件共同起作用形成互補(bǔ)配置。
在 G盤目錄下,創(chuàng)建一個(gè)application.yml文件,定義端口為8085
打包項(xiàng)目,啟動(dòng)命令行:java -jar spring-boot-config-0.0.1-SNAPSHOT.jar --spring.config.location=G:/application.yml
回車運(yùn)行。
外部配置加載順序
1、命令行參數(shù)
eg: java -jar spring-boot-config-0.0.1-SNAPSHOT.jar --server.port=8087
---- 由jar包外向jar包內(nèi)進(jìn)行尋找:
2、 優(yōu)先加載帶profile
jar包外部的 application-{profile}.properties
或application.yml(帶spring.profile)配置文件
將打好的jar包放在一個(gè)目錄下,然后再該文件夾下新建一個(gè)名為application.yml
的文件,其中指定
port為8082 ,訪問路徑為/boot ,然后命令行直接啟動(dòng)項(xiàng)目。java -jar spring-boot-config-0.0.1-SNAPSHOT.jar --application.yml
在講配置文件之前,我先說(shuō)一說(shuō)yml文件配置信息書寫格式
基本數(shù)據(jù)類型(8種基本數(shù)據(jù)類型)以k: v 形式書寫即可
比如我在一個(gè)實(shí)體類(Person)中定義一個(gè) 屬性(age),類型是 int ,在yml文件中的書寫格式如下
person: age: 20
實(shí)體類對(duì)象(Person),Map ,k:v 在下一行來(lái)寫對(duì)象的屬性和值的關(guān)系,注意縮進(jìn)
person: userName: zhans age: 20
#另一種行內(nèi)寫法 person: {userName: zhans.age: 20}
List ,數(shù)組的書寫,注意 - 后有空格
pets: - cat - dog - pig
#另一種行內(nèi)寫法 pets:{cat,dog,pi}
二、SpringBoot 獲取配置文件的方式
**@Value **
創(chuàng)建配置類,由于篇幅問題這里省略了 setter、getter 方法,但是實(shí)際開發(fā)中這個(gè)是必須的,否則無(wú)法成功注入,@Component表示把當(dāng)前配置類注入到Spring容器當(dāng)中。
@Component public class PersonConfig { @Value("${person.userName}") private String userName; @Value("${person.age}") private int age; }
在主配置文件中添加如下配置(application.yml)
server: port: 8081 person: userName: hello age: 20
測(cè)試類:
@RestController public class PersonController { @Autowired private Person person; @RequestMapping(value = "/get",method = RequestMethod.GET) public String findPerson(){ return "姓名:"+person.getUserName()+"年齡:"+person.getAge(); } }
啟動(dòng)項(xiàng)目,訪問地址http://localhost:8080/get運(yùn)行結(jié)果:
姓名:hello年齡:20
所以,我們就可以通過 @Value(${key})的方式獲取全局配置文件中的指定配置項(xiàng)。
@ConfigurationProperties
如果我們需要取 許多個(gè)配置項(xiàng),通過 @Value 的方式去配置項(xiàng)需要一個(gè)一個(gè)去取,顯然有點(diǎn)麻煩。所以我們可以使用 @ConfigurationProperties。
標(biāo)有 @ConfigurationProperties的類的所有屬性和配置文件中相關(guān)的配置項(xiàng)進(jìn)行綁定,綁定之后我們就可以通過這個(gè)類去訪問全局配置文件中的屬性值。
代碼實(shí)例如下:
1、在主配置文件中添加如下配置
user: username: admin password: 123456 map: {k1: v1,k2: v2} list: - cat - dog person: userName: hello age: 20 objects: - aaa - bbb - ccc
創(chuàng)建配置類,由于篇幅問題這里省略了 setter、getter ,toString 方法,但是實(shí)際開發(fā)中這個(gè)是必須的,否則無(wú)法成功注入。
@Component @ConfigurationProperties(prefix = "user") public class User { private String username; private String password; private Mapmap; private Person person; private List list; private Object[] objects; }
這里 @ConfigurationProperties 有一個(gè) prefix參數(shù),主要是用來(lái)指定該配置項(xiàng)在配置文件中的前綴,即user。
測(cè)試類
@RestController public class PersonController { @Autowired private Person person; @RequestMapping(value = "/findUser",method = RequestMethod.GET) public String findUser(){ return user.toString(); } }
我們?cè)陧?yè)面訪問 http://localhost:8081/findUser,頁(yè)面就顯示我們?cè)趛ml文件中配置的信息了。
User{username='admin', password='123456', map={k1=v1, k2=v2}, person=com.zfcoding.config.Person@93471e6, list=[cat, dog], objects=[aaa, bbb, ccc]}
以上的兩種方式有什么區(qū)別呢?
@ConfigurationProperties | @Value | |
---|---|---|
功能 | 批量注入配置文件的屬性 | 一個(gè)一個(gè)指定 |
松散綁定 | 支持 | 不支持 |
JSR303數(shù)據(jù)校驗(yàn) | 支持 | 不支持 |
復(fù)雜數(shù)據(jù)封裝 | 支持 | 不支持(Map) |
松散綁定,username 可以用user-name 表示,來(lái)獲取值
JSR303數(shù)據(jù)校驗(yàn),如果用@Value獲取全局配置文件的屬性,使用@Validated文件格式校驗(yàn)是不起作用的。
@PropertySource 注解加載指定的配置文件。
@PropertySource (value = “ ”) 指明加載類路徑下的哪個(gè)配置文件來(lái)注入值
創(chuàng)建配置類,由于篇幅問題這里省略了 setter、getter ,toString 方法,但是實(shí)際開發(fā)中這個(gè)是必須的,否則無(wú)法成功注入。
@Component @PropertySource( "classpath:student.properties") @ConfigurationProperties(prefix = "student") public class Student { private String sname; }
在student.properties文件中添加如下配置
student.sname=admin
測(cè)試類
@SpringBootTest class SpringbootExampleApplicationTests { @Autowired private DogConfig dogConfig; @Test void contextLoads() { System.out.println("注入的對(duì)象:"+dogConfig.getName()); } }
運(yùn)行結(jié)果:
Student{sname='admin'}
@ImportResource 導(dǎo)入Spring 配置文件
@ImportResource 注解用來(lái)導(dǎo)入 Spring 的配置文件,如果Spring配置文件 "bean.xml",從而讓配置文件里面的內(nèi)容生效,通??梢园袬ImportResource標(biāo)注在@SpringBootApplication的啟動(dòng)類上即可。
舉例說(shuō)明:比如我們把PersonService注入到Spring容器當(dāng)中,通過Spring配置文件的方式操作,代碼示例如下:
public class PersonService { }
@ImportResource("classpath:bean.xml") @SpringBootApplication public class SpringBootConfigApplication { public static void main(String[] args) { SpringApplication.run(SpringBootConfigApplication.class, args); } }
Spring的配置文件:bean.xml
<?xml version="1.0" encoding="UTF-8"?>
測(cè)試的案例:
@SpringBootTest class SpringBootConfigApplicationTests { @Autowired private PersonService personSerivcer; @Test void contextLoads() { System.out.println("注入的對(duì)象:"+personSerivcer); } }
運(yùn)行的結(jié)果:
注入的對(duì)象:com.zfcoding.service.PersonService@5b84f14
這Spring 中bean的配置實(shí)現(xiàn),但是SpringBoot 推薦我們使用注解開發(fā),那Springboot 中注解是如何實(shí)現(xiàn)bean 的注入呢?
@Configuration:指明當(dāng)前類是配置類,就是代替上面說(shuō)到的spring的配置文件.
@Bean 將方法返回值添加到容器當(dāng)中,容器中這個(gè)組件默認(rèn)的id 是方法名
@Configuration public class MyConfig { @Bean public PersonSerivcer personSerivcer(){ return new PersonSerivcer(); } }
這樣就可以就可以通過注解實(shí)現(xiàn)代替Spring 中的配置文件了。
三、SpringBoot 的Profile
我們這里就以yml文件為例
第一種是我在 主配置文件編寫的時(shí)候,文件名可以是application-{profile}.yml(application-dev.yml, application-prod.yml)
,默認(rèn)使用 文件application.yml 的配置
1、如果我們想要使用的application-dev.yml 全局配置文件,在application.yml 指定即可。
配置實(shí)例:
在application.yml 配置文件中添加如下配置
spring: profiles: active: dev
在application-dev.ym 配置文件中添加如下配置l
server: port: 8080 #應(yīng)用訪問的項(xiàng)目路徑 servlet: context-path: /boot person: username: 占山
2、yml支持多文檔快方式
那么,在application-dev.ym 配置文件中添加如下配置l
spring: profiles: active: prod --- server: port: 8080 servlet: context-path: /zf spring: profiles: dev --- person: userName: 啊哈 server: port: 8081 servlet: context-path: /boot spring: profiles: prod
3、Program arguments
在Program arguments中配置參數(shù)
--spring.profiles.active=dev
4、虛擬機(jī)的方式
在VM options下使用命令:-Dspring.profiles.active=prod
四、小結(jié)
實(shí)際開發(fā)中我們?nèi)绻绻覀冃枰?許多個(gè)配置項(xiàng),就使用@ConfigurationProperties注解,如果只是注入一個(gè)屬性就使用@Value,
@PropertySource 注解加載指定的配置文件,@ImportResource 導(dǎo)入Spring 配置文件(這里可以使用注解來(lái)替代)。
看完這篇關(guān)于SpringBoot如何獲取配置文件的文章,如果覺得文章內(nèi)容寫得不錯(cuò)的話,可以把它分享出去給更多人看到。