1.0yaml语法

yaml语法

1.yaml介绍

  • YAML:“Yet Another Markup Language”(仍是一种标记语言),不是以标记语法为重心,是以数据为中心。
  • YAML是一个可读性高,易于理解,用来表达数据序列化的格式。
  • 语法和其他高级语言类似,并且可以简单表达清单(数组)、散列表,标量等数据形态。
  • 使用空白符号缩进和大量依赖外观的特色,特别适合用来表达或编辑数据结构、各种配置文件等。
  • YAML的配置文件后缀为 .yml

2.基本语法

YAML使用可打印的Unicode字符,可使用UTF-8或UTF-16。

  • 数据结构采用键值对的形式,即 键名称: 值,注意冒号后面要有空格。

  • 每个清单(数组)成员以单行表示,并用短杠+空白(- )起始。或使用方括号([]),并用逗号+空白(, )分开成员。

  • 每个散列表的成员用冒号+空白(: )分开键值和内容。或使用大括号({ }),并用逗号+空白(, )分开。

  • 字符串值一般不使用引号,必要时可使用,使用双引号表示字符串时,会转义字符串中的特殊字符(例如\n)。使用单引号时不会转义字符串中的特殊字符。

  • 大小写敏感

  • 使用缩进表示层级关系,缩进不允许使用tab,只允许空格,因为有可能在不同系统下tab长度不一样

  • 缩进的空格数可以任意,只要相同层级的元素左对齐即可

  • 在单一文件中,可用连续三个连字号(—)区分多个文件。还有选择性的连续三个点号(…)用来表示文件结尾。

  • ‘#’表示注释,可以出现在一行中的任何位置,单行注释

  • 在使用逗号及冒号时,后面都必须接一个空白字符,所以可以在字符串或数值中自由加入分隔符号(例如:5,280或http://www.wikipedia.org)而不需要使用引号。

3.数据类型

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

3.1.标量

标量是最基础的数据类型,不可再分的值,他们一般用于表示单个的变量,有以下七种:

  1. 字符串

  2. 布尔值:true,false

  3. 整数

  4. 浮点数

  5. Null

  6. 时间,时间使用ISO 8601格式,时间和日期之间使用T连接,最后使用+代表时区

  7. 日期,日期必须使用ISO 8601格式,即yyyy-MM-dd

    使用@value解析

3.2 对象

key: value

注意冒号后面要加一个空格

使用@ConfigurationProperties注入对象

3.3数组

用短横杆加空格 -开头的行组成数组的每一个元素

也可以使用中括号进行行内显示形式

3.4文本块

多行的文本块,可以使用|符号,在冒号:|符号之间要有空格

4.显示指定类型

使用 !(感叹号)显式指定类型。!单叹号通常是自定义类型,!!双叹号是内置类型

英文的感叹号

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

5.引用

引用会用到 &锚点符合和 *星号符号,&用来建立锚点,<< 表示合并到当前数据,* 用来引用锚点。

6.单文件多配置

可以在同一个文件中,实现多文档分区,即多配置。在一个yml文件中,通过 — 分隔多个不同配置,使用—进行分割

参考:阿里P8大神教我yaml语法,我终于不再只是使用字符串类型了_陈皮的JavaLib-CSDN博客