SpringCloud入门之YAML格式文件规范学习

时间  2019-11-07 标签 springcloud 入门 yaml 格式 文件 规范 学习

1. 认识 YAML

　　YAML（发音 /ˈjæməl/）是一个相似 XML、JSON 的数据序列化语言。其强调以数据为中心，旨在方便人类使用；而且适用于平常常见任务的现代编程语言。于是 YAML 自己的定义比较简单，号称“一种人性化的数据格式语言”。css

1.1 YAML 的设计目标：

  • 人类容易阅读html

  • 可用于不一样程序间的数据交换node

  • 适合描述程序所使用的数据结构，特别是脚本语言编程

  • 丰富的表达能力与可扩展性数组

  • 易于使用ruby

1.2 YAML 与 XML、JSON

  • YAML 与 XML网络

    • 具备 XML 一样的优势，但比 XML 更加简单、敏捷等

  • YAML 与 JSON数据结构

    • JSON 能够看做是 YAML 的子集，也就是说 JSON 可以作的事情，YAML 也可以作less

    • YAML 能表示得比 JSON 更加简单和阅读，例如“字符串不须要引号”。因此 YAML 容易能够写成 JSON 的格式，但并不建议这种作编程语言

    • YAML 可以描述比 JSON 更加复杂的结构，例如“关系锚点”能够表示数据引用（如重复数据的引用）。

1.3 YAML 组织结构

　　YAML 文件能够由一或多个文档组成（也即相对独立的组织结构组成），文档间使用“---”（三个横线）在每文档开始做为分隔符。同时，文档也可使用“...”（三个点号）做为结束符（可选）。以下图所示：

文档示图

 

  • 若是只是单个文档，分隔符“---”可省略。

  • 每一个文档并不须要使用结束符“...”来表示结束，可是对于网络传输或者流来讲，做为明确结束的符号，有利于软件处理。（例如不须要知道流关闭就能知道文档结束） <br/>

　　YAML 认为数据由如下三种结构组成：（每一个文档由三种结构混合组成）

  • 标量 （至关于数据类型）

  • 序列 （至关于数组和列表）

  • 键值表（至关于 Map 表）

2. YAML 编写规范

    它的基本语法规则以下：

          1）大小写敏感

          2）使用缩进表示层级关系

          3）缩进时不容许使用Tab键，只容许使用空格。

          4）缩进的空格数目不重要，只要相同层级的元素左侧对齐便可

 

  • 规范一：文档使用 Unicode 编码做为字符标准编码，例如 UTF-8

  • 规范二：使用“#”来表示注释内容

    # 客户订单 date: 2015-02-01 customer:  - name: Jai items:  - no: 1234 # 订单号  - descript: cpu

  • 规范三：使用空格做为嵌套缩进工具。一般建议使用两个空格缩进，不建议使用 tab （甚至不支持）

  • 规范四：序列表示

    • 使用“-”（横线） + 单个空格表示单个列表项 
      --- # 文档开始 - 第一章 简介 - 第二章 设计目录
    • 使用"[]"表示一组数据 
      --- # 文档开始 [blue, red, green]
    • 组合表示。每一个结构均可以嵌套组成复杂的表示结构。 
      --- # 文档开始 - [blue, red, green] # 列表项自己也是一个列表 - [Age, Bag] - site: {osc:www.oschina.net, baidu: www.baidu.com} # 这里是同 键值表 组合表示

  • 规范五：键值表

    • 使用 “:”（冒号） + 空格表示单个键值对 
      # 客户订单 date: 2015-02-01 customer:  - name: Jai items:  - no: 1234 # 订单号  - descript: cpu  - price: ￥800.00
    • 使用"{}"表示一个键值表 
      # 客户订单 date: 2015-02-01 customer:  - name: Jai items: {no: 1234, descript: cpu, price: ￥800.00}
    • "? " 问号+空格表示复杂的键。当键是一个列表或键值表时，就须要使用本符号来标记。 
      # 使用一个列表做为键
 ? [blue, reg, green]: Color
 # 等价于
 ? - blue
   - reg - gree : Color

    • 组合表示。每一个结构均可以嵌套组成复杂的表示结构。 

      Color: - blue - red - green # 至关于 (也是 JSON 的表示) {Color: [blue, red, green]} div: - border: {color: red, width: 2px} - background: {color: green} - padding: [0, 10px, 0, 10px] # 使用缩进表示的键值表与列表项 items: - item: cpu model: i3 price: ￥800.00 - item: HD model: WD price: ￥450.00 # 上面使用 “-” 前导与缩进来表示多个列表项，至关于下面的JSON表示 items: [{item:cpu, model:i3, price:￥800.00}, {item:HD, model:WD, price: ￥450.00}]

  • 规范六：文本块

    • 使用 “|” 和文本内容缩进表示的块：保留块中已有的回车换行。至关于段落块

      yaml: | # 注意 ":" 与 "|" 之间的空格 JSON的语法实际上是YAML的子集，大部分的JSON文件均可以被YAML的解释器解释。

    • 使用 “>” 和文本内容缩进表示的块：将块中回车替换为空格，最终链接成一行。

      yaml: > # 注意 ":" 与 ">" 之间的空格，另外可使用空行来分段落 JSON的语法实际上是YAML的子集， 大部分的JSON文件均可以被YAML的解释器解释。

    • 使用定界符“”（双引号）、‘’（单引号）或回车表示的块：最终表示成一行。

      yaml: # 使用回车的多行，最终链接成一行。 JSON的语法实际上是YAML的子集， 大部分的JSON文件均可以被YAML的解释器解释。 yaml: # 使用了双引号，双引号的好处是能够转义，即在里面可使用特殊符号 "JSON的语法实际上是YAML的子集， 大部分的JSON文件均可以被YAML的解释器解释。"

  • 规范七：数据类型的约定

    • 对一些经常使用数据类型的表示格式进行了约定，包括:

       integer: 12345 # 整数标准形式  octal: 0o34 # 八进制表示，第二个是字母 o  hex: 0xFF # 十六进制表示  float: 1.23e+3 # 浮点数  fixed: 13.67 # 固定小数  minmin: -.inf # 表示负无穷  notNumber: .NaN # 无效数字  null: # 空值  boolean: [true, false] # 布尔值  string: '12345' # 字符串  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 # ?

    • “!”（叹号）显式指示类型，或自定义类型标识。单叹号一般是自定义类型，双叹号是内置类型

       isString: !!str 2015-08-23 # 强调是字符串不是日期数据  picture: !!binary | # Base64 图片 R0lGODlhDAAMAIQAAP//9/X 17unp5WZmZgAAAOfn515eXv Pz7Y6OjuDg4J+fn5OTk6enp 56enmleECcgggoBADs= #下面是内置类型 !!int # 整数类型 !!float # 浮点类型 !!bool # 布尔类型 !!str # 字符串类型 !!binary # 也是字符串类型 !!timestamp # 日期时间类型 !!null # 空值 !!set # 集合 !!omap, !!pairs # 键值列表或对象列表 !!seq # 序列，也是列表 !!map # 键值表 #下面是一些例子：  --- !!omap  - Mark: 65  - Sammy: 63  - Key: 58  --- !!set # 注意，“?”表示键为列表，在这里列表为 null ? Mark ? Sammy ? Key # 下面是自定义的类型或标识 %TAG ! tag:clarkevans.com,2002: # % 是指令符号  --- !shape # Use the ! handle for presenting # tag:clarkevans.com,2002:circle  - !circle  center: &ORIGIN {x: 73, y: 129}  radius: 7  - !line  start: *ORIGIN  finish: { x: 89, y: 102 }  - !label  start: *ORIGIN  color: 0xFFEEBB  text: Pretty vector drawing.

  • 规范八：锚点与引用，定义数据的复用。

    • 第一步：使用 “&” 定义数据锚点（即要复制的数据）
    • 第二步：使用 “*” 引用上述锚点数据（即数据的复制目的地） 
      --- hr: - Mark McGwire # Following node labeled SS - &SS Sammy Sosa # 定义要复制的数据 rbi: - *SS # Subsequent occurrence 这里是数据复制目标 - Ken Griffey
      详尽语法见官网：http://www.yaml.org/spec/1.2/spec.html
联系我们 沪ICP备13005482号-10