【Spring Boot】Spring Boot 配置文件详解(application.yml、application-dev.yml、application-test.yml )

一、application.yml 基础配置

是 Spring Boot 中用于配置应用程序属性的主要配置文件之一。这个文件通常用于配置应用程序的一般性属性,包括数据库连接、日志级别、端口号等。下面是一些常见的在 application.yml 中配置的示例:

# 服务器端口
server:
  port: 8080

# 数据库连接配置
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydatabase
    username: root
    password: password
    driver-class-name: com.mysql.cj.jdbc.Driver

# 日志级别
logging:
  level:
    root: INFO
    com.example.mypackage: DEBUG

# 应用程序自定义属性
myapp:
  name: My Spring Boot App
  version: 1.0

上述示例展示了一些常用的配置项,但根据应用程序的需求,你可以在 application.yml 中配置各种属性。Spring Boot 非常灵活,可以根据属性的前缀识别属性,并将其绑定到对应的 Java 对象上,以方便在代码中使用。

需要注意的是,application.yml 文件采用 YAML(YAML Ain’t Markup Language)语法,它使用缩进和冒号来表示层次关系。因此,正确的缩进对于保持文件的结构是很重要的。

二、配置文件在项目中起到的具体作用

在 Spring Boot 中,可以通过属性文件(比如 application.yml 或 application.properties)来配置应用程序的属性。这些属性可以直接映射到 Java 对象中,从而在代码中方便地使用

1、@ConfigurationProperties 注解

  • 提供了一种方便的方式,可以将配置文件中的属性映射到 Java
    对象的字段上。这样做的一个常见的方式是使用属性的前缀来进行匹配。以下是一个简单的示例:

    # application.yml myapp:   database:
        url: jdbc:mysql://localhost:3306/mydatabase
        username: root
        password: password 
    
    import org.springframework.boot.context.properties.ConfigurationProperties;
    import org.springframework.stereotype.Component;
    
    @Component 
    @ConfigurationProperties(prefix = "myapp.database") public
    class DatabaseProperties {
        private String url;
        private String username;
        private String password;
    
        // Getters and setters
    
        // 可以在这里添加其他的业务逻辑 
    } 
    

    在这个例子中,DatabaseProperties 类的属性(urlusernamepassword)会与
    application.yml 文件中 myapp.database 下的属性相匹配。Spring Boot 会自动将这些属性值注入到
    DatabaseProperties 实例中。

    然后,你可以在其他组件中注入 DatabaseProperties,并直接使用其中的属性:

    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Service;
    
    @Service public class DatabaseService {
        private final DatabaseProperties databaseProperties;
    
        @Autowired
        public DatabaseService(DatabaseProperties databaseProperties) {
            this.databaseProperties = databaseProperties;
        }
    
        public void connectToDatabase() {
            String url = databaseProperties.getUrl();
            String username = databaseProperties.getUsername();
            String password = databaseProperties.getPassword();
    
            // 连接到数据库的逻辑...
        } 
    } 
    

    通过这种方式,你可以将配置文件中的属性映射到 Java
    对象上,并在代码中方便地使用这些属性。这种配置方式可以帮助你集中管理应用程序的配置,并提高代码的可维护性。

2、@Value 注解

  • 使用 @Value 注解可以直接将配置文件中的属性值注入到 Spring Bean 中的字段或方法参数上。
    @Value("${property.name}") private String
       propertyName;
    

3、Environment 对象

  • 通过 Environment 对象获取配置属性。

    @Autowired private Environment env;
       
    public void someMethod() {
       	String propertyValue = env.getProperty("property.name"); 
    }
    

4、 @PropertySource 注解引入外部属性文件

  • 使用 @PropertySource 注解可以在配置类中引入外部的属性文件。

    public class MyConfiguration {
        @Value("${custom.property}")
        private String customProperty;
    } 
    

5、@ConfigurationPropertiesScan 注解(Spring Boot 2.2+)

  • 这个注解允许在指定的包及其子包中扫描 @ConfigurationProperties 注解,无需显式声明
    @ConfigurationProperties 的 Bean。

    @ConfigurationPropertiesScan("com.example.config") 
    

这些方式都允许在应用程序中方便地访问配置文件中的属性值,开发者可以根据具体情况选择最适合的方式。

三、Spring Boot 的其他配置文件

在 Spring Boot 中,除了常见的 application.ymlapplication.properties 外,你还可以使用其他自定义的配置文件。Spring Boot 提供了以下几种常见的配置文件:

1、application.properties/application.yml

  • 默认的主配置文件,Spring Boot 应用会自动加载该文件。存放应用程序的主要配置。

2、application-{profile}.properties/application-{profile}.yml:

  • 可以根据不同的环境配置不同的属性文件,{profile} 表示环境名称。
    例如,application-dev.properties 用于开发环境,application-prod.properties
    用于生产环境。

3、bootstrap.properties/bootstrap.yml:

  • 用于 Spring Cloud 应用,是 Spring Cloud Config 服务的默认配置文件。
    存放一些启动时需要优先加载的配置,比如连接到 Config Server 的配置。

4、application-{profile}.properties/application-{profile}.yml:

  • 可以根据不同的环境配置不同的属性文件,{profile} 表示环境名称。 例如,application-dev.properties
    用于开发环境,application-prod.properties 用于生产环境。

5、application-{label}.properties/application-{label}.yml:

  • 用于 Git 和配置服务器的外部化配置,{label} 表示 Git 的标签。
    例如,application-v1.properties 用于版本 1。

这些文件命名规范允许你根据不同的环境、配置标签或者配置文件类型组织和管理你的配置信息。Spring Boot 会根据上述规则自动加载相应的配置文件。

四、多配置文件使用哪个

Spring Boot 在启动时会加载默认的主配置文件,即 application.ymlapplication.properties。如果有不同环境的配置文件,如 application-test.ymlapplication-dev.yml,Spring Boot 会根据当前激活的环境来选择加载对应的配置文件。

1、设置 spring.profiles.active 指定激活环境

你可以通过在 application.yml 或 application.properties 中设置 spring.profiles.active 属性来指定激活的环境。例如:

spring:
  profiles:
    active: dev

上述配置表示激活 dev 环境,因此 Spring Boot 会加载 application-dev.yml 文件中的配置。

如果没有设置 spring.profiles.active 属性,Spring Boot 将默认使用主配置文件的配置。

2、命令行参数指定环境

除了通过属性文件来设置激活的环境外,你还可以通过命令行参数、系统属性、环境变量等方式来指定激活的环境。例如,通过命令行参数启动时指定环境:

java -jar your-application.jar --spring.profiles.active=dev

这样就会加载 application-dev.yml 的配置。

五、Springboot中配置文件的加载顺序

application.yml、application.properties和bootStrap.yml加载顺序

以jar包发布springboot项目时
默认会先使用jar包跟目录下的application.properties来作为项目配置文件。

如果在不同的目录中存在多个配置文件,它的读取顺序是:

1、config/application.properties(项目根目录中config目录下)
2、config/application.yml
3、application.properties(项目根目录下)
4、application.yml
5、resources/config/application.properties(项目resources目录中config目录下)
6、resources/config/application.yml
7、resources/application.properties(项目的resources目录下)
8、resources/application.yml

你可能感兴趣的:(java开发,spring,boot,后端,java)