Spring如何自定義加載配置文件(分層次加載)

更新時(shí)間：2023年07月27日 10:49:31 作者：恐龍弟旺仔

這篇文章主要介紹了Spring如何自定義加載配置文件(分層次加載)問(wèn)題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教

前言

Spring會(huì)默認(rèn)加載application.properties文件，我們一般可以將配置寫(xiě)在此處。這基本可以滿(mǎn)足我們的常用demo項(xiàng)目使用。

但是在實(shí)際項(xiàng)目開(kāi)發(fā)中，我們會(huì)將配置文件外置，這樣在我們需要修改配置的時(shí)候就不用將項(xiàng)目重新打包部署了。

下面我們來(lái)看一下實(shí)際項(xiàng)目開(kāi)發(fā)的需求。

針對(duì)配置分層次加載的需求

舉給例子

1.我們希望項(xiàng)目啟動(dòng)后會(huì)加載內(nèi)部配置文件（統(tǒng)一命名為env.properties）

2.如果有外置配置文件的話(huà)（路徑設(shè)置為/envconfig/${app.name}/env.properties），則加載外置配置文件，并覆蓋內(nèi)部配置文件的相同key的項(xiàng)

3.如果在項(xiàng)目啟動(dòng)時(shí)候指定了命令行參數(shù)，則該參數(shù)級(jí)別最高，可以覆蓋外置配置文件相同key的項(xiàng)

以上這個(gè)需求，我們用目前Spring的加載配置的方式就有點(diǎn)難以完成了。

所以這時(shí)候我們需要自定義加載方式。

環(huán)境準(zhǔn)備

筆者新建了一個(gè)SpringBoot項(xiàng)目，maven基本配置如下：

?? ?<parent>
? ? ? ? <groupId>org.springframework.boot</groupId>
? ? ? ? <artifactId>spring-boot-starter-parent</artifactId>
? ? ? ? <version>2.2.5.RELEASE</version>
? ? ? ? <relativePath/> <!-- lookup parent from repository -->
? ? </parent>
? ? <dependencies>
? ? ? ? <dependency>
? ? ? ? ? ? <groupId>org.springframework.boot</groupId>
? ? ? ? ? ? <artifactId>spring-boot-starter</artifactId>
? ? ? ? </dependency>
? ? ? ? <dependency>
? ? ? ? ? ? <groupId>org.springframework.boot</groupId>
? ? ? ? ? ? <artifactId>spring-boot-devtools</artifactId>
? ? ? ? ? ? <scope>runtime</scope>
? ? ? ? ? ? <optional>true</optional>
? ? ? ? </dependency>
? ? ? ? <dependency>
? ? ? ? ? ? <groupId>org.springframework.boot</groupId>
? ? ? ? ? ? <artifactId>spring-boot-starter-test</artifactId>
? ? ? ? ? ? <scope>test</scope>
? ? ? ? </dependency>
? ? ? ? <!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 -->
? ? ? ? <dependency>
? ? ? ? ? ? <groupId>org.apache.commons</groupId>
? ? ? ? ? ? <artifactId>commons-lang3</artifactId>
? ? ? ? ? ? <version>3.4</version>
? ? ? ? </dependency>
? ? </dependencies>

自定義配置加載器

1.配置加載器processor

/**
?* 客戶(hù)端自定義加載配置
?*
?* @author lucky
?* @create 2020/3/7
?* @since 1.0.0
?*/
public class CustomerConfigLoadProcessor implements EnvironmentPostProcessor {
? ? @Override
? ? public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
? ? ? ? // 我們將主要邏輯都放在ConfigLoader去做
? ? ? ? environment.getPropertySources().addFirst(new ConfigLoader().getPropertySource());
? ? }
}? ?

2.在/resources/META-INF/下創(chuàng)建spring.factories文件

并添加

org.springframework.boot.env.EnvironmentPostProcessor=com.xw.study.configload.processor.CustomerConfigLoadProcessor? ??

3.實(shí)現(xiàn)配置加載邏輯

以上spring environment框架搭建好之后，在項(xiàng)目啟動(dòng)時(shí)候就會(huì)去加載ConfigLoader對(duì)應(yīng)的Properties信息到當(dāng)前運(yùn)行環(huán)境中。

下面就來(lái)看下加載邏輯：

/**
?* 配置加載器
?*
?* @author lucky
?* @create 2020/3/7
?* @since 1.0.0
?*/
public class ConfigLoader {
? ? private static Properties prop = new Properties();
? ? public static final String DEFAULT_CONFIG_FILE_NAME = "env.properties";
? ? public static final String SLASH = File.separator;
? ? public ConfigLoader() {
? ? ? ? loadProperties();
? ? }
? ? /**
? ? ?* 加載配置文件分為三個(gè)層次
? ? ?* 1.加載項(xiàng)目?jī)?nèi)置classpath:env.properties
? ? ?* 2.加載外部配置文件env.properties（會(huì)給定一個(gè)默認(rèn)路徑）
? ? ?* 3.加載JVM命令行參數(shù)
? ? ?*/
? ? private void loadProperties() {
? ? ? ? loadLocalProperties();
? ? ? ? loadExtProperties();
? ? ? ? loadSystemEnvProperties();
? ? }
? ? /**
? ? ?* 加載JVM命令行參數(shù)、Environment參數(shù)
? ? ?*/
? ? private void loadSystemEnvProperties() {
? ? ? ? prop.putAll(System.getenv());
? ? ? ? prop.putAll(System.getProperties());
? ? }
? ? /**
? ? ?* 加載外部配置文件env.properties（會(huì)給定一個(gè)默認(rèn)路徑）
? ? ?* 筆者所在公司，會(huì)根據(jù)不同的項(xiàng)目名，統(tǒng)一路徑設(shè)置為
? ? ?* /envconfig/{app.name}/env.properties
? ? ?*/
? ? private void loadExtProperties() {
? ? ? ? // 獲取全路徑
? ? ? ? // 所以需要首先在內(nèi)部env.properties中配置上app.name
? ? ? ? if (prop.containsKey("app.name")) {
? ? ? ? ? ? String appName = prop.getProperty("app.name");
? ? ? ? ? ? String path = SLASH + "envconfig" + SLASH + appName + SLASH + DEFAULT_CONFIG_FILE_NAME;
? ? ? ? ? ? Properties properties = ConfigUtil.loadProperties(path);
? ? ? ? ? ? if (null != properties) {
? ? ? ? ? ? ? ? prop.putAll(properties);
? ? ? ? ? ? }
? ? ? ? }
? ? }
? ? /**
? ? ?* 對(duì)外提供的方法，獲取配置信息
? ? ?* @param key key
? ? ?* @return 配置值
? ? ?*/
? ? public static String getValue(String key) {
? ? ? ? return prop.getProperty(key);
? ? }
? ? /**
? ? ?* 加載項(xiàng)目?jī)?nèi)置classpath:env.properties
? ? ?*/
? ? private void loadLocalProperties() {
? ? ? ? Properties properties = ConfigUtil.loadProperties(ConfigUtil.CLASSPATH_FILE_FLAG + DEFAULT_CONFIG_FILE_NAME);
? ? ? ? if (null != properties) {
? ? ? ? ? ? prop.putAll(properties);
? ? ? ? }
? ? }
? ? // 提供給environment.getPropertySources()的加載方法
? ? public PropertiesPropertySource getPropertySource() {
? ? ? ? return new PropertiesPropertySource("configLoader", prop);
? ? }
}

工具類(lèi)：ConfigUtil

/**
?* 工具類(lèi)
?* 直接從Sentinel項(xiàng)目拷貝過(guò)來(lái)的
?*
?* @author lucky
?* @create 2020/3/7
?* @since 1.0.0
?*/
public class ConfigUtil {
? ? public static final String CLASSPATH_FILE_FLAG = "classpath:";
? ? /**
? ? ?* <p>Load the properties from provided file.</p>
? ? ?* <p>Currently it supports reading from classpath file or local file.</p>
? ? ?*
? ? ?* @param fileName valid file path
? ? ?* @return the retrieved properties from the file; null if the file not exist
? ? ?*/
? ? public static Properties loadProperties(String fileName) {
? ? ? ? if (StringUtils.isNotBlank(fileName)) {
? ? ? ? ? ? if (absolutePathStart(fileName)) {
? ? ? ? ? ? ? ? return loadPropertiesFromAbsoluteFile(fileName);
? ? ? ? ? ? } else if (fileName.startsWith(CLASSPATH_FILE_FLAG)) {
? ? ? ? ? ? ? ? return loadPropertiesFromClasspathFile(fileName);
? ? ? ? ? ? } else {
? ? ? ? ? ? ? ? return loadPropertiesFromRelativeFile(fileName);
? ? ? ? ? ? }
? ? ? ? } else {
? ? ? ? ? ? return null;
? ? ? ? }
? ? }
? ? private static Properties loadPropertiesFromAbsoluteFile(String fileName) {
? ? ? ? Properties properties = null;
? ? ? ? try {
? ? ? ? ? ? File file = new File(fileName);
? ? ? ? ? ? if (!file.exists()) {
? ? ? ? ? ? ? ? return null;
? ? ? ? ? ? }
? ? ? ? ? ? try (BufferedReader bufferedReader =
? ? ? ? ? ? ? ? ? ? ? ? ?new BufferedReader(new InputStreamReader(new FileInputStream(file), getCharset()))) {
? ? ? ? ? ? ? ? properties = new Properties();
? ? ? ? ? ? ? ? properties.load(bufferedReader);
? ? ? ? ? ? }
? ? ? ? } catch (Throwable e) {
? ? ? ? ? ? e.printStackTrace();
? ? ? ? }
? ? ? ? return properties;
? ? }
? ? private static boolean absolutePathStart(String path) {
? ? ? ? File[] files = File.listRoots();
? ? ? ? for (File file : files) {
? ? ? ? ? ? if (path.startsWith(file.getPath())) {
? ? ? ? ? ? ? ? return true;
? ? ? ? ? ? }
? ? ? ? }
? ? ? ? return false;
? ? }
? ? private static Properties loadPropertiesFromClasspathFile(String fileName) {
? ? ? ? fileName = fileName.substring(CLASSPATH_FILE_FLAG.length()).trim();
? ? ? ? List<URL> list = new ArrayList<>();
? ? ? ? try {
? ? ? ? ? ? Enumeration<URL> urls = getClassLoader().getResources(fileName);
? ? ? ? ? ? list = new ArrayList<>();
? ? ? ? ? ? while (urls.hasMoreElements()) {
? ? ? ? ? ? ? ? list.add(urls.nextElement());
? ? ? ? ? ? }
? ? ? ? } catch (Throwable e) {
? ? ? ? ? ? e.printStackTrace();
? ? ? ? }
? ? ? ? if (list.isEmpty()) {
? ? ? ? ? ? return null;
? ? ? ? }
? ? ? ? Properties properties = new Properties();
? ? ? ? for (URL url : list) {
? ? ? ? ? ? try (BufferedReader bufferedReader =
? ? ? ? ? ? ? ? ? ? ? ? ?new BufferedReader(new InputStreamReader(url.openStream(), getCharset()))) {
? ? ? ? ? ? ? ? Properties p = new Properties();
? ? ? ? ? ? ? ? p.load(bufferedReader);
? ? ? ? ? ? ? ? properties.putAll(p);
? ? ? ? ? ? } catch (Throwable e) {
? ? ? ? ? ? ? ? e.printStackTrace();
? ? ? ? ? ? }
? ? ? ? }
? ? ? ? return properties;
? ? }
? ? private static Properties loadPropertiesFromRelativeFile(String fileName) {
? ? ? ? return loadPropertiesFromAbsoluteFile(fileName);
? ? }
? ? private static ClassLoader getClassLoader() {
? ? ? ? ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
? ? ? ? if (classLoader == null) {
? ? ? ? ? ? classLoader = ConfigUtil.class.getClassLoader();
? ? ? ? }
? ? ? ? return classLoader;
? ? }
? ? private static Charset getCharset() {
? ? ? ? // avoid static loop dependencies: SentinelConfig -> SentinelConfigLoader -> ConfigUtil -> SentinelConfig
? ? ? ? // so not use SentinelConfig.charset()
? ? ? ? return Charset.forName(System.getProperty("csp.sentinel.charset", StandardCharsets.UTF_8.name()));
? ? }
? ? public static String addSeparator(String dir) {
? ? ? ? if (!dir.endsWith(File.separator)) {
? ? ? ? ? ? dir += File.separator;
? ? ? ? }
? ? ? ? return dir;
? ? }
? ? public ConfigUtil() {
? ? }
}

代碼不算復(fù)雜，筆者不再詳述。

根據(jù)以上的加載順序，就可以實(shí)現(xiàn) 命令行 > 外部配置文件 > 內(nèi)部配置文件的需求。

4.測(cè)試

這個(gè)比較簡(jiǎn)單了，用戶(hù)可自行測(cè)試

1）只有內(nèi)部配置文件

在/resources下創(chuàng)建env.properties文件

2）內(nèi)部配置文件、外部配置文件均存在

滿(mǎn)足1)的同時(shí)(注意有一個(gè)必備項(xiàng)為app.name，筆者自定義為configload)，在本地磁盤(pán)創(chuàng)建/envconfig/configload/env.properties文件

3）添加命令行參數(shù)

在滿(mǎn)足2）的同時(shí)，在啟動(dòng)行添加參數(shù)（-D的方式）

筆者測(cè)試代碼：

@SpringBootTest(classes = ConfigloadApplication.class)
@RunWith(SpringRunner.class)
public class ConfigloadApplicationTests {
? ? @Test
? ? public void contextLoads() {
? ? ? ? String s = ConfigLoader.getValue("zookeeper.serverList");
? ? ? ? System.out.println(s);
? ? }
}