yaml语法及规范

文章内容：

• YAML语法规范；
• YAML文本块得使用；
• YAML锚点与引用；
• YAML存量，数据类型约定；
• YAML对象及数组的使用规则。

YAML简介

YAML语言的设计参考了JSON，XML和SDL等语言。YAML 强调以数据为中心,简洁易读,编写简单。

有意思的命名
YAML全称是"YAML Ain’t a Markup Language"（YAML不是一种置标语言）的递归缩写。
在开发的这种语言时，YAML 的意思其实是：“Yet Another Markup Language”（仍是一种置标语言）。

YAML语法及规范

语法特点

• 大小写敏感
• 通过缩进表示层级关系
• 禁止使用tab缩进，只能使用空格键
• 缩进的空格数目不重要，只要相同层级左对齐即可
• 使用#表示注释

YAML 支持的数据结构有三种
对象：键值对的集合，又称为映射（mapping）/ 哈希（hashes） / 字典（dictionary）
数组：一组按次序排列的值，又称为序列（sequence） / 列表（list）
纯量（scalars）：单个的、不可再分的值

引号

双引号""：不会转义字符串里面的特殊字符，特殊字符作为本身想表示的意思。

name: "123\n123" 

输出： 123 换行 123

单引号''：会将字符串里面的特殊字符转义为字符串处理

name: '123\n123'

输出： 123\n123

如果不加引号将会转义特殊字符，当成字符串处理

文本块

|：使用|标注的文本内容缩进表示的块，可以保留块中已有的回车换行

value: |
   hello
   world!

输出：hello 换行 world！

+表示保留文字块末尾的换行，-表示删除字符串末尾的换行。

value: |
hello

value: |-
hello

value: |+
hello

输出：hello\n hello hello\n\n(有多少个回车就有多少个\n)

注意 “|” 与 文本之间须另起一行

>：使用 > 标注的文本内容缩进表示的块，将块中回车替换为空格，最终连接成一行

value: > hello
world!

输出：hello 空格 world！

注意 “>” 与 文本之间的空格

使用定界符“”（双引号）、‘’（单引号）或回车表示的块，最终表示成一行。

**锚点与引用 **

使用 & 定义数据锚点（即要复制的数据），使用 * 引用锚点数据（即数据的复制目的地）

name: &a yaml
book: *a
books: 
   - java
   - *a
   - python

输出book： yaml
输出books：[java,yaml,python]

注意*引用部分不能追加内容

** 存量，数据类型约定 **

纯量是最基本的、不可再分的值。

• 字符串
  使用’'或""或不使用引号

value0: 'hello World!'
value1: "hello World!"
value2: hello World!

• 布尔值
  true或false表示。

• 数字

12 #整数 
014 # 八进制整数 
0xC ＃十六进制整数 
13.4 ＃浮点数 
1.2e+34 ＃指数 
.inf空值 ＃无穷大

• 空值
  null或~表示

• 日期
  使用 iso-8601 标准表示日期

date: 2018-01-01t16:59:43.10-05:00

在springboot中yaml文件的时间格式 date: yyyy/MM/dd HH:mm:ss

• 强制类型转换
  YAML 允许使用个感叹号!，强制转换数据类型，单叹号通常是自定义类型，双叹号是内置类型。

money: !!str
123
date: !Boolean
true

内置类型：

!!int # 整数类型 
!!float # 浮点类型 
!!bool # 布尔类型 
!!str # 字符串类型 
!!binary # 也是字符串类型 
!!timestamp # 日期时间类型 
!!null # 空值 
!!set # 集合 
!!omap,!!pairs # 键值列表或对象列表
!!seq # 序列，也是列表 !!map # 键值表

对象

Map（属性和值）（键值对）的形式：
key:(空格)v ：表示一堆键值对，空格不可省略。

car:
    color: red
    brand: BMW

一行写法

car:{color: red，brand: BMW}

相当于json：

{"color":"red","brand":"BMW"}

数组

一组连词线开头的行，构成一个数组。

brand:
   - audi
   - bmw
   - ferrari

一行写法

brand: [audi,bmw,ferrari]

相当于json

["auri","bmw","ferrari"]

参考
yaml 1.2规范
360doc
阮一峰的网络日志