一、YAML 简介

1、什么是 YAML ？

• YAML（YAML Ain't Markup Language），一种数据序列化格式。
• 这种格式的配置文件近些年逐渐进入市场，并开始占据主导地位。

2、优点

• 较 xml 类型和 properties 类型相比，更容易阅读，结构也更加的清晰。
• 容易与脚本语言交互。
• 以数据为核心，重数据轻格式，轻格式并不是说可以不遵守格式，只是格式更加随性一些。

3、扩展名

• 扩展名有两种，无论是哪个扩展名，都是 YAML 格式的配置文件，拥有 YAML 的属性。.yml ，这种扩展名更加主流一些.yaml

4、语法规则

• 对大小写非常敏感，如：定义 age 和 AGE 都会认为是两个属性。
• 属性层级关系使用多行描述，每行结尾使用冒号结束。
• 使用缩进表示层级关系，同层级左侧对齐，只允许使用空格。
• 空格个数并不重要，只要保证同层级的左侧对齐即可。
• 属性值前面添加空格。
• 号表示注释。

5、格式

server:  port: 80

• 切记：属性值前面必须有一个空格。
• port 是 server 下的一个属性，根据属性层级之间使用多行描述，以及使用缩进表示的规则，port 的书写位置如上所示，但一般情况下，这种格式我们无需过多纠结，我们回车换行后自动提供的格式一般都是正确的。

6、数组数据

name: 准全栈开发工程师server:  port: 80# 数组格式likes:  - game  - movie  - music

• 数组数据的属性值换行书写，以 “-” 减号开头，注意属性值前空格，如上述 likes 所示。

二、三种配置文件

以配置端口号为例，介绍三种配置文件及其格式。

1、properties 类型

• 在未接触到 yaml 之前，我们的配置文件大多数都是以 properties 结尾的文件。

server.port=80

• 格式为：属性名=属性值 。
• 这种方式还是非常常见的，我们之前在配置连接数据库相关信息的 jdbc.properties 文件也是使用的改变方式。

2、yml 类型

server:  port: 81

• 将端口号设置为 81 。

3、yaml 类型

• yml 和 yaml 只是扩展名不同而已，其实是一种类型的配置文件。

server:  port: 82

4、优先级

• 当项目中同时存在上述三个配置文件时，用采用那个配置文件呢？我们可以通过观察端口号来获得优先级顺序。
• 端口号为 80 ，说明有人优先采用了 properties 类型的配置文件，它的优先级最高。
• 将 properties 配置文件中的配置内容删除，观察 .yaml 和 .yml 那种文件优先级更高。
• 端口号又变为了 81 ，说明 .yml 文件优先级更高一些，虽然 .yaml 只是不同的扩展名罢了。
• 总结：优先级由高到低 properties > yml > yaml

三、YAML 代码提示功能

• 有很多小伙伴反应，说在写什么 YAML 文件时，代码不提示。
• 没有代码提示功能，对我们的开发还是造成了一定的影响的，下面就带着大家来解决这个问题。
• 首先进入到模块管理。
• 将 YAML 类型的两个配置文件添加。

 

• 选中创建的两个配置文件，完成后点击 “OK” 即可。

 

• 此时的配置文件已经变成了三个。

 

• 重新回到配置文件看是否实现了代码提示的功能。

 

• 已经实现了代码提示功能，虽然是 YAML 文件，但是代码提示的还是按照 properties 类型进行的，并不影响，找到需要的属性直接回车后还是会呈现出 YAML 格式。

四、读取 YAML 配置文件中的数据

1、数据准备

sourceName: SpringBoot server:  port: 80 user:  name: 准Java全栈开发工程师  age: 22  likes:    - music    - game    - movie

2、方式一：@Value

@SpringBootTestclass DemolicationTests {     @Value("${sourceName}")    private String sourceName;    @Value("${server.port}")    private Integer port;    @Value("${user.likes[0]}")    private String likes;     @Test    void contextLoads() {        System.out.println(sourceName);        System.out.println(port);        System.out.println(likes);    }}

• 将要读取的数据定义为属性，使用 @Value 注解读取配置文件中的数据并注入给属性，之后在方法体中可以直接使用。

3、方式二：Environment

@SpringBootTestclass DemoApplicationTests {    @Autowired    private Environment environment;     @Test    void contextLoads() {        System.out.println(environment.getProperty("sourceName"));        System.out.println(environment.getProperty("server.port"));        System.out.println(environment.getProperty("user.likes[0]"));    }}

• SpringBoot 提供有 Environment 对象，可以将配置文件中的所有数据都封装到该对象中，使用 getProperty 方法，将想要读取的数据名作为参数传入即可。

4、方式三：自定义对象

user:  name: 准Java全栈开发工程师  age: 22  likes:    - music    - game    - movie

• 对于配置类中的 user 数据，其下还有很多子层，如果我们想一下子将 user 的所有数据都取出，应该怎么做呢？将其封装为一个对象。

@Component  // 将bean的创建工作交由Spring管理// @ConfigurationProperties 注解表示加载配置文件// 使用prefix前缀表示只加载指定前缀的数据@ConfigurationProperties(prefix = "user")public class User {    private String name;    private Integer age;    private Object[] likes;	// get、set、toString和构造器方法省略}

• 和我们定义实体类没有太大的区别，只是这次不再是和数据库表中的字段对应，而是和配置文件中定义的数据对应。
• 除此之外，还需要使用 ConfigurationProperties 注解加载配置文件，使用 prefix 指定加载数据的前缀。

@SpringBootTestclass DemoApplicationTests {    @Autowired    private User user;     @Test    void contextLoads() {        System.out.println(user);    }}

• 使用该方式在定义实体类时，会报红提示

 

• 我们只需要在 pom.xml 文件中导入相应的依赖即可。

<dependency>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-configuration-processor</artifactId>    <optional>true</optional></dependency>

原文链接：
https://www.cnblogs.com/qdxorigin/p/16396478.

胜象大百科