SpringBoot - 配置文件application.properties使用详解（附：Profile多环境配置

作者: hangge 发布时间: 2019-09-02 浏览: 3286 次 编辑

1，开启自动转码功能

application.properties 提供了自定义属性的支持，如果数据有中文的话需要进行转码，否则可能会出现乱码问题。

如果我们使用的是 IntelliJ IDEA，那么直接在 setting 配置中进行如下设置，这样编辑器就会自动对中文内容进行转码。

原文:SpringBoot - 配置文件application.properties使用详解（附：Profile多环境配置）


2，配置属性的定义

（1）我们可以在 application.properties 中添加类似如下这样简单的常量配置：

1
2
my.name=航歌
my.age=100


（2）配置属性之间也可以相互引用使用： 

1
2
3
my.name=航歌
my.age=100
my.info=name:${my.name} age:${my.age}


（3）配置文件中可以使用 ${random} 来生成各种不同类型的随机值：

1
2
3
4
5
6
my.secret=${random.value}
my.number=${random.int}
my.bignumber=${random.long}
my.uuid=${random.uuid}
my.number.less.than.ten=${random.int(10)}
my.number.in.range=${random.int[1024,65536]}

3，将数据注入到属性上

（1）在需要的地方我们使用 @Value 注解就可以将数据注入到属性上：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
package com.example.demo;
 
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.GetMapping;
 
@RestController
public class HelloController {
    @Value("${my.name}")
    String name;
 
    @GetMapping("/hello")
    public String hello() {
        return "welcome to " + name;
    }
}


（2）运行结果如下：

原文:SpringBoot - 配置文件application.properties使用详解（附：Profile多环境配置）


4，将数据注入到 Bean 中

有时候属性太多了，一个个绑定到属性字段上太麻烦，官方提倡绑定一个对象的 bean。

（1）首先我们创建一个名为 My 的 Bean，并将前面的配置数据注入到这个 Bean 中。

（1）@ConfigurationProperties 中的 prefix 属性描述了要加载的配置文件的前缀。
（2）Spring Boot 采用了一种宽松的规则来进行属性绑定：

  • 假设 Bean 中的属性名为 authorName，那么配置文件中的属性可以是 my.author_name、my.author-name、my.authorName 或者 my.AUTHORNAME

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
package com.example.demo;
 
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
 
@Component
@ConfigurationProperties(prefix = "my")
public class My {
    private String name;
    private String age;
 
    public String getName() {
        return name;
    }
 
    public void setName(String name) {
        this.name = name;
    }
 
    public String getAge() {
        return age;
    }
 
    public void setAge(String age) {
        this.age = age;
    }
}


（2）然后我们在 Controller 中引入这个 Bean 使用即可：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
package com.example.demo;
 
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.GetMapping;
 
@RestController
public class HelloController {
    @Autowired
    My my;
 
    @GetMapping("/hello")
    public String hello() {
        return my.getName() + " : " + my.getAge();
    }
}

（3）运行结果如下：

原文:SpringBoot - 配置文件application.properties使用详解（附：Profile多环境配置）


5，使用自定义的配置文件

（1）有时候我们不希望把所有配置都放在 application.properties 里面，这时候我们可以另外定义一个。假设我们自定义的配置文件是 test.properties，放在 src/main/resources 下面。

（2）新建一个 bean 类后，通过如下方式将这个自定义的配置文件数据注入进来：

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
package com.example.demo;
  
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
  
@Component
@ConfigurationProperties(prefix = "my")
@PropertySource("classpath:test.properties")
public class My {
    private String name;
    private String age;
  
    public String getName() {
        return name;
    }
  
    public void setName(String name) {
        this.name = name;
    }
  
    public String getAge() {
        return age;
    }
  
    public void setAge(String age) {
        this.age = age;
    }
}


6，使用命令行参数进行配置

（1）在命令行中通过 java -jar 命令启动项目时，可以使用连续的两个减号 -- 对 application.properties 中的属性值进行赋值。

（2）比如下面命令修改 tomcat 端口号为 8081。其等价于在 application.properties 中添加属性 server.port=8081：

注意：如果 application.properties 中已经有同名属性，那么命令行属性会覆盖 application.properties 的属性。

1
java -jar xx.jar --server.port=8081


7，配置文件的优先级

（1）Spring Boot 项目中的 application.properties 配置文件一共可以出现在如下 4 个位置（优先级逐渐降低）：

  • 项目根目录下的 config 文件夹

  • 项目根目录下

  • classpath 下的 config 文件夹

  • classpath 下

（2）如果这 4 个地方都有 application.properties 文件，加载的优先级就是从 1 到 4 依次降低，Spring Boot 将按照这个优先级查找配置信息。

原文:SpringBoot - 配置文件application.properties使用详解（附：Profile多环境配置）


附：使用 Profile 实现多环境配置

    我们在项目发布之前，一般需要频繁地在开发环境、测试环境以及生产环境之间进行切换，这个时候大量的配置需要频繁更改（比如数据库配置、redis 配置、mongodb 配置等等）。
    Spring Boot 的 Profile 就给我们提供了解决方案，它约定不同环境下的配置文件名称规则为：

  • application-{profile}.properties，其中 {profile} 表示当前环境的名称。

1，创建配置文件 

（1）首先在 resources 目录下创建两个配置文件：application-dev.properties 和 application-prod.properties，分别表示开发环境中的配置和生产环境中的配置。

（2）它们两个分别设置不同的端口号。

1
2
3
4
5
#application-dev.properties
server.port=8080
 
#application-prod.properties
server.port=80


2，在 application.properties 中配置环境

（1）假设我们在 application.properties 中进行如下配置，则表示使用 application-dev.properties 配置文件启动项目。

1
spring.profiles.active=dev


（2）如果将 dev 改为 prod，则表示使用 application-prod.properties 启动项目。

1
spring.profiles.active=prod


（3）项目启动成功后，就可以通过相应的端口进行访问了。

3，在代码中配置环境

（1）除了像前面那样在 application.properties 中添加配置，我们也可以在代码中添加配置来完成。

（2）比如我们在启动类的 main 方法上添加如下代码，表示使用 application-dev.properties 配置文件启动项目。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
package com.example.demo;
 
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
 
@SpringBootApplication
public class DemoApplication {
 
    public static void main(String[] args) {
        SpringApplicationBuilder builder = new
                SpringApplicationBuilder(DemoApplication.class);
        builder.application().setAdditionalProfiles("dev");
        builder.run(args);
    }
}

4，在项目启动时配置环境

我们也可以在项目打包成 jar 包后启动时，在命令行中动态指定当前环境：

1
java -jar xxx.jar --spring.profiles.active=dev


原文链接：https://www.hangge.com/blog/cache/detail_2458.html


标签: SprintBoot SpringBoot - 配置文件application.properties使用详解（附：Profile多环境配置
上一篇： SpringBoot - 内置的Tomcat服务器配置详解（附：启用HTTPS服务） 下一篇： SpringBoot - 配置文件application.yml使用详解（附：Profile多环境配置

本文地址： https://niwoxuexi.com/blog/hangge/article/668

版权声明：本篇文章，如非注明，皆为博主 hangge 原创。转载需注明本文链接并保证链接可用。