SpringBoot YAML语法基础详细整理
沫洺 人气:0YAML
Spring Boot 提供了大量的自动配置,极大地简化了spring 应用的开发过程,当用户创建了一个 Spring Boot 项目后,即使不进行任何配置,该项目也能顺利的运行起来。当然,用户也可以根据自身的需要使用配置文件修改 Spring Boot 的默认设置。
SpringBoot 默认使用以下 2 种全局的配置文件,其文件名是固定的。
- application.properties
- application.yml/yaml
其中,application.yml 是一种使用 YAML 语言编写的文件,它与 application.properties一样,可以在 Spring Boot 启动时被自动读取,修改 Spring Boot 自动配置的默认值。
YAML 简介
YAML 全称 YAML Ain't Markup Language,它是一种以数据为中心的标记语言,比 XML 和 JSON 更适合作为配置文件。
想要使用 YAML 作为属性配置文件(以 .yml 或 .yaml 结尾),需要将 SnakeYAML 库添加到 classpath 下,Spring Boot 中的 spring-boot-starter-web 或 spring-boot-starter 都对 SnakeYAML 库做了集成, 只要项目中引用了这两个 Starter 中的任何一个,Spring Boot 会自动添加 SnakeYAML 库到 classpath 下。
YAML 语法
YAML 的语法如下:
- 使用缩进表示层级关系。
- 缩进时不允许使用 Tab 键,只允许使用空格。(可设置Tab替换四个空格)
- 缩进的空格数不重要,但同级元素必须左侧对齐。
- 大小写敏感。
- #表示注释。
YAML 常用写法
YAML 支持以下几种数据结构:
- 普通的值(数字、字符串、布尔、日期)
- 对象 属性值的集合
- 数组 一组按次序排列的值
- 集合 List、Set 与数组一样,Map与对象一样键值对的集合
普通值(字面量)
- 字面量是指单个的,不可拆分的值,例如:数字、字符串、布尔值、以及日期等。
- 在 YAML 中,使用“key:[空格]value”的形式表示一对键值对(空格不能省略)
- 字面量直接写在键值对的“value”中即可,且默认情况下字符串是不需要使用单引号或双引号的
username: root
password: 123456
若字符串使用单引号,则不会转义特殊字符,特殊字符会输出为其本身想表达的含义
username1: 'zhangsan \n lisi'
输出:zhangsan \n lisi
若字符串使用双引号,则会转义特殊字符,\n代表换行
username2: "zhangsan \n lisi"
输出:'zhangsan lisi'
对象(属性和值)、Map(键值对)
它们都是一对键值对,YAML 为对象提供了 2 种写法
普通写法 ,使用缩进表示对象与属性的层级关系。
map1:
name: 张三
age: 23
行内写法
map2: {name: 李四,age: 24}
@ConfigurationProperties获取键值对数据
@Value获取键值对数据
@Value获取map数据
map解析中,字符串一定要用"“把map所对应的value包起来,要不然解析会失败,导致不能转成 Map<StrObject>
test:
map: "{name: '李四',age: 24}"
@Component @Data public class Test { @Value("#{${test.map}}") private Map<String,Object> map; }
这里说明一下,获取的map值是Test(map={name=李四, age=24})这样的,数据是在{}里的
YAML语法中如果一个值以 “{” 开头, YAML 将认为它是一个字典, 所以我们必须如下方式引用它
map: "{name: '李四',age: 24}"
数组、list、set
YAML 使用“-”表示数组、list、set 中的元素
普通写法
array1:
- 张三
- 李四
list1:
- 23
- 24
行内写法
array2: [王五,毛六]
list2: [25,26]
@ConfigurationProperties获取数组与集合数据
@Value根据索引获取数组与集合单个元素数据
想从yml配置文件中读取数组,但是按照yml配置数组的形式有点麻烦,可以使用字符串去模拟数组
test:
list: 张三,李四,王五
spring默认时按照逗号进行分割的,所以代码中可以写成
@Component @Data public class Test { @Value("${test.list}") private List<String> list; }
另外,@Value注解是支持SpEL表达式的,所以还可以写成
@Component @Data public class Test { @Value("#{'${test.list}'.split(',')}") private List<String> list; }
复合结构
以上几种数据结构可以任意组合使用,以实现不同的用户需求
比如List中放Map
test:
listInMap:
- name: 张三
age: 23
- name: 李四
age: 24
- {name: 王五,age: 25}
YAML 组织结构
一个 YAML 文件可以由一个或多个文档组成,文档之间使用“---”作为分隔符,且个文档相互独立,互不干扰。如果 YAML 文件只包含一个文档,则“---”分隔符可以省略。
#默认配置
server:
port: 8080
#切换配置
spring:
profiles:
active: test
---
#开发环境
server:
port: 8081
spring:
config:
activate:
on-profile: dev
---
#测试环境
server:
port: 8082
spring:
config:
activate:
on-profile: test
---
#生产环境
server:
port: 8083
spring:
config:
activate:
on-profile: prod
加载全部内容