一看就喷亏的小猿

一看就喷亏的小猿

简介

      YAML 是一种简洁的非标记语言(YAML Ain’t Markup Language),YAML以数据为中心,使用空白,缩进,分行组织数据,从而使得表示更加简洁易读, 常用于作为配置文件, 比json更加简洁。

YAML 的设计目标

  • 人类容易阅读
  • 可用于不同程序间的数据交换
  • 适合描述程序所使用的数据结构,特别是脚本语言
  • 丰富的表达能力与可扩展性
  • 易于使用

YAML与XML、JSON比较

  • YAML 与 XML:具有 XML 同样的优点,但比 XML 更加简单、敏捷等
  • YAML 与 JSON:

            1、JSON 可以看作是 YAML 的子集,也就是说 JSON 能够做的事情,YAML 也能够做

            2、YAML 能表示得比 JSON 更加简单和阅读,例如“字符串不需要引号”。所以 YAML 容易可以写成 JSON 的格式,但并不建议这种做

            3、YAML 能够描述比 JSON 更加复杂的结构,例如“关系锚点”可以表示数据引用(如重复数据的引用)

YAML的适用范围

  •  由于实现简单,解析成本很低,YAML特别适合在脚本语言中使用。列一下现有的语言实现:Ruby,Java,Perl,Python,PHP,OCaml,JavaScript。除了Java,其他都是脚本语言.
  • YAML比较适合做序列化。因为它是宿主语言数据类型直转的,由于兼容性问题,不同语言间的数据流转建议现在不要用YAML.
  • YAML做配置文件也不错。比如Ruby on Rails的配置就选用的YAML。对ROR而言,这很自然,也很省事.

语法

  • 大小写敏感
  • 使用缩进表示层级关系
  • 禁止使用tab缩进,只能使用空格键 , 建议使用两个空格
  • 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
  • # 表示注释,从这个字符一直到行尾,都会被解析器忽略。
  • 字符串可以不用引号,也可以使用单引号或者双引号

数据结构

  • 简单属性:字面量: 普遍的值(字符串,数字,布尔,字符等)

                        k: v:字面直接来写

                        字符串默认不需要加单引号或者双引号,如果加双引号,它不会转义字符串里面的特殊字符,而加单引号,则会转义字符串里面的特殊字符,意思就是将特殊字符直接变为字符串输出。

  • 复杂属性:

          1、对象、map集合(键值对):冒号分隔键值对(Key: Value), Key需要顶格写,前面不能有空格,冒号后面需要有一个空格然后再跟值, 相同的缩进属于同一个map ,比如:

# 对象:缩进方式
obj:
 field1: x
 field2: S

# 对象:行内方式
obj: {field1: x,field2: s}

           2、数组(List、set):一组按次序排列的值,又称为序列(sequence) / 列表(list)。比如:

# 数组:连字符方式,如果元素也是数组就再使用一层缩进
array:
 - ele1
 - ele2

# 数组:行内方式
array: [elel,ele2]

      复杂属性之间可以嵌套

  相关实例

---

# 使用冒号:表示键值对, 冒号后面需要有一个空格, key需要顶格写,前面不能有空格 同一缩进的所有键值对属于一个map

str: 这是一行字符串   # 字符串默认不使用引号表示
str2: '内容: 字符串' # 如果字符串之中包含空格或特殊字符,需要放在引号之中
str3: '内容\n字符串'  # 单引号和双引号都可以使用,双引号不会对特殊字符转义
str4: "内容\n字符串"  # 双引号对特殊字符不转义
str5: 'labor''s day' # 单引号之中如果还有单引号,需要使用单引号转义
# 字符串可以写成多行,从第二行开始,必须有一个单空格缩进。换行符会被转为空格
str6: 这是一段
  多行
  字符串
str7: | # "|"表示每行末尾都跟一个换行符
  Foo
  Bar
str8: > # “>” 最后一行跟一个换行符
  Foo
  Bar
str9: |
  Foo
str10: |+ # +表示保留文字块末尾的换行
  Foo

str11: |- # -表示删除字符串末尾的换行
  Foo

str12: | # 字符串之中可以插入 HTML 标记
 <p style="color: red">
    段落
 </p>


int: 10
float: 9.99
bool: true  # true、false
# 时间采用 ISO8601 格式 1点被转成9点
date: 2015-08-23   # 日期
datetime: 2015-08-23T02:02:00.1z  # 日期时间
iso8601: 2015-08-23t21:59:43.10-05:00  # iso8601 日期格式
spaced: 2015-08-23 21:59:43.10 -5      #


# 对象:缩进方式
obj:
 field1: x
 field2:
   field21: xx
   field22: xxx

# 对象:行内方式(和json格式差不多)
obj2: { field1: 'x', field2: { field21: 'xx', field22: 'xxx' } }


# 数组:连字符方式,如果元素也是数组就再使用一层缩进
array:
 - ele1
 - ele2
 -
   - ele31
   - ele32

# 行内方式
array2: [ 'ele1', 'ele2', [ 'ele31', 'ele32' ] ]

# 数组中的原始是对象
array3:
  - field1: x
    field2: xx
    field3: xxx
  - field1: x
    field2: xx
    field3: xxx

set:
  ? ele
  ? ele2

# 嵌套方式
nested:
  field1: x
  arr:
   - {field1: x, field2: x, field3: [1, 2, 3]}
   - {field1: x, field2: x, field3: [2, 3, 4]}
  arr2:
   -
    - a
    - b
   -
    - c
    - c

# 类型转换: 使用两个感叹号跟要转换的基本数据类型,单引号:用于转换自定义对象
#下面是内置类型
#!!int               # 整数类型
#!!float             # 浮点类型
#!!bool              # 布尔类型
#!!str               # 字符串类型
#!!binary            # 也是字符串类型
#!!timestamp         # 日期时间类型
#!!null              # 空值
#!!set               # 集合
#!!omap, !!pairs     # 键值列表或对象列表
#!!seq               # 序列,也是列表
#!!map               # 键值表
test: !!str 123

# 当键是数组或者对象时需要使用问号来标记
?[blue, reg, green]: xxx
?{a:xx, b:xx}: xx

# 锚点和引用
ref:
 - &index1 a
 - b
 - *index1
...

       如果使用yml文件格式作为配置文件的话,那么还有一个好处,yml文件支持多文档块的方式,使用“---”即可,可将编辑的内容分为多个文档,“...”可作为文件的结尾。

06-12 02:01