Spring boot项目学习系列一——获取自定义配置，以及多环境配置文件的切换以及获取配置文件原理

心已赠人 2023-03-14 10:51 8阅读 0赞

最近只要稍微学一点东西就觉得很有收获，好像自己的储备彻彻底底不够用了，需要赶紧补充点技术能量

git上搜到一个大神项目[https://github.com/xkcoding/spring-boot-demo][https_github.com_xkcoding_spring-boot-demo]，感觉超级棒，于是开启spring boot项目学习之旅

目标：获取配置文件的自定义配置，以及多个环境之间如何切换配置文件

理解：不是很到位没有理解目标的含义，看到这篇文章[https://segmentfault.com/a/1190000020247777][https_segmentfault.com_a_1190000020247777]之后突然理解了

additional-spring-configuration-metadata.json该文件的内容是元数据，我自己理解成它是对在配置文件中配置时会用的键值或者说属性的定义，然后在配置文件application.xml或者是application.properties中会有提示，这里我做了个小实验，后面会讲到

一、目录：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70][]

二、元数据： additional-spring-configuration-metadata.json，它的位置是在src/main/resources/META-INF文件夹下面，

META-INF文件夹是自己建的。

{
      "properties": [
        {
          "name": "application.name",
          "description": "Default value is artifactId in pom.xml.",
          "type": "java.lang.String"
        },
        {
          "name": "application.version",
          "description": "Default value is version in pom.xml.",
          "type": "java.lang.String"
        },
        {
          "name": "developer.name",
          "description": "The Developer Name.",
          "type": "java.lang.String"
        },
        {
          "name": "developer.website",
          "description": "The Developer Website.",
          "type": "java.lang.String"
        },
        {
          "name": "developer.qq",
          "description": "The Developer QQ Number.",
          "type": "java.lang.String"
        },
        {
          "name": "developer.phone-number",
          "description": "The Developer Phone Number.",
          "type": "java.lang.String"
        }
      ]
    }

三、主配置文件application.yml

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 1][]

server:
      port: 8080
      servlet:
        context-path: /demo
    spring:
      profiles:
        active: dev

四、各环境独有的配置

1）dev环境：application-dev.xml

application:
      name: dev环境 @artifactId@
      version: dev环境 @version@
    developer:
      name: dev环境 xkcoding
      website: dev环境 http://xkcoding.com
      qq: dev环境 237497819
      phone-number: dev环境 17326075631

2)prod环境：application-prod.xml

application:
      name: prod环境 @artifactId@
      version: prod环境 @version@
    developer:
      name: prod环境 xkcoding
      website: prod环境 http://xkcoding.com
      qq: prod环境 237497819
      phone-number: prod环境 17326075631

五、pom.xml

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.1.9.RELEASE</version>
            <relativePath/> 
        </parent>
        <groupId>com.example</groupId>
        <artifactId>spring-boot-properties-demo</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <name>spring-boot-properties-demo</name>
        <description>Demo project for Spring Boot</description>
    
        <properties>
            <java.version>1.8</java.version>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
    
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-configuration-processor</artifactId>
                <optional>true</optional>
            </dependency>
            <dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <optional>true</optional>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
            </dependency>
    
            <dependency>
                <groupId>org.junit.jupiter</groupId>
                <artifactId>junit-jupiter-api</artifactId>
                <version>5.5.0</version>
                <scope>test</scope>
            </dependency>
    
        </dependencies>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    
    </project>

六、code

1)ApplicationProperty.java

package com.example.springbootpropertiesdemo;
    
    import lombok.Data;
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.stereotype.Component;
    
    /**
     * 项目配置
     */
    
    @Data
    @Component
    public class ApplicationProperty {
    
        @Value("${application.name}")
        private String name;
        @Value("${application.version}")
        private String version;
    }

2)DeveloperProperty.java

package com.example.springbootpropertiesdemo;
    
    import lombok.Data;
    import org.springframework.boot.context.properties.ConfigurationProperties;
    import org.springframework.stereotype.Component;
    
    /**
     * 开发人员配置信息
     */
    
    @Data
    @ConfigurationProperties(prefix = "developer")
    @Component
    public class DeveloperProperty {
        private String name;
        private String website;
        private String qq;
        private String phoneNumber;
    
    }

3)PropertyController.java

package com.example.springbootpropertiesdemo;
    
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import java.util.HashMap;
    import java.util.Map;
    
    @RestController
    public class PropertyController {
    
        private final ApplicationProperty applicationProperty;
        private final DeveloperProperty developerProperty;
    
        @Autowired
        public PropertyController(ApplicationProperty applicationProperty, DeveloperProperty developerProperty) {
            this.applicationProperty = applicationProperty;
            this.developerProperty = developerProperty;
        }
    
        @GetMapping("properties")
        public Map<String ,Object> index(){
            Map<String,Object> map = new HashMap<>();
            map.put("applicationProperty",applicationProperty);
            map.put("developerProperty",developerProperty);
            return  map;
        }
    }

七、访问

![20200517190033934.png][]

八、提示小实验——不同后缀配置文件中分别输入自定义配置键的首字母

1）.yml

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 2][]

2).properties

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 3][]

总结一下：即使有元数据文件，yml配置文件还是没有提示，但是properties文件有提示，所以是开发人员用properties更改合适吗，哈哈

--------------------

所以配置文件是如何根据

spring:  
  profiles:  
    active: dev

来获取配置的呢？

1）spring boot的入口文件，然后按住contrl层层点进去

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 4][]

2）

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 5][]

3）![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 6][]

4）![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 7][]

5）

![20200523173928142.png][]

6）

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 8][]

7）不断的打debug尝试

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 9][]

发现这里的后缀拼接先拼接的是properties,如果找不到然后又拼接xml,xml也找不到则拼接yml

[https_github.com_xkcoding_spring-boot-demo]: https://github.com/xkcoding/spring-boot-demo
[https_segmentfault.com_a_1190000020247777]: https://segmentfault.com/a/1190000020247777
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70]: /images/20230312/7c09937c26bd41f8a49e45a781f933b1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 1]: /images/20230312/e39314708f55440d820faed59bcf4fb9.png
[20200517190033934.png]: /images/20230312/3a986e21720e4b9dade5aca9e35bc15a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 2]: /images/20230312/73c84fd6207345589b599e8dc00989ee.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 3]: /images/20230312/1a5892110bfa45d78fe788cdcd98aab7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 4]: /images/20230312/c067da6d582742aaa98d8003c7e49958.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 5]: /images/20230312/c63861d391da42eda91224c212d914ef.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 6]: /images/20230312/9794ff5715eb4677b2396de672ffcf2a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 7]: /images/20230312/f97d988f1ce242009919ab9992035d3a.png
[20200523173928142.png]: /images/20230312/c5ec5f38f97341ae9e093eee72c2e4f7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 8]: /images/20230312/083915f0f7c74c588d4996fbc6be78aa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1N1bl9vZl9SYWlueQ_size_16_color_FFFFFF_t_70 9]: /images/20230312/99bf0364d75041c58f5fae0a26f1ad58.png