SSM - Springboot - MyBatis-Plus 全栈体系（二十七）

第六章 SpringBoot

二、SpringBoot3 配置文件

1. 统一配置管理概述

• SpringBoot 工程下，进行统一的配置管理，你想设置的任何参数（端口号、项目根路径、数据库连接信息等等)都集中到一个固定位置和命名的配置文件（application.properties或application.yml）中！

• 配置文件应该放置在 Spring Boot 工程的src/main/resources目录下。这是因为src/main/resources目录是 Spring Boot 默认的类路径（classpath），配置文件会被自动加载并可供应用程序访问。

• 功能配置参数说明：

  • https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html#appendix.application-properties

• 细节总结：

  • 集中式管理配置。统一在一个文件完成程序功能参数设置和自定义参数声明。
  • 位置：resources 文件夹下，必须命名 application 后缀 .properties / .yaml / .yml 。
  • 如果同时存在 application.properties | application.yml(.yaml) , properties 的优先级更高。
  • 配置基本都有默认值。
    

2. 属性配置文件使用

2.1 配置文件

• 在 resource 文件夹下面新建 application.properties 配置文件

# application.properties 为统一配置文件
# 内部包含: 固定功能的key,自定义的key
# 此处的配置信息,我们都可以在程序中@Value等注解读取

# 固定的key
# 启动端口号
server.port=80

# 自定义
spring.jdbc.datasource.driverClassName=com.mysql.cj.jdbc.driver
spring.jdbc.datasource.url=jdbc:mysql:///springboot_01
spring.jdbc.datasource.username=root
spring.jdbc.datasource.password=root
1
2
3
4
5
6
7
8
9
10
11
12
13

2.2 读取配置文件

package com.alex.properties;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class DataSourceProperties {

    @Value("${spring.jdbc.datasource.driverClassName}")
    private String driverClassName;

    @Value("${spring.jdbc.datasource.url}")
    private String url;

    @Value("${spring.jdbc.datasource.username}")
    private String username;

    @Value("${spring.jdbc.datasource.password}")
    private String password;

    // 生成get set 和 toString方法
    public String getDriverClassName() {
        return driverClassName;
    }

    public void setDriverClassName(String driverClassName) {
        this.driverClassName = driverClassName;
    }

    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    @Override
    public String toString() {
        return "DataSourceProperties{" +
                "driverClassName='" + driverClassName + '\'' +
                ", url='" + url + '\'' +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                '}';
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

2.3 测试效果

• 在 controller 注入，输出进行测试

@Autowired
private DataSourceProperties dataSourceProperties;

@RequestMapping(path = "/hello")
public String sayHello() {
  System.out.println(dataSourceProperties);
  return "Hello Spring Boot ! ";
}
1
2
3
4
5
6
7
8

• 浏览器访问路径，控制台查看效果
  

3. YAML 配置文件使用

3.1 yaml 格式介绍

• YAML（YAML Ain’t Markup Language）是一种基于层次结构的数据序列化格式，旨在提供一种易读、人类友好的数据表示方式。
• 与.properties文件相比，YAML 格式有以下优势：

1. 层次结构：YAML 文件使用缩进和冒号来表示层次结构，使得数据之间的关系更加清晰和直观。这样可以更容易理解和维护复杂的配置，特别适用于深层次嵌套的配置情况。
2. 自我描述性：YAML 文件具有自我描述性，字段和值之间使用冒号分隔，并使用缩进表示层级关系。这使得配置文件更易于阅读和理解，并且可以减少冗余的标点符号和引号。
3. 注释支持：YAML 格式支持注释，可以在配置文件中添加说明性的注释，使配置更具可读性和可维护性。相比之下，.properties文件不支持注释，无法提供类似的解释和说明。
4. 多行文本：YAML 格式支持多行文本的表示，可以更方便地表示长文本或数据块。相比之下，.properties文件需要使用转义符或将长文本拆分为多行。
5. 类型支持：YAML 格式天然支持复杂的数据类型，如列表、映射等。这使得在配置文件中表示嵌套结构或数据集合更加容易，而不需要进行额外的解析或转换。
6. 更好的可读性：由于 YAML 格式的特点，它更容易被人类读懂和解释。它减少了配置文件中需要的特殊字符和语法，让配置更加清晰明了，从而减少了错误和歧义。

• 综上所述，YAML 格式相对于.properties文件具有更好的层次结构表示、自我描述性、注释支持、多行文本表示、复杂数据类型支持和更好的可读性。这些特点使 YAML 成为一种有力的配置文件格式，尤其适用于复杂的配置需求和人类可读的场景。然而，选择使用 YAML 还是.properties取决于实际需求和团队的偏好，简单的配置可以使用.properties，而复杂的配置可以选择 YAML 以获得更多的灵活性和可读性。

3.2 yaml 语法说明

• 数据结构用树形结构呈现，通过缩进来表示层级
• 连续的项目（集合）通过减号 ” - ” 来表示
• 键值结构里面的 key/value 对用冒号 ” : ” 来分隔
• YAML 配置文件的扩展名是 yaml 或 yml
• 例如：

# YAML配置文件示例
app_name: 我的应用程序
version: 1.0.0
author: 张三

database:
  host: localhost
  port: 5432
  username: admin
  password: password123

features:
  - 登录
  - 注册
  - 仪表盘

settings:
  analytics: true
  theme: dark
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

3.3 配置文件

spring:
  jdbc:
    datasource:
      driverClassName: com.mysql.jdbc.Driver
      url: jdbc:mysql:///springboot_02
      username: root
      password: root

server:
  port: 80
1
2
3
4
5
6
7
8
9
10

3.4 读取配置文件

读取方式和 properties 一致

package com.alex.properties;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class DataSourceProperties {

    @Value("${spring.jdbc.datasource.driverClassName}")
    private String driverClassName;

    @Value("${spring.jdbc.datasource.url}")
    private String url;

    @Value("${spring.jdbc.datasource.username}")
    private String username;

    @Value("${spring.jdbc.datasource.password}")
    private String password;

    // 生成get set 和 toString方法
    public String getDriverClassName() {
        return driverClassName;
    }

    public void setDriverClassName(String driverClassName) {
        this.driverClassName = driverClassName;
    }

    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    @Override
    public String toString() {
        return "DataSourceProperties{" +
                "driverClassName='" + driverClassName + '\'' +
                ", url='" + url + '\'' +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                '}';
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

3.5 测试效果

• 在 controller 注入，输出进行测试

@Autowired
private DataSourceProperties dataSourceProperties ;

@RequestMapping(path = "/hello")
public String sayHello() {
  System.out.println(dataSourceProperties);
  return "Hello Spring Boot ! ";
}
1
2
3
4
5
6
7
8

• 浏览器访问路径，控制台查看效果
  

4. 批量配置文件注入

@ConfigurationProperties 是 SpringBoot 提供的重要注解, 他可以将一些配置属性批量注入到 bean 对象。

4.1 创建类，添加属性和注解

• 在类上通过@ConfigurationProperties 注解声明该类要读取属性配置
• prefix=“spring.jdbc.datasource” 读取属性文件中前缀为 spring.jdbc.datasource 的值。前缀和属性名称和配置文件中的 key 必须要保持一致才可以注入成功

package com.alex.properties;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "spring.jdbc.datasource")
public class DataSourceConfigurationProperties {

    private String driverClassName;
    private String url;
    private String username;
    private String password;

    public String getDriverClassName() {
        return driverClassName;
    }

    public void setDriverClassName(String driverClassName) {
        this.driverClassName = driverClassName;
    }

    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    @Override
    public String toString() {
        return "DataSourceConfigurationProperties{" +
                "driverClassName='" + driverClassName + '\'' +
                ", url='" + url + '\'' +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                '}';
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

4.2 测试效果

@RestController
public class HelloController {

    @Autowired
    private DataSourceProperties dataSourceProperties;

    @Autowired
    private DataSourceConfigurationProperties dataSourceConfigurationProperties;

    @GetMapping("/hello")
    public String hello(){
        System.out.println("dataSourceProperties = " + dataSourceProperties);
        System.out.println("dataSourceConfigurationProperties = " + dataSourceConfigurationProperties);
        return "Hello,Spring Boot 3!";
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

• 浏览器访问路径，控制台查看效果
  

5. 多环境配置和使用

5.1 需求

• 在 Spring Boot 中，可以使用多环境配置来根据不同的运行环境（如开发、测试、生产）加载不同的配置。SpringBoot 支持多环境配置让应用程序在不同的环境中使用不同的配置参数，例如数据库连接信息、日志级别、缓存配置等。
• 以下是实现 Spring Boot 多环境配置的常见方法：
  • 属性文件分离：将应用程序的配置参数分离到不同的属性文件中，每个环境对应一个属性文件。例如，可以创建application-dev.properties、application-prod.properties和application-test.properties等文件。在这些文件中，可以定义各自环境的配置参数，如数据库连接信息、端口号等。然后，在application.properties中通过spring.profiles.active属性指定当前使用的环境。Spring Boot 会根据该属性来加载对应环境的属性文件，覆盖默认的配置。
  • YAML 配置文件：与属性文件类似，可以将配置参数分离到不同的 YAML 文件中，每个环境对应一个文件。例如，可以创建application-dev.yml、application-prod.yml和application-test.yml等文件。在这些文件中，可以使用 YAML 语法定义各自环境的配置参数。同样，通过spring.profiles.active属性指定当前的环境，Spring Boot 会加载相应的 YAML 文件。
  • 命令行参数(动态)：可以通过命令行参数来指定当前的环境。例如，可以使用--spring.profiles.active=dev来指定使用开发环境的配置。
• 通过上述方法，Spring Boot 会根据当前指定的环境来加载相应的配置文件或参数，从而实现多环境配置。这样可以简化在不同环境之间的配置切换，并且确保应用程序在不同环境中具有正确的配置。

5.2 多环境配置（基于方式 b 实践）

创建开发、测试、生产三个环境的配置文件

• application-dev.yml（开发）

spring:
  jdbc:
    datasource:
      driverClassName: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql:///dev
      username: root
      password: root
1
2
3
4
5
6
7

• application-test.yml（测试）

spring:
  jdbc:
    datasource:
      driverClassName: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql:///test
      username: root
      password: root
1
2
3
4
5
6
7

• application-prod.yml（生产）

spring:
  jdbc:
    datasource:
      driverClassName: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql:///prod
      username: root
      password: root
1
2
3
4
5
6
7

5.3 环境激活

spring:
  profiles:
    active: dev
1
2
3

5.4 测试效果

• 注意 :

  • 如果设置了 spring.profiles.active，并且和 application 有重叠属性，以 active 设置优先。

  • 如果设置了 spring.profiles.active，和 application 无重叠属性，application 设置依然生效！