YAML语法简易入门

YAML 语法

个人感觉这篇文档属于"搬运工"性质

可以查看官方或者其他的博客资料,会有一大堆的内容

YAML语言的设计参考了JSON,XML和SDL等语言。YAML 强调以数据为中心,简洁易读,编写简单。

有意思的命名:

AML全称是”YAML Ain’t a Markup Language”(YAML不是一种置标语言)的递归缩写。 在开发的这种语言时,YAML 的意思其实是:”Yet Another Markup Language”(仍是一种置标语言)。

语法特点

  • 大小写敏感
  • 通过缩进表示层级关系
  • 禁止使用tab缩进,只能使用空格键 (个人感觉这条最重要)
  • 缩进的空格数目不重要,只要相同层级左对齐即可
  • 使用#表示注释

支持的数据结构

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

双引号和单引号的区分

双引号"":不会转义字符串里面的特殊字符,特殊字符作为本身想表示的意思。

name: "123\n123" --------------------------- 输出: 123 换行 123

如果不加引号将会转义特殊字符,当成字符串处理

值的写法

1.字符串

使用”或”“或不使用引号

value0: 'hello World!' value1: "hello World!" value2: hello World! 复制代码

2.布尔值

true或false表示。

3.数字

12 #整数  014 # 八进制整数  0xC #十六进制整数 13.4 #浮点数 1.2e+34 #指数 .inf空值 #无穷大 复制代码

4.空值

null或~表示

5.日期

使用 iso-8601 标准表示日期

date: 2018-01-01t16:59:43.10-05:00 复制代码

在springboot中yaml文件的时间格式 date: yyyy/MM/dd HH:mm:ss

6.强制类型转换(了解)

YAML 允许使用个感叹号!,强制转换数据类型,单叹号通常是自定义类型,双叹号是内置类型。

money: !!str 123 date: !Boolean true 复制代码

内置类型列表

!!int # 整数类型  !!float # 浮点类型  !!bool # 布尔类型  !!str # 字符串类型  !!binary # 也是字符串类型  !!timestamp # 日期时间类型  !!null # 空值  !!set # 集合  !!omap,!!pairs # 键值列表或对象列表 !!seq # 序列,也是列表 !!map # 键值表 复制代码

7.对象(重点)

Map(属性和值)(键值对)的形式: key:(空格)v :表示一堆键值对,空格不可省略。

car:  color: red  brand: BMW 复制代码

一行写法

car:{color: red,brand: BMW} 复制代码

相当于JSON格式:

{"color":"red","brand":"BMW"} 复制代码

8.数组

一组连词线开头的行,构成一个数组。

brand:  - audi  - bmw  - ferrari 复制代码

一行写法

brand: [audi,bmw,ferrari] 复制代码

相当于JSON

["auri","bmw","ferrari"] 复制代码

9.文本块

|:使用|标注的文本内容缩进表示的块,可以保留块中已有的回车换行

value: |
   hello
   world!
输出结果:hello 换行 world! 复制代码

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

value: |
hello value: |- hello value: |+ hello 输出:hello\n hello hello\n\n(有多少个回车就有多少个\n) 复制代码

注意 “|” 与 文本之间须另起一行

>:使用>标注的文本内容缩进表示的块,将块中回车替换为空格,最终连接成一行

value: > hello
world!
输出:hello 空格 world! 复制代码

注意 “>” 与 文本之间的空格

10.锚点与引用

使用&定义数据锚点(即要复制的数据),使用*引用锚点数据(即数据的复制目的地)

name: &a yaml book: *a books:  - java  - *a  - python 输出book: yaml 输出books:[java,yaml,python] 复制代码

注意*引用部分不能追加内容


配置文件注入数据

/**
 * 将配置文件中配置的每一个属性的值,映射到这个组件中
 * @ConfigurationProperties:告诉SpringBoot将本类中的所有属性和配置文件中相关的配置进行绑定;
 *      prefix = "person":配置文件中哪个下面的所有属性进行一一映射
 *
 * 只有这个组件是容器中的组件,才能容器提供的@ConfigurationProperties功能;
 *
 */ @Component //实例化 @ConfigurationProperties(prefix = "person")//yaml或者properties的前缀 public class Person { private String name; private Integer age; private Boolean flag; private Date birthday; private Map<String,Object> maps; private List<Object> tempList; private Dog dog; //省略getter和setter以及toString方法 复制代码

我们可以导入配置文件处理器,以后编写配置就有提示了,@ConfigurationPropertiesIDE会提示打开在线的帮助文档,配置依赖如下:

<!--导入配置文件处理器,配置文件进行绑定就会有提示--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-configuration-processor</artifactId> <optional>true</optional> </dependency> 复制代码

application.yaml文件

person:  name: 胖先森  age: 18  flag: false  birthday: 2018/12/19 20:21:22 #Spring Boot中时间格式  maps: {bookName: "西游记",author: '吴承恩'}  tempList:  - 红楼梦  - 三国演义  - 水浒传  dog:  dogName: 大黄  dogAge: 4 复制代码

在test中进行测试如下

@RunWith(SpringRunner.class) @SpringBootTest public class Demo03BootApplicationTests { @Autowired private Person p1; @Test public void contextLoads() {
        System.out.println(p1);
    }

} 复制代码

输出结果为:Person{name='胖先森', age=18, flag=false, birthday=Wed Dec 19 20:21:22 CST 2018, maps={bookName=西游记, author=吴承恩}, tempList=[红楼梦, 三国演义, 水浒传], dog=Dog{dogName='大黄', dogAge=4}}

application.properties文件

person123.name=刘备
person123.age=20
person123.birthday=2018/12/19 20:21:22
person123.maps.bookName=水浒传
person123.maps.author=罗贯中
person123.temp-list=一步教育,步步为赢
person123.dog.dogName=小白
person123.dog.dogAge=5 复制代码

java代码修改前缀

@Component //实例化 @ConfigurationProperties(prefix = "person123")//yaml或者properties的前缀 public class Person { private String name; private Integer age; private Boolean flag; private Date birthday; private Map<String,Object> maps; private List<Object> tempList; private Dog dog; //省略getter和setter以及toString方法 复制代码

在test中进行测试如下

@RunWith(SpringRunner.class) @SpringBootTest public class Demo03BootApplicationTests { @Autowired private Person p1; @Test public void contextLoads() {
        System.out.println(p1);
    }

} 复制代码

输出结果为:Person{name='����', age=20, flag=null, birthday=Wed Dec 19 20:21:22 CST 2018, maps={bookName=ˮ䰴�, author=�޹���}, tempList=[һ������, ����ΪӮ], dog=Dog{dogName='��', dogAge=5}}