一。变量
YAML使用冒号加缩进的方式代表层级(属性)关系,使用短横杠(-)代表数组元素。
YAML中允许表示三种格式,分别是常量值,对象和数组
#即表示url属性值; url: http://www.wolfcode.cn #即表示server.host属性的值; server: host: http://www.wolfcode.cn #数组,即表示server为[a,b,c] server: - 120.168.117.21 - 120.168.117.22 - 120.168.117.23 #常量 pi: 3.14 #定义一个数值3.14 hasChild: true #定义一个boolean值 name: '你好YAML' #定义一个字符串
基本格式要求
1,YAML大小写敏感;
2,使用缩进代表层级关系;
3,缩进只能使用空格,不能使用TAB,不要求空格个数,只需要相同层级左对齐(一般2个或4个空格)
对象
使用冒号代表,格式为key: value。冒号后面要加一个空格:
key: value
可以使用缩进表示层级关系
key: child-key1: value1 child-key2: value2
YAML中还支持流式(flow)语法表示对象,比如上面例子可以写为:
key: {child-key1: value1, child-key2: value2}
较为复杂的对象格式,可以使用问号加一个空格代表一个复杂的key,配合一个冒号加一个空格代表一个value:
? - complexkey1 - complexkey2 : - complexvalue1 - complexvalue2
意思即对象的属性是一个数组[complexkey1,complexkey2],对应的值也是一个数组[complexvalue1,complexvalue2]
数组
使用一个短横线加一个空格代表一个数组项:
一个相对复杂的例子:
hobby: - Java - LOL
也可以写:
-
- Java
- LOL
等价于:[[Java, Lol]]
一个复杂的例子:
companies: - id: 1 name: company1 price: 200W - id: 2 name: company2 price: 500W
即:companies属性是一个数组,每一个数组元素又是由id,name,price三个属性构成;
使用流式(flow)的方式表示:
companies: [{id: 1,name: company1,price: 200W},{id: 2,name: company2,price: 500W}]
二。注释
使用#作为注释,YAML中只有行注释
三。常量
boolean: - TRUE #true,True都可以 - FALSE #false,False都可以 float: - 3.14 - 6.8523015e+5 #可以使用科学计数法 int: - 123 - 0b1010_0111_0100_1010_1110 #二进制表示 null: nodeName: 'node' parent: ~ #使用~表示null string: - 哈哈 - 'Hello world' #可以使用双引号或者单引号包裹特殊字符 - newline newline2 #字符串可以拆成多行,每一行会被转化成一个空格 date: - 2018-02-17 #日期必须使用ISO 8601格式,即yyyy-MM-dd datetime: - 2018-02-17T15:02:31+08:00 #时间使用ISO 8601格式,时间和日期之间使用T连接,最后使用+代表时区
四。特殊符号
1,--- YAML可以在同一个文件中,使用---表示一个文档的开始;比如Springboot中profile的定义
server: address: 192.168.1.100 --- spring: profiles: development server: address: 127.0.0.1 --- spring: profiles: production server: address: 192.168.1.120
代表定义了两个profile,一个是development,一个production;常常使用---来分割不同的内容,比如记录日志:
--- Time: 2018-02-17T15:02:31+08:00 User: ed Warning: This is an error message for the log file --- Time: 2018-02-17T15:05:21+08:00 User: ed Warning: A slightly different error message.
2,... 和---配合使用,在一个配置文件中代表一个文件的结束:
--- time: 20:03:20 player: Sammy Sosa action: strike (miss) ... --- time: 20:03:47 player: Sammy Sosa action: grand slam ...
相当于在一个yaml文件中连续写了两个yaml配置项
3,!! YAML中使用!!做类型强行转换:
string:
- !!str 54321
- !!str true
强转为字符串。
强转为其它类型(如set.)
--- !!set
- Mark McGwire: 65
- Sammy Sosa: 63
- Sammy Sosa: 63
- Ken Griffy: 58
将数组解析为set,简单理解,转化的内容就是:[{Ken Griffy=58}, {Mark McGwire=65}, {Sammy Sosa=63}],重复的Sammy Sosa去掉;
4,>在字符串中折叠换行,| 保留换行符,这两个符号是YAML中字符串经常使用的符号【要注意一点的是,每行的文本前一定要有一个空格。】,比如:
accomplishment: > Mark set a major league home run record in 1998. stats: | 65 Home Runs 0.278 Batting Average
结果是:
accomplishment=Mark set a major league home run record in 1998.
stats=65 Home Runs
0.278 Batting Average,
|符号常见用于在YAML中配置HTML片段:
phraseTemplate: | <p style="color: red"> some template ${msg} </p>