1、什么是 YAML
YAML 是 ”YAML Ain’t a Markup Language”(YAML 不是一种标记语言)的递归缩写。YAML 的意思其实是:“Yet Another Markup Language”(仍是一种标记语言)。次要强度这种语音是以数据为核心,而不是以标记语言为重心,例如像 xml 语言就会应用大量的标记。
YAML 是一个可读性高,易于了解,用来表白数据序列化的格局。它的语法和其余高级语言相似,并且能够简略表白清单(数组)、散列表,标量等数据状态。它应用空白符号缩进和大量依赖外观的特色,特地适宜用来表白或编辑数据结构、各种配置文件等。
YAML 的配置文件后缀为 .yml,例如 Springboot 我的项目中应用到的配置文件 application.yml。
Spring Boot 根底就不介绍了,举荐下这个实战教程:
https://github.com/javastacks…
2、根本语法
- YAML 应用可打印的 Unicode 字符,可应用 UTF- 8 或 UTF-16。
- 数据结构采纳键值对的模式,即 键名称: 值,留神冒号前面要有空格。
- 每个清单(数组)成员以单行示意,并用短杠 + 空白(-)起始。或应用方括号([]),并用逗号 + 空白(,)离开成员。
- 每个散列表的成员用冒号 + 空白(:)离开键值和内容。或应用大括号({}),并用逗号 + 空白(,)离开。
- 字符串值个别不应用引号,必要时可应用,应用双引号示意字符串时,会本义字符串中的特殊字符(例如 \n)。应用单引号时不会本义字符串中的特殊字符。
- 大小写敏感
- 应用缩进示意层级关系,缩进不容许应用 tab,只容许空格,因为有可能在不同零碎下 tab 长度不一样
- 缩进的空格数能够任意,只有雷同层级的元素左对齐即可
- 在繁多文件中,可用间断三个连字号(—)辨别多个文件。还有选择性的间断三个点号(…)用来示意文件结尾。
- ‘#’ 示意正文,能够呈现在一行中的任何地位,单行正文
- 在应用逗号及冒号时,前面都必须接一个空白字符,所以能够在字符串或数值中自在退出分隔符号(例如:5,280 或 http://www.wikipedia.org)而不须要应用引号。
3、数据类型
- 纯量(scalars):单个的、不可再分的值
- 对象:键值对的汇合,又称为映射(mapping)/ 哈希(hashes)/ 字典(dictionary)
- 数组:一组按秩序排列的值,又称为序列(sequence)/ 列表(list)
标量
标量是最根底的数据类型,不可再分的值,他们个别用于示意单个的变量,有以下七种:
- 字符串
- 布尔值
- 整数
- 浮点数
- Null
- 工夫
- 日期
# 字符串
string.value: Hello! 我是陈皮!
# 布尔值,true 或 false
boolean.value: true
boolean.value1: false
# 整数
int.value: 10
int.value1: 0b1010_0111_0100_1010_1110 # 二进制
# 浮点数
float.value: 3.14159
float.value1: 314159e-5 # 迷信计数法
# Null,~ 代表 null
null.value: ~
# 工夫,工夫应用 ISO 8601 格局,工夫和日期之间应用 T 连贯,最初应用 + 代表时区
datetime.value: !!timestamp 2021-04-13T10:31:00+08:00
# 日期, 日期必须应用 ISO 8601 格局,即 yyyy-MM-dd
date.value: !!timestamp 2021-04-13
这样,咱们就能够在程序中引入了,如下:
@RestController
@RequestMapping("demo")
public class PropConfig {@Value("${string.value}")
private String stringValue;
@Value("${boolean.value}")
private boolean booleanValue;
@Value("${boolean.value1}")
private boolean booleanValue1;
@Value("${int.value}")
private int intValue;
@Value("${int.value1}")
private int intValue1;
@Value("${float.value}")
private float floatValue;
@Value("${float.value1}")
private float floatValue1;
@Value("${null.value}")
private String nullValue;
@Value("${datetime.value}")
private Date datetimeValue;
@Value("${date.value}")
private Date datevalue;
}
Spring Boot 根底就不介绍了,举荐下这个实战教程:
https://github.com/javastacks…
对象
咱们晓得单个变量能够用键值对,应用冒号构造示意 key: value,留神冒号前面要加一个空格。能够应用缩进层级的键值对示意一个对象,如下所示:
person:
name: 陈皮
age: 18
man: true
而后在程序对这几个属性进行赋值到 Person 对象中,留神 Person 类要加 get/set 办法,不然属性会无奈正确取到配置文件的值。应用 @ConfigurationProperties 注入对象,@value 不能很好的解析简单对象。
@Configuration
@ConfigurationProperties(prefix = "my.person")
@Getter
@Setter
public class Person {
private String name;
private int age;
private boolean man;
}
当然也能够应用 key:{key1: value1, key2: value2, …} 的模式,如下:
person: {name: 陈皮, age: 18, man: true}
数组
能够用短横杆加空格 - 结尾的行组成数组的每一个元素,如下的 address 字段:
person:
name: 陈皮
age: 18
man: true
address:
- 深圳
- 北京
- 广州
也能够应用中括号进行行内显示模式,如下:
person:
name: 陈皮
age: 18
man: true
address: [深圳, 北京, 广州]
在代码中引入形式如下:
@Configuration
@ConfigurationProperties(prefix = "person")
@Getter
@Setter
@ToString
public class Person {
private String name;
private int age;
private boolean man;
private List<String> address;
}
如果数组字段的成员也是一个数组,能够应用嵌套的模式,如下:
person:
name: 陈皮
age: 18
man: true
address: [深圳, 北京, 广州]
twoArr:
-
- 2
- 3
- 1
-
- 10
- 12
- 30
@Configuration
@ConfigurationProperties(prefix = "person")
@Getter
@Setter
@ToString
public class Person {
private String name;
private int age;
private boolean man;java
private List<String> address;
private List<List<Integer>> twoArr;
}
如果数组成员是一个对象,则用如下两种模式模式:
childs:
-
name: 小红
age: 10
-
name: 小王
age: 15
childs: [{name: 小红, age: 10}, {name: 小王, age: 15}]
4、文本块
如果你想引入多行的文本块,能够应用 | 符号,留神在冒号: 和 | 符号之间要有空格。
person:
name: |
Hello Java!!
I am fine!
Thanks! GoodBye!
它和加双引号的成果一样,双引号能本义特殊字符:
person:
name: "Hello Java!!\nI am fine!\nThanks! GoodBye!"
5、显示指定类型
有时咱们须要显示指定某些值的类型,能够应用 !(感叹号)显式指定类型。! 单叹号通常是自定义类型,!! 双叹号是内置类型,例如:
# 指定为字符串
string.value: !!str HelloWorld!
# !!timestamp 指定为日期工夫类型
datetime.value: !!timestamp 2021-04-13T02:31:00+08:00
内置的类型如下:
- !!int:整数类型
- !!float:浮点类型
- !!bool:布尔类型
- !!str:字符串类型
- !!binary:二进制类型
- !!timestamp:日期工夫类型
- !!null:空值
- !!set:汇合类型
- !!omap,!!pairs:键值列表或对象列表
- !!seq:序列
- !!map:散列表类型
6、援用
援用会用到 & 锚点合乎和 星号符号,& 用来建设锚点,<< 示意合并到以后数据,用来援用锚点。
xiaohong: &xiaohong
name: 小红
age: 20
dept:
id: D15D8E4F6D68A4E88E
<<: *xiaohong
下面最终相当于如下:
xiaohong:
name: 小红
age: 20
dept:
id: D15D8E4F6D68A4E88E
name: 小红
age: 20
还有一种文件内援用,援用曾经定义好的变量,如下:
base.host: https://chenpi.com
add.person.url: ${base.host}/person/add
7、单文件多配置
能够在同一个文件中,实现多文档分区,即多配置。在一个 yml 文件中,通过 — 分隔多个不同配置,依据 spring.profiles.active 的值来决定启用哪个配置
# 公共配置
spring:
profiles:
active: pro # 指定应用哪个文档块
#开发环境配置
spring:
profiles: dev # profiles 属性代表配置的名称
server:
port: 8080
#生产环境配置
spring:
profiles: pro
server:
port: 8081
起源:blog.csdn.net/chenlixiao007
近期热文举荐:
1.1,000+ 道 Java 面试题及答案整顿 (2021 最新版)
2. 别在再满屏的 if/ else 了,试试策略模式,真香!!
3. 卧槽!Java 中的 xx ≠ null 是什么新语法?
4.Spring Boot 2.6 正式公布,一大波新个性。。
5.《Java 开发手册(嵩山版)》最新公布,速速下载!
感觉不错,别忘了顺手点赞 + 转发哦!