YAML 格式学习

目录

• 什么是YAML
• 一、注释和多文件
• 二、格式要求
• 三、数据结构
  • 1.对象
  • 2. 数组
  • 3.常量
• 四、字符串
• YAML的特殊字符

什么是YAML

YAML是“YAML不是一种标记语言”但为了强调这种语言以数据做为中心，而不是以置标语言为重点，而用返璞词重新命名。它是一种直观的能够被电脑识别的数据序列化格式，是一个可读性高并且容易被人类阅读，容易和脚本语言交互，用来表达资料序列的编程语言。
它是类似于标准通用标记语言的子集XML的数据描述语言，语法比XML简单很多。

一、注释和多文件

使用#作为注释，YAML中只有行注释。
多个文件可以用---表示

---

apiVersion: v1 #这是一个注释

二、格式要求

1. 大小写敏感
2. 使用缩进表示层级关系
3. 缩进时不允许使用Tab键，只允许使用空格。
4. 缩进的空格数目不重要，只要相同层级的元素左侧对齐即可一般是2个或者4个空格

三、数据结构

1. 对象：键值对的集合
2. 数组：一组按次序排列的值
3. 常量：单个的、不可再分的值

1.对象

对象的一组键值对，使用冒号:结构表示
使用冒号代表，格式为key: value。冒号后面要加一个空格

args: 
  apiVersion: v1
  kind: Pod

也可以把多个键值对写到一行

args: {apiVersion: v1,kind: Pod}

JSON格式就是

{args:{apiVersion:'v1',kind:'Pod'}}

2. 数组

使用一个短横线加一个空格代表一个数组项

language: 
  - C#
  - JAVA

也可以写到单行里

languge: [C#, JAVA]

JSON格式就是：

{languge:['C#, 'JAVA']}

3.常量

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

• 布尔值
• 整数
• 浮点数
• 字符串
• Null
• 日期
• 时间

boolean: 
    - TRUE  #true,True都可以
    - FALSE  #false，False都可以
int:
    - 123
    - 0b1010_0111_0100_1010_1110    #二进制表示
float:
    - 3.14
    - 6.8523015e+5  #可以使用科学计数法
string:
    - 哈哈
    - 'Hello world'  #可以使用双引号或者单引号包裹特殊字符
    - newline
      newline2    #字符串可以拆成多行，每一行会被转化成一个空格
null:
    nodeName: 'node'
    parent: ~  #使用~表示null
date:
    - 2018-02-17    #日期必须使用ISO 8601格式，即yyyy-MM-dd
datetime: 
    -  2018-02-17T15:02:31+08:00    #时间使用ISO 8601格式，时间和日期之间使用T连接，最后使用+代表时区

四、字符串

字符串默认不使用引号表示
单引号和双引号都可以使用
双引号不会对特殊字符转义
字符串中需要单引号，需要两个单引号表示

str: 这是一行字符串
s1: '内容\n字符串'
s2: "内容\n字符串"
s3: 'this ''s my life'

JSON格式为：

{
    str:'这是一行字符串'
    , s1: '内容\\n字符串'
    , s2: '内容\n字符串' 
    , s3: 'this \'s my life'
}

字符串可以写成多行，从第二行开始，必须有一个单空格缩进。换行符会被转为空格。

str: 这是一段
  多行
  字符串

JSON

{ str: '这是一段 多行 字符串' }

多行字符串可以使用|保留换行符，也可以使用>折叠换行。

this: |
  Foo
  Bar
that: >
  Foo
  Bar

JSON

{ this: 'Foo\nBar\n', that: 'Foo Bar\n' }

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

s1: |
  Foo
 
s2: |+
  Foo
 
 
s3: |-
  Foo

JSON

{ s1: 'Foo\n', s2: 'Foo\n\n\n', s3: 'Foo' }

YAML的特殊字符

--- YAML可以在同一个文件中，使用---表示一个文档的开始, ... 表示文件的结束

---
time: 20:03:20
player: Sammy Sosa
action: strike (miss)
...
---
time: 20:03:47
player: Sammy Sosa
action: grand slam
...

!! YAML中使用!!做类型强行转换

string:
    - !!str 54321
    - !!str true

JSON:

{string: ['54321', 'true']}

--- !!set
  - Mark McGwire: 65
  - Sammy Sosa: 63
  - Sammy Sosa: 63
  - Ken Griffy: 58

JSON:

[{Ken Griffy=58}, {Mark McGwire=65}, {Sammy Sosa=63}]，重复的Sammy Sosa去掉

引用。重复的内容在YAML中可以使用&来完成锚点定义，使用*来完成锚点引用

hr:
  - Mark McGwire
  - &SS Sammy Sosa
rbi:
  - *SS 
  - Ken Griffey

JSON:
{rbi=[Sammy Sosa, Ken Griffey], hr=[Mark McGwire, Sammy Sosa]}

也可以这样定义：

SS: &SS Sammy Sosa
hr:
 - Mark McGwire
 - *SS
rbi:
 - *SS 
 - Ken Griffey

合并内容：用<<表示，主要和锚点配合使用，可以将一个锚点内容直接合并到一个对象中

merge:
  - &CENTER { x: 1, y: 2 }
  - &LEFT { x: 0, y: 2 }
  - &BIG { r: 10 }
  - &SMALL { r: 1 }
  
sample1: 
    <<: *CENTER
    r: 10
    
sample2:
    << : [ *CENTER, *BIG ]
    other: haha
    
sample3:
    << : [ *CENTER, *BIG ]
    r: 100

在merge中，定义了四个锚点，分别在sample中使用。
sample1中，<<: *CENTER意思是引用{x: 1,y: 2}，并且合并到sample1中，那么合并的结果为：sample1={r=10, y=2, x=1}

sample2中，<<: [*CENTER, *BIG] 意思是联合引用{x: 1,y: 2}和{r: 10}，并且合并到sample2中，那么合并的结果为：sample2={other=haha, x=1, y=2, r=10}

sample3中，引入了*CENTER, *BIG，还使用了r: 100覆盖了引入的r: 10，所以sample3值为：sample3={r=100, y=2, x=1}

有了合并，我们就可以在配置中，把相同的基础配置抽取出来，在不同的子配置中合并引用即可。