SpringBoot讀取外部配置文件的方法
1.SpringBoot配置文件
SpringBoot使用一個以application命名的配置文件作為默認(rèn)的全局配置文件。支持properties后綴結(jié)尾的配置文件或者以yml/yaml后綴結(jié)尾的YAML的文件配置。
以設(shè)置應(yīng)用端口為例
properties文件示例(application.properties):
server.port=80
YAML文件示例(application.yml):
server: port: 80
在properties和yml/yaml配置文件同時存在的情況下, 在同一目錄下,properties配置優(yōu)先級 > YAML(YML)配置優(yōu)先級
2.配置文件目錄
SpringBoot配置文件可以放置在多種路徑下,不同路徑下的配置優(yōu)先級有所不同。
可放置目錄(優(yōu)先級從高到低)
./config/ (當(dāng)前項目路徑config目錄下); ./ (當(dāng)前項目路徑下); classpath:/config/ (類路徑config目錄下); classpath:/ (類路徑config下).
優(yōu)先級由高到底,高優(yōu)先級的配置會覆蓋低優(yōu)先級的配置;
SpringBoot會從這四個位置全部加載配置文件并互補(bǔ)配置;
我們可以從ConfigFileApplicationListener這類便可看出,其中DEFAULT_SEARCH_LOCATIONS屬性設(shè)置了加載的目錄:
private static final String DEFAULT_SEARCH_LOCATIONS = "classpath:/,classpath:/config/,file:./,file:./config/";
接著getSearchLocations方法中去逗號解析成Set,其中內(nèi)部類Loader負(fù)責(zé)這一配置文件的加載過程,
包括加載profile指定環(huán)境的配置,以application+’-’+name格式的拼接加載。
多種目錄配置同時存在情況
接下來還是以端口配置為例
在resources/目錄下配置文件設(shè)置端口為8888; 在resources/config目錄下配置文件設(shè)置端口為9999; 在項目路徑下配置文件設(shè)置端口為6666; 在項目路徑config目錄下配置文件設(shè)置端口為7777;
]
最終運行結(jié)果:
Tomcat started on port(s): 7777 (http) with context path '/beedo'
Started BeedoApplication in 4.544 seconds (JVM running for 5.335)
通過控制變量法得以論證
其優(yōu)先級由高到底,高優(yōu)先級的配置會覆蓋低優(yōu)先級的配置
3.自定義配置屬性
SpringBoot提供了許多的配置,但通常情況我們需要自定義自己的配置應(yīng)用自己的系統(tǒng)中,如你需要配置一個默認(rèn)的用戶名密碼做為系統(tǒng)的登錄用。
首先創(chuàng)建一個實體類,作為配置注入用,并使用@ConfigurationProperties注解進(jìn)行批量注入, 也可以使用Spring底層注解@Value("${user.username}")的方式一個一個注入達(dá)到同意的效果
@Component
@ConfigurationProperties(prefix = "user")
public class Login{
private String username;
private String password;
...
}或者@Value寫法
@Component
public class Login{
private String username;
private String password;
...
}配置文件寫法
# yml文件寫法
user:
username: admin
password: 123
# properties寫法
login.username=admin
login.password=123
編寫一個junit測試用例,看看配置的值是否正常注入:
@RunWith(SpringRunner.class)
@SpringBootTest
public class DeployApplicationTests {
@Autowired
private Login login;
@Test
public void contextLoads() {
System.out.println(login);
}
}從輸出結(jié)果上看,值已正常注入
Login{username=‘admin’, password=‘123’}
@ConfigurationProperties與@Value兩種注解對比
| 比較項 | @ConfigurationProperties | @Value |
|---|---|---|
| 全量注入 | 支持 | 不支持 |
| 松散綁定(Relaxed Binding) | 支持 | 不支持 |
| SpEL | 不支持 | 支持 |
| JSR303 | 支持 | 不支持 |
松散綁定:駝峰命名(userName)、橫干拼接(user-name)、下劃線(user_name)之間可以互相識別綁定稱為做松散綁定
JSR303:通過@Email,@Nullable,@Digits 等等注解進(jìn)行郵箱、判空、數(shù)字格式等等數(shù)據(jù)的校驗,更多相關(guān)內(nèi)容請參考IBM的中文文檔:https://www.ibm.com/developerworks/cn/java/j-lo-jsr303/index.html
@ConfigurationProperties通常用于將配置全量注入某個類中;
@Value通常用于注入某一些特定配置值中;
使用@ConfigurationProperties方式可以進(jìn)行配置文件與實體字段的自動映射,但需要字段必須提供set方法才可以,而使用@Value注解修飾的字段不需要提供set方法
自定義配置提示
在編寫配置時,你會發(fā)現(xiàn)自定義配置沒有提示,讓你在使用自定義配置時變的很麻煩,其實SpringBoot早已為我們準(zhǔn)備好了提示的需要,只需要用引入相關(guān)依賴即可有提示。
在沒有加入依賴時idea會有如下提示:
添加依賴,該idea提示便消失,編寫自定義配置時也有相應(yīng)提示:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>需要運行一下
4.指定配置文件
通常情況下我們將配置配置在application開頭的主配置文件中,這樣隨著項目的增大配置項的增多會使文件變得非常臃腫,其實SpringBoot早已考慮到了該問題,SpringBoot提供了@PropertySource和@ImportResource兩個注解用于加載外部配置文件使用。
- @PropertySource通常用于屬性加載配置文件,注意@PropertySource注解不支持加載yaml文件,支持properties文件。
- @ImportResource通常用于加載Spring的xml配置文件
@PropertySource使用
裝配properties配置文件
在sources/config下創(chuàng)建一個yaml文件命名為user.properties內(nèi)容與上方user的配置一樣
Login類可如下寫法
@PropertySource(value = {"classpath:config/user.properties"})
@Component
@ConfigurationProperties(prefix = "user")
public class Login{
private String username;
private String password;
...
}運行一下,同樣能達(dá)到加載配置效果
同時加載多個配置問題
細(xì)心的你,會發(fā)現(xiàn)@PropertySource注解中屬性value為一個數(shù)組,如果同時加載多個配置文件,并且不同配置文件中對同一個屬性設(shè)置了不同的值,那么Spring會識別哪一個呢?
帶著疑問,我們可以通過控制變量法進(jìn)行測試,具體過程再在贅述。
@PropertySource(value = {"classpath:config/user1.properties","classpath:config/user2.properties"})結(jié)論:Spring加載順序為從左到右順序加載,后加載的會覆蓋先加載的屬性值。
裝配yaml配置文件
如果你有強(qiáng)迫癥,一定想加載yaml配置文件,那么可以通過PropertySourcesPlaceholderConfigurer類來加載yaml文件,將原來的user.properties改成user.yaml,Bean配置類中加入如下代碼,Login配置類和一開始的方式一致。
@Bean
public static PropertySourcesPlaceholderConfigurer loadProperties() {
PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();
YamlPropertiesFactoryBean yaml = new YamlPropertiesFactoryBean();
//yaml.setResources(new FileSystemResource("classpath:config/user.yml"));//File路徑引入
yaml.setResources(new ClassPathResource("config/user.yml"));//class路徑引入
configurer.setProperties(yaml.getObject());
return configurer;
}運行一下,仍然可以能達(dá)到加載配置效果的
@ImportResource使用
SpringBoot提出零xml的配置,因此SpringBoot默認(rèn)情況下時不會識別項目中Spring的xml配置文件。為了能夠加載xml的配置文件,SpringBoot提供了@ImportResource注解該注解可以加載Spring的xml配置文件,通常加于啟動類上。
@ImportResource(value = {"classpath:/beans.xml"})
@SpringBootApplication(scanBasePackages = {"team.seagull.client"})
public class DeployApplication {
public static void main(String[] args) {
SpringApplication.run(DeployApplication.class, args);
}
}其他問題
idea使用.properties文件出現(xiàn)中文亂碼問題?
idea對.properties默認(rèn)編碼為GBK,通常我們項目為UTF-8編碼,這樣程序在讀取時就會出現(xiàn)亂碼問題;
解決方法:idea 中 打開如下選項File->Sttings->Editor->FileEncodings
將GBK修改為UTF-8并勾選
Transparent native-to ascill conversion(在運行的時候轉(zhuǎn)換成ascii碼)
到此這篇關(guān)于SpringBoot讀取外部配置文件的方法的文章就介紹到這了,更多相關(guān)SpringBoot讀取外部配置文件內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
關(guān)于HashSet與HashMap的區(qū)別及說明
這篇文章主要介紹了關(guān)于HashSet與HashMap的區(qū)別及說明,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2023-07-07
JPA findById方法和getOne方法的區(qū)別說明
這篇文章主要介紹了JPA findById方法和getOne方法的區(qū)別,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教。2021-08-08
spring security中Authority、Role的區(qū)別及說明
這篇文章主要介紹了spring security中Authority、Role的區(qū)別及說明,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-09-09
基于@RestControllerAdvice與@ControllerAdvice的區(qū)別說明
這篇文章主要介紹了@RestControllerAdvice與@ControllerAdvice的區(qū)別說明,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-09-09
新建Maven工程出現(xiàn)Process?Terminated的問題解決
當(dāng)Maven出現(xiàn)"Process terminated"錯誤時,這通常是由于配置文件或路徑錯誤導(dǎo)致的,本文主要介紹了新建Maven工程出現(xiàn)Process?Terminated的問題解決,感興趣的可以了解一下2024-04-04
Spring?Data?JPA?在?@Query?中使用投影的方法示例詳解
這篇文章主要介紹了Spring?Data?JPA?在?@Query?中使用投影的方法,大家需要注意如果要在 @Query 中使用投影,必須要主動聲明要查詢的字段,并且主動寫明字段的別名才行,本文通過sql代碼給大家介紹的非常詳細(xì),需要的朋友參考下吧2022-07-07

