使用Spring從YAML文件讀取內(nèi)容映射為Map方式

更新時間：2022年02月17日 09:34:24 作者：盲目的拾荒者

這篇文章主要介紹了使用Spring從YAML文件讀取內(nèi)容映射為Map方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教

從YAML文件讀取內(nèi)容映射為Map

如何在Spring Boot中從YAML文件注入到Map。

首先，將對Spring框架中的YAML文件有一些了解。然后，通過一個實際示例展示如何將YAML屬性綁定到Map。

Spring框架中的YAML文件

使用YAML文件存儲外部配置數(shù)據(jù)是一種常見的做法。基本上，Spring支持使用YAML文檔作為屬性的替代方法，并在后臺使用SnakeYAML對其進行解析。

看看典型的YAML文件是什么樣的：

server:
? port: 8090
? application:
? ? name: myapplication
? ? url: http://myapplication.com

從上面可以看出，YAML文件是不言自明的，更易于閱讀。實際上，YAML提供了一種簡潔的方式來存儲分層配置數(shù)據(jù)。

默認情況下，Spring Boot在應(yīng)用程序啟動時從application.properties或application.yml讀取配置屬性。但是，我們可以使用@PropertySource加載自定義的YAML文件。

既然熟悉了什么是YAML文件，看看如何在Spring Boot中將YAML屬性作為Map注入。

從YAML文件內(nèi)容注入Map

Spring Boot通過提供一個方便的注解@ConfigurationProperties，將數(shù)據(jù)的外部化提升到了一個新的水平。引入此注解是為了輕松地將配置文件中的外部屬性直接注入Java對象。

接下來將介紹如何使用@ConfigurationProperties注解將YAML屬性綁定到bean類中。

首先，在application.yml中定義一些鍵值屬性：

server:
? application:
? ? name: InjectMapFromYAML
? ? url: http://injectmapfromyaml.dev
? ? description: How To Inject a map from a YAML File in Spring Boot
? config:
? ? ips:
? ? ? - 10.10.10.10
? ? ? - 10.10.10.11
? ? ? - 10.10.10.12
? ? ? - 10.10.10.13
? ? filesystem:
? ? ? - /dev/root
? ? ? - /dev/md2
? ? ? - /dev/md4
? users:?
? ? root:
? ? ? username: root
? ? ? password: rootpass
? ? guest:
? ? ? username: guest
? ? ? password: guestpass

其次，創(chuàng)建一個bean類MapServerProperties來封裝將配置屬性綁定到Maps的邏輯：

@Configuration
@ConfigurationProperties(prefix = "server")
@Data
public class MapServerProperties {
? ? private Map<String, String> application;
? ? private Map<String, List<String>> config;
? ? private Map<String, Credential> users;
? ? @Data
? ? public static class Credential {
? ? ? ? private String username;
? ? ? ? private String password;
? ? }
}

如上面所見，我們用@ConfigurationProperties裝飾了MapServerProperties類。這樣，告訴Spring將具有指定前綴的所有屬性映射到MapServerProperties的對象。

測試

@RunWith(SpringRunner.class)
@SpringBootTest
public class MapFromYamlIntegrationTest {
? ? @Autowired
? ? private MapServerProperties mapServerProperties;
? ? @Test
? ? public void whenYamlFileProvidedThenInjectSimpleMap() {
? ? ? ? assertThat(mapServerProperties.getApplication())
? ? ? ? ? ? ? ? .containsOnlyKeys("name", "url", "description");
? ? ? ? assertThat(mapServerProperties.getApplication()
? ? ? ? ? ? ? ? .get("name")).isEqualTo("InjectMapFromYAML");
? ? }
? ? @Test
? ? public void whenYamlFileProvidedThenInjectComplexMap() {
? ? ? ? assertThat(mapServerProperties.getConfig()).hasSize(2);
? ? ? ? assertThat(mapServerProperties.getConfig()
? ? ? ? ? ? ? ? .get("ips")
? ? ? ? ? ? ? ? .get(0)).isEqualTo("10.10.10.10");
? ? ? ? assertThat(mapServerProperties.getUsers()
? ? ? ? ? ? ? ? .get("root")
? ? ? ? ? ? ? ? .getUsername()).isEqualTo("root");
? ? }
}

@ConfigurationProperties與@Value

快速比較@ConfigurationProperties和@Value。

盡管兩個注解均可用于從配置文件注入屬性，但它們卻大不相同。這兩個注釋之間的主要區(qū)別在于，每個注釋具有不同的用途。

簡而言之，@Value允許我們通過鍵直接注入特定的屬性值。但是，@ConfigurationProperties批注將多個屬性綁定到特定對象，并提供通過映射對象對屬性的訪問。

通常，在注入配置數(shù)據(jù)時，Spring建議在@Value上使用@ConfigurationProperties。 @ConfigurationProperties提供了一種在結(jié)構(gòu)化對象中集中和分組配置屬性的好方法，以后我們可以將其注入其他bean。

配置文件yml中的map形式

yml中的格式

tes:
  maps: {key1: 12,key2: 34}

或者

tes:
  maps:
    key1: 15
    key2: 2

創(chuàng)建一個類

然后創(chuàng)建對應(yīng)類型的字段(注意下這個類的那兩個注釋了的注解)

package com.etc.lzg;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
import org.springframework.stereotype.Component;
import java.util.Map;
@Data
@Component
//@Configuration //這個我這里雖然存在時能成功,不過我注釋了也是可以的,這個是看網(wǎng)上有人寫就跟著寫上的
//@PropertySource(value = {"classpath:/application.yml"}, encoding = "utf-8") //有的人是寫了這個注解能成功,但是我這邊不能有這個注解,有的話,就連編譯都會報錯
@ConfigurationProperties(prefix = "tes")
public class MapTest {
    private Map<String, String> maps;
}

引用

package com.etc.lzg;
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.SpringRunner;
@RunWith(SpringRunner.class)
@SpringBootTest
public class LzgApplicationTests {
    @Autowired
    private MapTest mapTest;
    
    @Test
    public void contextLoads() {
        System.out.println(mapTest.toString());
        System.out.println("key1="+mapTest.getMaps().get("key1"));
    }
}