1. 认识 YAML

  YAML(发音 /ˈjæməl/)是一个类似 XML、JSON 的数据序列化语言。其强调以数据为中心,旨在方便人类使用;并且适用于日常常见任务的现代编程语言。因而 YAML 本身的定义比较简单,号称“一种人性化的数据格式语言”。

1.1 YAML 的设计目标:
  • 人类容易阅读

  • 可用于不同程序间的数据交换

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

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

  • 易于使用

1.2 YAML 与 XML、JSON
  • YAML 与 XML

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

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

    • 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

SpringCloud入门之YAML格式文件规范学习的更多相关文章

  1. SpringCloud入门之常用的配置文件 application.yml和 bootstrap.yml区别

    作者其他技术文章 1) Spring Boot 简介 2)SpringCloud入门之YAML格式文件规范学习 3)SpringCloud入门之Spring Boot多环境配置切换指南 4) Elas ...

  2. SpringCloud入门之Spring Boot多环境配置切换指南

    在 spring boot 中,有两种配置文件,一种是application.properties,另一种是application.yml,两种都可以配置spring boot 项目中的一些变量的定义 ...

  3. 入门Kubernetes - YAML文件

    前言 前篇文章中简单了解到如何把.Net Core 程序部署到k8s中,过程中使用了多个*.yaml文件,那么这些文件的格式及含义.语法是如何的呢? 接下来,进一步了解学习 一.YAML介绍: 1.简 ...

  4. Opencv YAML和XML格式文件操作详解

    本系列文章由 @YhL_Leo 出品,转载请注明出处. 文章链接: http://blog.csdn.net/yhl_leo/article/details/47660943 本文参考Opencv 2 ...

  5. 导出文本、表格、图像到PDF格式文件中(学习整理)

    1.测试例子: 需要导入的外部jar包: 相关API http://www.coderanch.com/how-to/javadoc/itext-2.1.7/com/lowagie/text/pack ...

  6. Unity3D可以查看YAML格式的场景文件,采用Notepad++

    在Editor Settings 将Asset Serialization 的 mode设置成Force Text,否则不能查看YAML格式! Unity圣典描述:Textual Scene File ...

  7. RTF格式文件浅析

    ps:这两天在分析从微软的word复制一个绕排环绕的表格到openoffice的writer中去的bug,需要了解RTF... RTF是Rich TextFormat的缩写,意即多文本格式.这是一种类 ...

  8. 【网络爬虫入门05】分布式文件存储数据库MongoDB的基本操作与爬虫应用

    [网络爬虫入门05]分布式文件存储数据库MongoDB的基本操作与爬虫应用 广东职业技术学院  欧浩源 1.引言 网络爬虫往往需要将大量的数据存储到数据库中,常用的有MySQL.MongoDB和Red ...

  9. SpringCloud入门之应用程序上下文服务(Spring Cloud Context)详解

    构建分布式系统非常复杂且容易出错.Spring Cloud为最常见的分布式系统模式提供了简单易用的编程模型,帮助开发人员构建弹性,可靠和协调的应用程序.Spring Cloud构建于Spring Bo ...

随机推荐

  1. Libgdx slg游戏进程记录

    2月16日缩放居中,stage确定点击坐标,背景处理为actor 2月17日地图多次点击 2月19日stage确定点击位置(贝塞尔曲线六边形) 2月24日格式长度,读取xml属性解析btl保存 3月1 ...

  2. MFC改变坐标系

    1.在MainFrm中的PreCreateWindow中设置默认窗口大小 BOOL CMainFrame::PreCreateWindow(CREATESTRUCT& cs) { if( !C ...

  3. python线程——创建和启动

    可以通过实例化一个threading.Thread()对象来创建子线程. import threading import time def listen_music(num): print(" ...

  4. Jquery动态添加/删除表格行和列

    <!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title> ...

  5. poj 3687 Labeling Balls(拓补排序)

    Description Windy has N balls of distinct weights from 1 unit to N units. Now he tries to label them ...

  6. h5的改进:

    新元素画布canvas: HTML5 <canvas> 元素用于图形的绘制,通过脚本 (通常是JavaScript)来完成音频audio视频video语义性: article,  nav ...

  7. php中ob_get_contents、curl_multi_init、curl_init多线程下载远程图片并保存记录

    php中三种方式测试图片下载效率 原文共24张不同图,每张大小在500K以上 使用时注意调整传入数组格式以及需要下载时保存地址的路径格式等 这三种方式无需额外安装扩展,方便快捷易操作[虽然效率看结果没 ...

  8. JS canvas标签动态绘制图型

    使用canvas标签动态绘制图型,当点击鼠标时,以鼠标点击的坐标作为图形中心点.当点击数为偶数时画三角形,当点击数为奇数时画五角星 <!DOCTYPE HTML> <html> ...

  9. Nuget4.0 bug一粒

    这个锅到底是nuget的还是msbuild的我也不是很确定 在使用Nuget4.0打包编译项目时 当执行到nuget pack %%~dpna.csproj -build -Prop Configur ...

  10. spark-submit(spark版本2.4.2)

    spark-submit官方文档 :http://spark.apache.org/docs/latest/submitting-applications.html Launching Applica ...