SpringBoot中yaml配置对象

转载请在页首注明作者与出处

一：前言

YAML可以代替传统的xx.properties文件，但是它支持声明map,数组，list，字符串，boolean值，数值，NULL，日期，基本满足开发过程中的所有配置。

长期以来，我们使用xml配置文件与properties配置文件。但是YAML却基本无人使用，故有了此文

二：常用配置文件的优缺点及演示

2.1:优缺点

XML优点:xml配置文件所用最多的地方就是spring的配置文件了。当然，它也很灵活，它以自定义的标签可以满足种种需要，而且可以声明多个同样的标签。

XML缺点:配置起来麻烦，读取繁琐。

properties优点:读取简单，配置简单，spring可以直接加载properties文件，不需要我们写代码读取。

properties缺点:但是不支持配置多个同样的属性，这是最大的缺点。

2.2:优缺点演示

这里演示一下properties的缺点。

假定我有一个应用场景，我需要配置多台redis做为redis的集群。

现在写properties的配置文件

redis.ip=10.1.10.1
redis.port=
redis.password=

好吧，我只能配置一个。

当然，其实我也可以这样配置

#第一台
redis1.ip=10.1.10.1
redis1.port=
redis1.password=123456
#第二台

redis2.ip=10.1.10.1
redis2.port=6379
redis2.password=123456

以上面的这种配置，我基本上可以无限的配置，但是这对于代码上面读取又是一个问题，我根本不知道配置文件中配置了多少个节点。

这个时候我会想到xml的配置方式，它灵活，多变。

<xml>
    <redis>
        <node>
            <ip>10.1.2.1</ip>
            <port>6379</port>
            <password>123</password>
        </node>
        <node>
            <ip>10.1.2.1</ip>
            <port>6379</port>
            <password>123</password>
        </node>
        <node>
            <ip>10.1.2.1</ip>
            <port>6379</port>
            <password>123</password>
        </node>
        <node>
            <ip>10.1.2.1</ip>
            <port>6379</port>
            <password>123</password>
        </node>
    </redis>
</xml>

xml这种方式就完全支持多个节点的配置，我只需要遍历redis下的所有node节点就行了，但是它的配置与读取就相对繁琐了。

三：YAML的配置文件

第一次接触YAML是在spring-boot中的，刚开始接触的时候也是有点抵制，但是慢慢的就越来越喜欢它了。

3.1:基本用法

yml不能用制表符，必须输入空格，但是可以输入任意个空格，只需要对齐就行了。

project:
  redis:
    ip: 10.8.16.232      #冒号后台必须接空格，读取的时候会去掉前后空格，用#可以进行注释
    port: 6379
  mysql:
    url: jdbc://....
    user: root
    password: 111

这是一个简单的yaml,它就相当于properties中的

project.redis.ip=10.8.16.232
project.redis.port=6379
project.mysql.url=xxx
project.mysql.root=12
project.mysq.password=xx

可以看到yml就省略了前面的部分，并且在spring中，使用@Value()注解，同样可以把该值取出来

3.2:配置对象

现在我们用yml来解决之前遇到配置多个redis的问题

xx:
  test:
    hehe: normal
    txtarray: 1,2,3,a  #这种对象形式的，只能单独写一个对象去接收，所以无法使用@value注解获取
    listmap:
      - host: zxj
        port: 10
        active: 9
      - host: ly
        port: 11
        active: 8
    liststr:
      - name
      - value
    map:
      a: a
      b: b    

可以看到在xxx.test.listmap中，我们定义了两个集合，以- 开头的，就是代表着数组集合。

可以参考 http://www.ruanyifeng.com/blog/2016/07/yaml.html?f=tt   来学习YAML的语法

3.2:java读取

在spring-boot中，定义一个application.yml，然后写入上面的配置，

然后定义这样一个类

import java.util.Arrays;
import java.util.List;
import java.util.Map;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

/**
 * @author 朱小杰
 * @since 2016年11月14日 上午10:33:36
 * 版本 1.0<br>
 * @see 需要生成set方法
 */
@Component
@ConfigurationProperties(prefix = "xx.test")
public class ConfigProperties {

    private String hehe;

    private String[] txtarray;

    private List<Map<String,String>> listmap;

    private List<String> liststr;

    private Map<String,String> map;

    /**
     * @param 设置 hehe
     */
    public void setHehe(String hehe) {
        this.hehe = hehe;
    }

    /**
     * @param 设置 txtarray
     */
    public void setTxtarray(String[] txtarray) {
        this.txtarray = txtarray;
    }

    /**
     * @param 设置 listmap
     */
    public void setListmap(List<Map<String, String>> listmap) {
        this.listmap = listmap;
    }

    /**
     * @param 设置 liststr
     */
    public void setListstr(List<String> liststr) {
        this.liststr = liststr;
    }

    /**
     * @return 获取 hehe
     */
    public String getHehe() {
        return hehe;
    }

    /**
     * @return 获取 txtarray
     */
    public String[] getTxtarray() {
        return txtarray;
    }

    /**
     * @return 获取 listmap
     */
    public List<Map<String, String>> getListmap() {
        return listmap;
    }

    /**
     * @return 获取 liststr
     */
    public List<String> getListstr() {
        return liststr;
    }

    /**
     * @return 获取 map
     */
    public Map<String, String> getMap() {
        return map;
    }

    /**
     * @param 设置 map
     */
    public void setMap(Map<String, String> map) {
        this.map = map;
    }

    /**
     * @see [说明这个方法]
     * @return
     * @since 2016年11月14日 上午10:38:49
     */
    @Override
    public String toString() {
        return "ConfigProperties [hehe=" + hehe + ", txtarray=" + Arrays.toString(txtarray) + ", listmap=" + listmap
                + ", liststr=" + liststr + ", map=" + map + "]";
    }

}

属性名必须与YAML中的参数名一致，必须声明get/set方法，get与set都要。而且使用了yaml的对象，不能使用@Value("${}")注解来获取值，当然，如果是普通的映射是可以的，数组，map，list这种是不行的，只能通过上面的方式，注入到一个对象里面去，

然后再@Autowird取这个对象来获取值