写yml,写的腿疼

开发 前端
我非常羞耻的发现,配置文件界,已经被下面三种所统治:yaml,toml和json,这让一直使用properties文件的javaer深深的埋下了头。

本文转载自小姐姐味道(微信公众号ID:xjjdog)。

我非常羞耻的发现,配置文件界,已经被下面三种所统治:yaml,toml和json,这让一直使用properties文件的javaer深深的埋下了头。

不要担心,当你读到文章最后,你也会羞愧的埋下头。也可能会有一丝愤怒。

[[404113]]

像各种人工智能调参数,k8s调参师,都已经成功升级为yml配置大师。作为一个常年使用yml文件的SpringBoot框架使用者,有时候对yml的表现形式竟然显露出了困惑,这不由得让人羞愧又加了一层。

YAML,竟然是XML的一个子集,所以它的复杂是有源头的,最早诞生于2009年。

使用yml文件,首先遇到的问题,就是它的缩进问题。就如同python语言一样,yml文件的表现层次,是靠嵌套的缩进来完成的。它并不使用TAB,而是使用空格表示缩进。

要命的是,空格的多少,并不重要,只要相同级别元素左侧能够对齐就行。这对于CV党来说,不得不说是一个噩梦哈哈。

那一个配置文件,要解决哪些问题呢?Redis已经做出了回答。就像你学习一门新的语言一样,解决了它的字符串和集合的表示方法,基本上写代码就没问题了。那我们就挨个来看一下。

以下方法以SpringBoot的yml文件格式为准,其他场景的解析器会有些许差异。为了能够debug这些值,我们简单的写了一个测试类,然后再设值完成之后打印以下就可以了。

  1. @EnableAutoConfiguration 
  2. @Configuration 
  3. public class TestConfig implements InitializingBean { 
  4.     @Value("${str1}") 
  5.     String str1; 
  6.     @Override 
  7.     public void afterPropertiesSet() throws Exception { 
  8.         System.out.println(this); 
  9.     } 

1. 字符串

字符串是最简单的配置,也是最常见的配置。再spring中,字符串可以代引号,也可以不带引号。所以下面三行的配置效果,是一样的。

  1. str1: ksdfjsdlkfjdsf skdfljs 
  2. str1: 'ksdfjsdlkfjdsf skdfljs' 
  3. str1: "ksdfjsdlkfjdsf skdfljs" 

那么,如何支持多行文本呢?毕竟有些需求,就是这么作死。写法如下:

  1. str1: | 
  2.   ksdfjsdlkfjdsf skdfljs 
  3.   ksdfjsdlkfjdsf skdfljs 
  4.   ksdfjsdlkfjdsf skdfljs 

注意,后面不需要有其他的画蛇添足的结束表示,一切都是靠缩进来证明的。当然,你也可以把 |换成>,效果是一样的。

  1. str1: > 
  2.   ksdfjsdlkfjdsf skdfljs 
  3.   ksdfjsdlkfjdsf skdfljs 
  4.   ksdfjsdlkfjdsf skdfljs 

要命的是,它还有第三种写法。

  1. str1: "ksdfjsdlkfjdsf skdfljs 
  2.   ksdfjsdlkfjdsf skdfljs 
  3.   ksdfjsdlkfjdsf skdfljs" 

2. 数字

当我们的接收者,是一个数字的时候,比如下面这个。

  1. @Value("${a}") 
  2. int a ; 

那么,你即使把配置文件写成了字符串,它也会强制转成数字。

  1. a: "014" 

此时,a的数值,就会被设置成整数14。

神奇的是,如果你把引号去掉,也就是下面这样。

  1. a: 014 

此时,a的数值,竟然变成了12!

我就曾碰到过这样的极品bug,浪费了不少脑细胞,wtf。因为以0开头,代表的是八进制,解析器中间做了一层转换。所以,按照这个逻辑,0x14就是20,使用时一定要注意这一点。机灵的同学可以拿来埋坑哦。

这里也有一些特殊的写法。

  1. float: 1.23e+3     # 浮点数 
  2. fixed: 13.67       # 固定小数 
  3. minmin: -.inf      # 表示负无穷 
  4. notNumber: .NaN    # 无效数字 
  5.  
  6. boolean: [true, false] # 布尔值 
  7. string: '12345'    # 字符串 
  8.  
  9. date: 2021-06-03   # 日期 

3. 字典

再来看一下常见的字典。其实,把所有的配置罗列开来,本身就是一个字典,也就是kv配置。

它是以:进行分割的,所以左半部分要求不能有特殊字符,否则就晕菜了。不不不,它没有晕菜,因为它把乱七八糟的字符,正确的识别了出来。比如下面的yml配置。

  1. a&& xk@71: 0x14 

这样的代码接收。

  1. @Value("${a&& xk@71}") 
  2. int a ; 

嗯,容易被打死的写法。所以,你懂的。

还是我太幼稚了,yml文件根本就没规定key不允许有特殊字符,它允许你这么做。

4. 对象

由字典,很容易可以扩展到对象。因为对象,也是一堆属性的集合。json已经证明,这些属性,就是一堆KV,我们的yaml也是如此。

假设有如下的代码,我们需要构造dog中的数据。

  1. @Data 
  2. public static class Dog{ 
  3.     private String xjjdog1; 
  4.     private String xjjdog2; 
  5.  
  6. @Bean 
  7. @ConfigurationProperties(prefix = "dog"
  8. public Dog getDog(){ 
  9.     return new Dog(); 

第一种yml的写法,是这样。

  1. dog: 
  2.   xjjdog1: i am xjjdog1 
  3.   xjjdog2: i am xjjdog1++ 

而另一种方式,是把json数据直接给写到文件里。

  1. dog: {xjjdog1: 'i am xjjdog1',xjjdog2: 'i am xjjdog++'} 

当然,多个层次,可以在一行之中平铺开。比如prefix是super.dog,那么yml文件就可以这么写。

  1. super.dog: {xjjdog1: 'i am xjjdog1',xjjdog2: 'i am xjjdog++'} 

5. 列表支持

列表,就是list,我们可以使用数组接收,也可以使用List等。

它也有两种写法。这是最常见的一种。

  1. animal: 
  2.   - dog 
  3.   - cat 
  4.   - monkey 

当然,也可以放在一行。

  1. animal: [dog,cat,monkey] 

这没什么问题,关键是yml文件支持嵌套。比如List里嵌套Map,或者Map里嵌套List。当嵌套层次比较深的时候,或者缩进没什么规律的时候,就显得非常的乱。

比如下面这个k8s的pod配置。

  1. apiVersion: v1 
  2. kind: Pod 
  3. metadata: 
  4.   name: xjjdog-Pod 
  5.   labels: 
  6.     app: front-web 
  7. spec: 
  8.   containers: 
  9.     - name: front-web 
  10.       image: nginx 
  11.       ports: 
  12.         - containerPort: 80 
  13.     - name: front-app 
  14.       image: xjjdog/frontapp 
  15.       ports: 
  16.         - containerPort: 14000 
  17.   storages: 
  18.   ... 

比较复杂的是spec,里面有containers、storages等配置。其中containers是一个列表,列表之间是一个map,map中其中的ports属性,又是一个列表...如此嵌套,如果配置文件比较长的化,不熟悉业务属性的同学就会容易晕菜。

6. 特殊数据

即使是这样,yaml也比xml简单的多。它也有很多特殊的写法。

比如这个。

  1. str1: !!str 2021-06-03 

它的意思是,把2021-06-04,强制转化成字符串。这样的强制转化有很多,但大多数时候你不会用。但如果你想要把你的yaml文件变得复杂,让别人不敢动,那就可以这么做。

  1. !!int               # 整数类型 
  2. !!float             # 浮点类型 
  3. !!bool              # 布尔类型 
  4. !!str               # 字符串类型 
  5. !!binary            # 也是字符串类型 
  6. !!timestamp         # 日期时间类型 
  7. !!null              # 空值 
  8. !!set               # 集合 
  9. !!omap, !!pairs     # 键值列表或对象列表 
  10. !!seq               # 序列,也是列表 
  11. !!map               # 键值表 

既然yml文件有这么多复杂的写法,那么我们就可以去玩一把。比如下面的写法。

  1. from: &d !!str 2021-06-04 
  2. str1: *d 

这个配置,和上面的配置,效果是一样的,&的意思是标记,我们给它起了个名字,叫做d;*的意思是引用,我们在需要它的地方引用一把就可以了。

yml中的key,竟然也可以用对象或者复杂的结构作为key。为了标识是一个特殊的key,我们还要做一点处理。

  1. ?[blue, reg, green]: Color 

上面这个配置的?,就是说,我下面要进行一个比较复杂的配置了,你准备好了么?

7. End

学会了这些招数的你,是不是跃跃欲试了?想要在你的SpringBoot项目里搞一点有意思的东西?为了让你的基础架构部门无法扫描出你的配置,为什么不呢?

这是我改造的一个普通datasource的配置文件。

  1. h2: &sa !!str sa 
  2. driver: &driver !!str org.h2.Driver 
  3. defaults: &defaults 
  4.   ?username: *sa 
  5.   ?password: 
  6.   ?driverClassName: *driver 
  7. spring: 
  8.   datasource: 
  9.     <<: *defaults 
  10.     ?url: !!str > 
  11.       jdbc:h2:mem:h2test; 
  12.       DB_CLOSE_DELAY=-1; 
  13.       DB_CLOSE_ON_EXIT=FALSE 

你觉得美么?我反正腿挺疼的。

 

责任编辑:赵宁宁 来源: 小姐姐味道
相关推荐

2021-06-04 20:13:06

Ymljavaerk8s

2014-12-22 09:54:52

代码

2012-07-03 09:59:03

程序员

2024-10-29 09:25:00

2023-05-23 13:59:41

RustPython程序

2015-07-21 11:52:34

Swift分享按钮源码

2011-05-25 17:17:54

前端开发

2020-08-20 08:39:54

CTO代码数据

2011-05-26 09:39:53

程序

2013-06-13 14:05:51

关机程序

2015-07-28 16:35:27

Swift猜拳

2014-11-11 14:52:28

程序员工程师

2014-02-28 13:46:35

Angular代码

2011-03-07 09:41:10

JavaScript

2011-05-12 11:01:26

HTML

2019-07-10 08:56:58

代码互联网网络

2020-03-12 07:42:49

代码程序员

2013-01-22 13:50:11

程序员前端Web

2023-02-15 08:17:20

VSCodeTypeScrip

2020-10-10 09:09:21

CTOCRUD设计
点赞
收藏

51CTO技术栈公众号