YAML&snakeyaml简介

简介

官网
YAML，YAML Ain’t Markup Language
What It Is: YAML is a human friendly data serialization standard for all programming languages.
最新版本1.2，Java客户端有sankeyaml，camel。

YAML 语言（/ˈjæməl/ ），一种通用的数据串行化格式。
基本语法规则：

• 大小写敏感
• 使用缩进表示层级关系
• 缩进时不允许使用Tab键，只允许使用空格
• 缩进的空格数目不重要（不过一般都是2个空格），只要相同层级的元素左侧对齐即可
• # 表示注释，从这个字符一直到行尾，都会被解析器忽略。

YAML支持三种数据结构：

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

数据结构

对象

对象的一组键值对，使用冒号结构表示。Yaml 也允许另一种写法，将所有键值对写成一个行内对象。
hash: { name: Steve, foo: bar }

数组

一组连词线开头的行，构成一个数组。 数据结构的子成员是一个数组，则可以在该项下面缩进一个空格。数组也可以采用行内表示法。

纯量

最基本的、不可再分的值。
null用~表示：girlfriend: ~
时间采用 ISO8601 格式：iso8601: 2001-12-14t21:59:43.10-05:00
日期采用复合 iso8601 格式的年、月、日表示：date: 1976-07-31
YAML 允许使用两个感叹号强制转换数据类型：

e: !!str 123
f: !!str true

补充

字符串
字符串默认不使用引号表示。
如果字符串之中包含空格或特殊字符，需要放在引号之中，单引号和双引号都可以使用，双引号不会对特殊字符转义。单引号之中如果还有单引号，必须连续使用两个单引号转义。字符串可以写成多行，从第二行开始，必须有一个单空格缩进。换行符会被转为空格。多行字符串可以使用|保留换行符，也可以使用>折叠换行。+表示保留文字块末尾的换行，-表示删除字符串末尾的换行。字符串之中可以插入 HTML 标记。

引用

锚点&和别名*，可以用来引用。

defaults: &defaults
  adapter: postgres
  host: localhost
development: 
  database: myapp_development
  <<: *defaults
test:
  database: myapp_test
  <<: *defaults

等同于下面的代码。

defaults:
  adapter: postgres
  host: localhost
development:
  database: myapp_development
  adapter:  postgres
  host: localhost
test:
  database: myapp_test
  adapter:  postgres
  host: localhost

&用来建立锚点（defaults），<<表示合并到当前数据，*用来引用锚点。

其他

在线校验yaml文件格式
http://www.bejson.com/validators/yaml/

snakeyaml

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

入门

参考

1. http://www.ruanyifeng.com/blog/2016/07/yaml.html