Solon

六、配置内部与外部的加载顺序

</> markdown

应用配置的加载主要分了五个层级,其加载顺序为:(以键为单位,后加载的会盖掉前加载的)

(L1)内部资源配置文件

是指会与代码一起打包到的资源配置文件,打包后,没法修改。所以也需要“外部配置文件”和“动态配置”加以补充。

  • 应用属性配置

即内部的 "app.yml"、"app.properties"。

  • 应用环境属性配置

即内部带环境标记的 "app-xxx.yml"、"app-xxx.properties"(如:"app-dev.yml","app-pro.yml")。

  • 通过 "solon.config.load" 添加的内部资源配置文件
solon.config.load:
  - "${solon.env}/jdbc.yml"
  - "docs.yml"

(L2)外部本地配置文件

  • 通过 “solon.config.add” 添加的外部配置文件
solon.config.add: "./app.yml" #会加载 jar 边上的 app.yml 配置文件(多个用","隔开)

或者在启动时指定:

java -jar demo.jar --solon.config.add=./app.yml
java -Dsolon.config.add=./app.yml -jar demo.jar

(L3)动态配置

  • 启动参数
java -jar demo.jar -debug=1
  • 系统属性
java -Dsolon.config.add=./app.yml -jar demo.jar
  • 环境变量(比如编排容器时)
services:
  demoapi:
    image: demo/demoapi:1.0.0
    container_name: demoapi
    environment:
      - solon.stop.safe=1
      - TZ=Asia/Shanghai
    ports:
      - 8080:8080

"solon" 开头的环境变量,会被框架同步到系统属性(System::getProperties)与应用属性(Solon::cfg)。

(L4)启动初始化时接口加载的配置

  • 加载配置文件
Solon.start(App.class, args, app->{
    app.cfg().loadAdd("demo.yml");
});
  • 加载环境变量(打包 docker 镜像时,非常方便)
Solon.start(App.class, args, app->{
    //通过前缀加载环境变量
    app.cfg().loadEnv("demo.");
});

(L5)云端配置(Solon Cloud Config)

solon.cloud.nacos:
  config:
    load: "jdbc.yml,auth.yml"