天下事有难易乎?为之,则难者亦易矣;不为,则易者亦难矣。

YAML 文件的这些骚操作,你都会了吗?

itzoo 448次浏览 0个评论

点击“终码一生”,关注,置顶公众号

每日技术干货,第一时间送达!



1

什么是YAML


YAML是”YAML Ain’t a Markup Language”(YAML不是一种标记语言)的递归缩写。YAML的意思其实是:“Yet Another Markup Language”(仍是一种标记语言)。主要强度这种语音是以数据为中心,而不是以标记语言为重心,例如像xml语言就会使用大量的标记。


YAML是一个可读性高,易于理解,用来表达数据序列化的格式。它的语法和其他高级语言类似,并且可以简单表达清单(数组)、散列表,标量等数据形态。它使用空白符号缩进和大量依赖外观的特色,特别适合用来表达或编辑数据结构、各种配置文件等。


YAML的配置文件后缀为 .yml,例如Springboot项目中使用到的配置文件 application.yml 。



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;
}


对象


我们知道单个变量可以用键值对,使用冒号结构表示 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

PS:防止找不到本篇文章,可以收藏点赞,方便翻阅查找哦。


往期推荐



扔掉 Postman,一个工具全部搞定,真香!

Java 程序员利器:lombok神工具

不得不说,DataGrip 太吊了!!

开源项目 | SpringBoot+redis+Vue 的商城系统,接私活必备!

流弊!亿级流量电商系统 JVM 模型参数预估方案

面试官:Redis为什么默认16个数据库?



ITZOO版权所有丨如未注明 , 均为原创丨转载请注明来自IT乐园 ->YAML 文件的这些骚操作,你都会了吗?
发表我的评论
取消评论
表情 贴图 加粗 删除线 居中 斜体 签到

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址