Spring Boot - 配置文件外置

发表于 | 分类于 | 评论数： | 阅读次数：
本文字数： 2.3k | 阅读时长 ≈ 2 分钟

Spring Boot启动会加载大量的自动配置类，相比以前 XML 的配置方式，很多显式方式申明是不需要的，从而可以更快速的开发。

Spring Boot的配置文件有两种：.properties 文件和 .yml 文件。
使用固定的 application.properties 或者 application.yml 文件做为全局的配置文件，启动时会扫描它们作为默认配置文件。

在很多场景下，我们需要去修改配置文件，如：端口、数据库地址等等。把所有配置全都打在包里，显然不是最好的做法，更常见的做法是把配置文件放在外面，可以在需要时不动代码的前提下修改配置。

本文章将介绍如何自定义Sping Boot配置文件的位置，特别是war包运行在独立tomcat下时如何在外部配置。

默认加载位置

Spring Boot提供了将配置文件放置到包外面的方法，在没有特殊配置和命令的情况下，启动时会扫描以下位置的默认配置文件以获取配置：

1
2
3
4
- file:./config/        # 当前目录下的/config目录
- file:./               # 当前目录
- classpath:/config/    # classpath里的/config目录
- classpath:/           # classpath的跟目录

加载优先级

参考官方文档-SpringBootConfig
优先级由高到低，高优先级的配置会覆盖低优先级的配置，互补配置。

  1. 命令行指定

    我们可以使用 –spring.config.location=xxx 这样的命令形式来配置指定目录下的配置文件

    1
    2
    3
    4
    5
    6
    7
    java -jar demo.jar --spring.config.location=file:/config.yml

    # 或者
    java -jar -Dspring.config.location=file:/config.yml demo.jar

    # 如果是指定目录的话，则路径后必须加 /
    java -jar demo.jar --spring.config.location=file:/config/

    如果不希望命令行指定配置文件的话，可以在SpringApplication 中将其禁用 

    1
    2
    SpringApplication.setAddCommandLineProperties(false)
      ``
  1. jar包外部的application-{profile}.properties或application.yml (带spring.profile)配置文件
  2. jar包内部的application-{profile}.properties或application.yml(带spring.profile)配置文件
  3. jar包外部的application.properties或application.yml(不带spring.profile)配置文件
  4. jar包内部的application.properties或application.yml(不带spring.profile)配置文件

  5. @Configuration注解类上的 @PropertySource

    1
    2
    3
    4
    5
    6
    7
    8
    9
    @SpringBootApplication
    @PropertySource(value={"file:config.properties"}, ignoreResourceNotFound = true)
    public class SpringbootrestdemoApplication {
    public static void main(String[] args) {
      SpringApplication.run(SpringbootrestdemoApplication.class, args);
    }
    }

    // 注意：@PropertySource注解配置路径的方式不适用于 .yml 文件

war包外部配置

1）仿照 jar 包配置，设置 spring.config.location

在 tomcat/bin 的 catalina.sh 文件中增加一行代码，指定 spring.config.location为配置文件的绝对路径 :

tomcat/bin/catalina.sh
1
export CATALINA_OPTS="$CATALINA_OPTS -Dspring.config.location=/config.yml"

2）仿照 jar 包配置，读取外部 config 文件夹

在 tomcat根目录下新建一个名为 config 的文件夹，并新增 tomcat/conf 的 catalina.properties 配置，添加 common.loader 为config文件夹的位置：

tomcat/conf/catalina.properties
1
common.loader="${catalina.home}/config"

3）多个war包的配置

当tomcat内有多个war包时，可以将多个war包需要的配置文件都放在config文件夹内，并在SpringApplication 中增加如下配置：

1
spring.profiles.active=xxxx

不同的war包就会读取不同的 config/application-xxxx.properties 配置文件。

相关文章推荐
0%