第二章 Spring Boot快速⼊⻔ —— Spring Boot配置文件

前言：

在Spring Boot中配置文件用于配置各种属性、参数和设置的重要文件；配置文件有两种不同的格式，一个是properties,另一个是yaml（简写yml）。虽然properties文件比较常见，但是相对于properties而言，yaml更加简洁明了，而且使用的场景也更多，基本现在项目都是使用yaml进行配置。除了简洁，yaml还有另外一个特点，就是yaml中的数据是有序的，properties中的数据是无序的，在一些需要路径匹配的配置中，顺序就显得尤为重要（例如我们在Spring Cloud Zuul中的配置），此时我们一般采用yml。

一：配置文件类型

bootstrap.properties（或bootstrap.yml）：用于在Spring Boot应用程序启动时加载的属性文件，主要用于配置一些优先级较高的属性，如应用程序的上下文路径、端口号等。这些属性在应用程序启动过程中会被优先加载。
application.properties:基于键值对的配置文件，可以在其中设置各种属性值。这是Spring Boot项目中默认的配置文件类型。
application.yaml（或者application.yml）:基于YAML格式的配置文件，相比properties文件更加简洁易读，支持层次化结构。YAML文件以冒号分隔键值对，并支持缩进表示层级关系。
application-{profile}.properties或application-{profile}.yml：针对不同的环境（如开发、测试、生产等），可以使用不同的配置文件。其中，{profile}代表特定的环境名称，如application-dev.properties用于开发环境，application-prod.yml用于生产环境。

1.properties基于键值对：

2.yml文件层次结构：

二：文件名名称

配置文件的名称不一定叫application，可以自定义配置文件名称，一般项目中有些额外的配置会自定义文件名称，例如在resources目录下创建一个demo.yml文件

使用的时候也非常简单，使用注解@PropertySources引入即可

三：配置文件的加载顺序和优先级

spring Boot在启动时会自动加载配置文件，并按照一定的顺序和优先级进行合并。具体的加载顺序和优先级如下：

命令行参数：启动应用时传入的命令行参数具有最高的优先级，可以覆盖其他所有配置。
系统环境变量：系统环境变量中的配置也具有较高的优先级，可以覆盖application.properties或application.yml文件中的配置。
Java系统属性：通过System.getProperties()方法获取的Java系统属性也可以作为配置来源。
注解设置的属性文件：通过@PropertySource注解指定的属性文件也可以被加载。
启动类设置的默认属性：通过SpringApplication.setDefaultProperties方法设置的默认属性。
application-{profile}.properties或application-{profile}.yml：针对特定环境的配置文件。
application.properties或application.yml：默认的全局配置文件。

四：使用配置文件

1.常规使用示例

server:
  port: 8001
  
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/demo
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

2.数组配置示例

yml配置：

demo:
  test:
    - 1
    - 2
    - 3

读取配置

@Component
@ConfigurationProperties(prefix = "demo")
public class TestProperties {
    private List<String> tests;
 
    public List<String> getTests() {
        return items;
    }
 
    public void setTests(List<String> tests) {
        this.tests= tests;
    }
}

controller测试

@RestController
public class TestController {
 
    @Autowired
    private TestProperties testProperties ;
 
    @GetMapping("/items")
    public List<String> getTests() {
        return testProperties.getTests();
    }
}

3.集合配置示例

yml配置:

demo:
  test:
    names:
      - 测试1
      - 测试2
      - 测试3

读取配置:

@Component
@ConfigurationProperties(prefix = "demo.test")
public class TestProperties {
    private Set<String> names;
 
    // Getter 和 Setter 方法
    public Set<String> getNames() {
        return names;
    }
 
    public void setNames(Set<String> names) {
        this.names = names;
    }
}

controller测试

@RestController
public class TestController {
 
    @Autowired
    private TestProperties testProperties ;
 
    @GetMapping("/names")
    public List<String> getNames() {
        return testProperties.getNames();
    }
}

注意事项:

配置文件格式：确保配置文件的格式正确，例如YAML文件中的缩进和冒号使用。
前缀匹配 ：在配置类和控制器中，使用@ConfigurationProperties注解时，要确保前缀与配置文件中的键匹配。
数据类型：确保配置文件中的数据类型与配置类中定义的字段类型一致。
环境区分 ：对于不同环境（如开发、测试、生产），可以使用不同的配置文件（如application-dev.yml、application-prod.yml）来区分配置。

通过合理使用Spring Boot的配置文件，可以方便地管理应用程序的各种配置信息，提高代码的可维护性和灵活性。