首页>>后端>>SpringBoot->什么是 YAML?和 Spring Boot 有什么关系?

什么是 YAML?和 Spring Boot 有什么关系?

时间:2023-11-30 本站 点击:0

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/spring-boot-best-practice

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或falseboolean.value:trueboolean.value1:false#整数int.value:10int.value1:0b1010_0111_0100_1010_1110#二进制#浮点数float.value:3.14159float.value1:314159e-5#科学计数法#Null,~代表nullnull.value:~#时间,时间使用ISO8601格式,时间和日期之间使用T连接,最后使用+代表时区datetime.value:!!timestamp2021-04-13T10:31:00+08:00#日期,日期必须使用ISO8601格式,即yyyy-MM-dddate.value:!!timestamp2021-04-13

这样,我们就可以在程序中引入了,如下:

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}

Spring Boot 基础就不介绍了,推荐下这个实战教程: https://github.com/javastacks/spring-boot-best-practice

对象

我们知道单个变量可以用键值对,使用冒号结构表示 key: value,注意冒号后面要加一个空格。可以使用缩进层级的键值对表示一个对象,如下所示:

person:name:陈皮age:18man:true

然后在程序对这几个属性进行赋值到Person对象中,注意Person类要加get/set方法,不然属性会无法正确取到配置文件的值。使用@ConfigurationProperties注入对象,@value不能很好的解析复杂对象。

@Configuration@ConfigurationProperties(prefix="my.person")@Getter@SetterpublicclassPerson{privateStringname;privateintage;privatebooleanman;}

当然也可以使用 key:{key1: value1, key2: value2, ...}的形式,如下:

person:{name:陈皮,age:18,man:true}

数组

可以用短横杆加空格 -开头的行组成数组的每一个元素,如下的address字段:

person:name:陈皮age:18man:trueaddress:-深圳-北京-广州

也可以使用中括号进行行内显示形式,如下:

person:name:陈皮age:18man:trueaddress:[深圳,北京,广州]

在代码中引入方式如下:

@Configuration@ConfigurationProperties(prefix="person")@Getter@Setter@ToStringpublicclassPerson{privateStringname;privateintage;privatebooleanman;privateList<String>address;}

如果数组字段的成员也是一个数组,可以使用嵌套的形式,如下:

person:name:陈皮age:18man:trueaddress:[深圳,北京,广州]twoArr:--2-3-1--10-12-30

@Configuration@ConfigurationProperties(prefix="person")@Getter@Setter@ToStringpublicclassPerson{privateStringname;privateintage;privatebooleanman;javaprivateList<String>address;privateList<List<Integer>>twoArr;}

如果数组成员是一个对象,则用如下两种形式形式:

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}0

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}1

4、文本块

如果你想引入多行的文本块,可以使用|符号,注意在冒号:和 |符号之间要有空格。

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}2

它和加双引号的效果一样,双引号能转义特殊字符:

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}3

5、显示指定类型

有时我们需要显示指定某些值的类型,可以使用 !(感叹号)显式指定类型。!单叹号通常是自定义类型,!!双叹号是内置类型,例如:

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}4

内置的类型如下:

!!int:整数类型

!!float:浮点类型

!!bool:布尔类型

!!str:字符串类型

!!binary:二进制类型

!!timestamp:日期时间类型

!!null:空值

!!set:集合类型

!!omap,!!pairs:键值列表或对象列表

!!seq:序列

!!map:散列表类型

6、引用

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

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}5

上面最终相当于如下:

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}6

还有一种文件内引用,引用已经定义好的变量,如下:

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}7

7、单文件多配置

可以在同一个文件中,实现多文档分区,即多配置。在一个yml文件中,通过 — 分隔多个不同配置,根据spring.profiles.active 的值来决定启用哪个配置

@RestController@RequestMapping("demo")publicclassPropConfig{@Value("${string.value}")privateStringstringValue;@Value("${boolean.value}")privatebooleanbooleanValue;@Value("${boolean.value1}")privatebooleanbooleanValue1;@Value("${int.value}")privateintintValue;@Value("${int.value1}")privateintintValue1;@Value("${float.value}")privatefloatfloatValue;@Value("${float.value1}")privatefloatfloatValue1;@Value("${null.value}")privateStringnullValue;@Value("${datetime.value}")privateDatedatetimeValue;@Value("${date.value}")privateDatedatevalue;}8

来源:blog.csdn.net/chenlixiao007


本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:/SpringBoot/4378.html