#华为云·寻找黑马程序员#微服务-你真的懂 Yaml 吗？

在Java 的世界里，配置的事情都交给了 Properties，要追溯起来这个模块仍是从古老的JDK1.0 就开始了的。

"天哪，这但是20年前的东西了，我竟然还在用 Properties.."

然而，本文的主角并非Properties，而是Yaml。这是新时代里微服务架构上的宠儿，和 Properties 相比起来，Yaml 显得有些弄潮儿。
以往的大多数项目里，咱们均可以发现 Properties配置文件的踪影，这包括用于业务属性配置的、机机接口的、国际化的等等用途。
而少许的一些状况下，也存在一些"混合式"的作法，好比：

• 使用 Xml 来表示一些模板

• 使用一个 Json 格式化的字符串

• 裸奔的文本格式，应用自解析
  ...

混杂的配置方式每每出如今一些充满"坏味道"的项目里头，由于代码陈旧、斯人已矣 等缘由，很难造成统一的方式。
然而，除开 Properties 属性文件这种简单的配置方式以外，采用其余的方法不外乎都是为了适应配置复杂、多元化的诉求。

那么，Yaml 就是应对这种场景而产生的，在 SpringBoot 的官方文档中，有很多篇幅是 使用了 Yaml 语法的配置格式。
下面介绍一下 Yaml 以及它是如何使用的。

1、什么是 Yaml

来自百科的定义：

"Yaml 是一个可读性高，易用的数据序列化格式，由 Clark Evans 在2001年首次发表。"

可见 Yaml 并非一个很新的东西，只是在之前接触的人很少罢了。此外，Yaml也被各类编程语言及框架所支持， 通用性很高。
在Java体系中，通常的微服务框架都支持甚至优先推荐使用 Yaml 做为首选的配置语言。

而 Yaml 自己具备什么特色？ 看看下面的一个实例：

environments:
    dev:
        url: https://dev.example.com
  name: Developer Setup
    prod:
        url: https://another.example.com
        name: My Cool App

这段语法等价的 Properties 为：

environments.dev.url=https://dev.example.com
environments.dev.name=Developer Setup
environments.prod.url=https://another.example.com
environments.prod.name=My Cool App

可见， yaml 相对来讲更加的结构化，更适合用来表达一个对象。
它在语法上有这样的特色：

• 大小写敏感

• 使用空格缩进表示层级关系，摒弃使用Tab键，这主要是考虑到不一样平台上文本展示时须要对齐

• 缩进的空格数目不重要，只要相同层级的元素左侧对齐便可

• 使用 # 开头做为注释行

• 使用 链接符(-)开头来描述数组元素

对比 Properties 
Properties 能够很好的实现 Key-Value 的配置，包括做为一些国际化内容的配置方式。
但 Properties 很难表现多层级的嵌套关系，此时若是用 Yaml 能够较好的弥补该短板。

对比 Json
Yaml 与 Json自己没有太多的优劣之分，二者都是结构化的表达式语言，可是Json的设计重点在于简单易用、方便传输的特性；
而 Yaml 则侧重于可读性(更加在意外观)，几乎能够把 Yaml 看作是 Json 的一个"超集"，便可读性更高(更漂亮) 的结构化格式。
此外，Json更加便于生成和解析，适合在各类跨语言、分布式的环境中传输和交互；与此同时， Yaml 则通常只是用做的配置较多。

关于 Yaml 的定义能够访问下面的地址：
http://www.yaml.org/spec/1.2/spec.html

2、Yaml 的语法

Yaml 是很是简单的， 它所定义的元素只有三个：

• 对象：就是键值对的集合，对应于Java 中的 HashMap

• 数组：指一组按序排列的值，对应于Java 中的 List

• 单值：单个的、不可再分的值，好比 3，"Jackson"

对象如何表示
一个对象的属性、嵌套关系经过空格缩进对齐来表示，以下：

article:
    title: 一我的的自白书
    author:
        name: 陈玲
        gender: female

数组如何表示
数组的元素经过链接符(-)来表示，以下：

article:
    title: 一我的的自白书
    tags:
        - 传记
        - 社会
        - 人物

构成对象、数组内容的基本单元是单值，Yaml支持的单个值的类型有七种，以下：

类型	范例
字符串	Bob
布尔值	true
整数	199
浮点数	19.91
Null	~
时间	2001-12-14T22.09.10+08:00
日期	2019-01-09

其中，日期、时间使用的是 ISO 8601 国际标准格式，关于它的定义能够参考：
https://www.w3.org/TR/NOTE-datetime

通常状况下单个值会在一行内结束。但若是遇到多行的字符串，可使用一些特殊字符表示，
好比：

text: |
  Hello
  World

对应的结果为：

{ text: 'Hello\nWorld\n' }

能够用+表示保留字符串末尾的换行，-表示删除字符串末尾的换行：

text1: |+
  Hello


text2: |-
  Hello

对应的结果为：

{ text1: 'Hello\n\n\n', text2: 'Hello' }

除此以外，Yaml 还能够支持引用、函数、正则表达式等高级用法，但项目上通常不多用到。

3、操做 Yaml

目前用来操做 Yaml 的经常使用组件是 Snake Yaml，这个库支持标准的 Yaml 1.1 版本。

SpringBoot 官方文档也介绍了整合该框架的方式，参考下面的地址：
https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#boot-features-external-config-loading-yaml

下面提供 将SnakeYaml 整合到项目的样例。

A. 引入框架

在Maven的pom.xml文件中添加：

<dependency>
    <groupId>org.yaml</groupId>
    <artifactId>snakeyaml</artifactId>
    <version>1.21</version>
</dependency>

B. 代码片断

实现加载配置文件

以下面的代码，实现了从类路径config.yml文件中加载 yaml 配置内容：

InputStream inputStream = YamlUtil.class.getClassLoader()
        .getResourceAsStream("config.yml");

Yaml yaml = new Yaml();
Map<String, Object> objectMap = yaml.load(inputStream);
System.out.println(objectMap.get("path"));

实现对象转换

定义以下的Pojo 对象：

public static class A{
    private String name = "hello";
    private List<B> bs = new ArrayList<B>();

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public List<B> getBs() {
        return bs;
    }

    public void setBs(List<B> bs) {
        this.bs = bs;
    }
}

public static class B{
    private String id = UUID.randomUUID().toString();

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }
}

经过 SnakeYaml 将对象输出为 Yaml 格式的代码：

A a = new A();
a.getBs().add(new B());
a.getBs().add(new B());

Yaml yaml = new Yaml();
String aString = yaml.dumpAsMap(a);
System.out.println(aString);

输出结果以下：

bs:
- id: b3688f05-ea7e-436b-bc9a-9c5df555c7fd
- id: 7906224d-8ecc-43b8-bc3b-07985bc18ebd
name: hello

此时若是但愿将Yaml 文本反过来转换为 A 对象，能够执行下面的代码：

A a1 = new Yaml().parseToObject(aString, A.class);
...

C. 完整案例

最终，咱们能够将 Yaml 文档的操做封装为一个工具类，方便在业务代码中集成。

YamlUtil.java

public class YamlUtil {

    /**
     * 从资源文件加载内容，并解析为Map对象
     *
     * @param path
     * @return
     */
    public static Map<String, Object> loadToMap(String path) {
        if (StringUtils.isEmpty(path)) {
            return Collections.emptyMap();
        }

        InputStream inputStream = YamlUtil.class.getClassLoader()
                .getResourceAsStream(path);

        Yaml yaml = new Yaml();
        Map<String, Object> objectMap = yaml.load(inputStream);
        return objectMap;
    }

    /**
     * 将字符串解析为Map对象
     *
     * @param content
     * @return
     */
    public static Map<String, Object> parseToMap(String content) {
        if (StringUtils.isEmpty(content)) {
            return Collections.emptyMap();
        }

        Yaml yaml = new Yaml();
        Map<String, Object> objectMap = yaml.load(content);
        return objectMap;
    }

    /**
     * 将字符串解析为类对象
     *
     * @param content
     * @param clazz
     * @param <T>
     * @return
     */
    public static <T> T parseToObject(String content, Class<T> clazz) {
        if (StringUtils.isEmpty(content) || clazz == null) {
            return null;
        }

        Yaml yaml = new Yaml(new Constructor(clazz));
        T object = yaml.load(content);
        return object;
    }

    /**
     * 格式化对象
     *
     * @param object
     * @return
     */
    public static String format(Object object) {
        Yaml yaml = new Yaml();
        return yaml.dumpAsMap(object);
    }

}

至此，咱们已经完成了 Yaml 的读写。固然，除了上述的Snake Yaml 以外，还可使用 流行的 Jackson 组件了进行解析，这里再也不过多赘述，有兴趣的朋友能够自行尝试。

参考文档

阮一峰-YAML语言教程：
http://www.ruanyifeng.com/blog/2016/07/yaml.html

SnakeYaml 官方文档：
https://bitbucket.org/asomov/snakeyaml/wiki/Documentation

Yaml 1.2 规范：
http://www.yaml.org/spec/1.2/spec.html

SpringBoot-LoadingYaml
https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#boot-features-external-config-loading-yaml

来源：华为云征文  做者：zale