如何將YAML中的列表映射到Java List

1. 概述

在這個簡短的教程中，咱們將進一步瞭解如何在Spring Boot中將YAML列表映射到列表中。web

咱們首先介紹一些如何在YAML中定義列表的背景知識。而後，咱們將深刻研究如何將YAML列表綁定到對象列表。微信

2. 快速回顧一下YAML中的列表

簡而言之，YAML是一種人類可讀的數據序列化標準，它提供了一種簡潔而清晰的方式來編寫配置文件。YAML的優勢是它支持多種數據類型，如列表、映射和標量類型。app

YAML列表中的元素使用「-」字符定義，它們共享相同的縮進級別:編輯器

yamlconfig:
  list:
    - item1
    - item2
    - item3
    - item4

與properties對比:學習

yamlconfig.list[0]=item1
yamlconfig.list[1]=item2
yamlconfig.list[2]=item3
yamlconfig.list[3]=item4

事實上，與屬性文件相比，YAML的層次性顯著加強了可讀性。YAML的另外一個有趣的特性是能夠爲不一樣的Spring配置文件定義不一樣的屬性。測試

值得一提的是，Spring引導爲YAML配置提供了開箱即用的支持。按照設計，Spring引導從應用程序加載配置屬性。yml啓動，沒有任何額外的工做。url

3.將一個YAML列表綁定到一個簡單的對象列表

Spring Boot提供了@ConfigurationProperties註釋來簡化將外部配置數據映射到對象模型的邏輯。spa

在本節中，咱們將使用@ConfigurationProperties將一個YAML列表綁定到list中。.net

咱們首先在application.yml中定義一個簡單的列表:設計

application:
  profiles:
    - dev
    - test
    - prod
    - 1
    - 2

而後，咱們將建立一個簡單的ApplicationProps POJO來保存將YAML列表綁定到對象列表的邏輯:

@Component
@ConfigurationProperties(prefix = "application")
public class ApplicationProps {

    private List<Object> profiles;

    // getter and setter

}

ApplicationProps類須要用@ConfigurationProperties進行裝飾，以表達將全部帶有指定前綴的YAML屬性映射到ApplicationProps對象的意圖。

要綁定profiles列表，咱們只須要定義一個list類型的字段，其他的由@ConfigurationProperties註釋處理。

注意，咱們使用@Component將ApplicationProps類註冊爲一個普通的Spring bean。所以，咱們能夠以與任何其餘Spring bean相同的方式將其注入到其餘類中。

最後，咱們將ApplicationProps bean注入到一個測試類中，並驗證咱們的概要文件YAML列表是否被正確注入爲list:

@ExtendWith(SpringExtension.class)
@ContextConfiguration(initializers = ConfigFileApplicationContextInitializer.class)
@EnableConfigurationProperties(value = ApplicationProps.class)
class YamlSimpleListUnitTest {

    @Autowired
    private ApplicationProps applicationProps;

    @Test
    public void whenYamlList_thenLoadSimpleList() {
        assertThat(applicationProps.getProfiles().get(0)).isEqualTo("dev");
        assertThat(applicationProps.getProfiles().get(4).getClass()).isEqualTo(Integer.class);
        assertThat(applicationProps.getProfiles().size()).isEqualTo(5);
    }
}

4. 將YAML列表綁定到複雜列表

如今，讓咱們進一步瞭解如何將嵌套的YAML列表注入到複雜的結構化列表中。

首先，讓咱們添加一些嵌套列表到application.yml:

application:
  // ...
  props:
    -
      name: YamlList
      url: http://yamllist.dev
      description: Mapping list in Yaml to list of objects in Spring Boot
    -
      ip: 10.10.10.10
      port: 8091
    -
      email: support@yamllist.dev
      contact: http://yamllist.dev/contact
  users:
    -
      username: admin
      password: admin@10@
      roles:
        - READ
        - WRITE
        - VIEW
        - DELETE
    -
      username: guest
      password: guest@01
      roles:
        - VIEW

在這個例子中，咱們將道具屬性綁定到一個 List<Map<String, Object>>.。相似地，咱們將把用戶映射到User對象列表中。

可是，在用戶的狀況下，全部的項共享相同的鍵，因此爲了簡化它的映射，咱們可能須要建立一個專用的用戶類，將鍵封裝爲字段:

public class ApplicationProps {

    // ...

    private List<Map<String, Object>> props;
    private List<User> users;

    // getters and setters

    public static class User {

        private String username;
        private String password;
        private List<String> roles;

        // getters and setters

    }
}

如今咱們驗證嵌套的YAML列表被正確映射:

@ExtendWith(SpringExtension.class)
@ContextConfiguration(initializers = ConfigFileApplicationContextInitializer.class)
@EnableConfigurationProperties(value = ApplicationProps.class)
class YamlComplexListsUnitTest {

    @Autowired
    private ApplicationProps applicationProps;

    @Test
    public void whenYamlNestedLists_thenLoadComplexLists() {
        assertThat(applicationProps.getUsers().get(0).getPassword()).isEqualTo("admin@10@");
        assertThat(applicationProps.getProps().get(0).get("name")).isEqualTo("YamlList");
        assertThat(applicationProps.getProps().get(1).get("port").getClass()).isEqualTo(Integer.class);
    }

}

5. 結論

在本教程中，咱們學習瞭如何將YAML列表映射到Java列表。咱們還檢查瞭如何將複雜列表綁定到定製pojo。

本文分享自微信公衆號 - Java碼農（jarcoder）。
若有侵權，請聯繫 support@oschina.cn 刪除。
本文參與「OSC源創計劃」，歡迎正在閱讀的你也加入，一塊兒分享。