SpringBoot yml文件语法

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

SpringBoot提供了大量的默认配置，如果要修改默认配置，需要在配置文件中修改。

SpringBoot默认会加载resource下的配置文件：

application*.yml
application*.yaml
application*.properties

这也是配置文件的加载顺序，如果某个key有多个配置，则后加载的会覆盖之前加载的配置。

yml、yaml是同一种文件，后缀写成yml、yaml都可以。

一般使用application.yml。

springboot在不同的环境下有默认的加载文件：

application 开发、测试、生产都会加载，公共的
application-dev 只在开发环境加载（调试src/main）
application-test 只在测试环境加载（调试src/test）
application-prod 只在生产环境加载（正式打包部署）

yml文件语法

（1）普通字段：

name: zhangsan

值不加引号

（2）对象、Map

对象、Map的配置方式是一样的。

student: #对象名、Map名
id: 1 #配置一个属性、一个键值对
name: chy
age: 20
score: 100

值可以是对象：

server:
port: 8080
servlet:
context-path: /springboot

servlet的值就是一个对象。不配置端口，默认为8080；不配置context-path，默认为/

（3）数组、List

city: [beijing,shanghai,guangzhou,shenzhen]
student: [{name: zhangsan,age: 20},{name: lisi,age: 20}] #元素可以是对象

值，不管是key的值，还是数组元素，都不加引号。

key、value冒号分隔，冒号后面都要加一个空格，加了空格后key会变成橙色，才有效。

使用yml中的值

如果是springboot预定义的key，springboot会自动使用它。如果是自定义的key，就需要我们自己来引用。有2种引用方式。

（1）使用@Value

name: chy

@RestController
public class UserController {
@Value("${name}") //使用@Value注入配置文件中的值。${}要加引号
private String name; @RequestMapping("/user")
public String handler(){
return name; //使用
}}

不能直接${ }、"${ }"来使用配置文件中的值。

需要借助成员变量，使用@Value注入配置文件中的值，通过成员变量来引用。

不管成员变量是什么数据类型，${ }都需要加引号，会自动转换为需要的类型，注入。

对象、Map，通过.来注入单个字段， @Value("${student.name}")

数组、List，通过下标来注入单个元素，@Value("${city[0]}")

只能注入基本类型，不能直接直接注入整个对象、Map、数组、List。

（2）使用@ConfigurationProperties注入对象、Map

使用@Value依次注入对象、Map的字段时，student.id，student.name，student.age，都有相同的前缀student，也可以这样来注入：

@RestController
@ConfigurationProperties(prefix = "student") //设置前缀
public class UserController {
private int id;
private String name;
private int age;
private int score; public void setId(int id) {
this.id = id;
} public void setName(String name) {
this.name = name;
} public void setAge(int age) {
this.age = age;
} public void setScore(int score) {
this.score = score;
} @RequestMapping("/user")
public String handler(){
return name; //使用
}}

设置前缀、设置对应的成员变量、并提供对应的setter方法，会自动注入该字段的值。

运行，效果正常，但IDEA提示：

其实没啥影响，当然也可以在pom.xml中添加：

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

这样写完@ConfigurationProperties后，在yml中配置该前缀（对象）时，会有字段提示，比如打一个student.，会有预选项id、name、age、score。