SpringBoot在启动时的多环境配置以及加载顺序

时间:2021-12-06 22:53:12

SpringBoot在启动时的多环境配置以及加载顺序

  通常我们在开发完成一个SpringBoot项目时,总是要打包部署的。

  在启动SpringBoot应用时,我们常常会使用命令java -jar xxx.jar来启动这个服务。

  命令java -jar 除了启动应用之外,还可以在命令中指定应用的参数,比如一下带参数的命令:

  (1)java -jar xxx.jar --server.port=8081,直接以命令的方式来设置服务的访问端口server.port属性,将端口设置为8081;

  (2)java -jar -Xms1024m -Xmx1024m xxx.jar --spring.profiles.active=test ,以命令方式设置该服务启动时的内存大小,以及设置启动环境为test,并且服务是后台启动。

  在使用命令行方式启动SpringBoot应用时,设置参数时所使用的连续的两个减号 -- 就是对其属性配置文件application.properties或者application.yml中的属性值进行赋值的标识。所以java -jar xxx.jar --server.port=8081命令,就等价于在属性文件中添加属性server.port=8081。

  通过命令行的方式设置启动参数是SpringBoot的一个重要特性,在启动应用时,我们不仅可以设置应用的端口、访问路径、运行环境,还可以设置它的数据库连接等。但是在实际生产过程中,同一套应用程序会被应用和安装到不同的环境中,同时需要设置多个参数,这样的方式肯定不可取的。以是有了SpringBoot的多环境配置。

  一、SpringBoot多环境配置

  在SpringBoot中,进行多环境配置,需要配置多个属性文件。多环境配置的文件名需要满足application-{profile}.properties的格式,其中{profile}对应你的环境标识,比如:

  application-dev.properties: 表示你的开发环境

  application-test.properties: 表示你的测试环境

  application-prod.properties: 表示你的生产环境

  在启动项目的时候具体加载哪个属性文件,需要你在application.properties文件中通过spring.profiles.active属性来设置,比如spring.profiles.active=test就会加载application-test.properties属性文件。

  其中在application.properties属性文件中配置通用内容,并设置spring.profiles.active属性来指定启动环境。而application-{profile}.properties属性文件中则配置各个环境的不同信息,比如数据库连接信息、端口以及其他信息等。另外,虽然我们在application.properties属性文件中指定了启动时的环境,我们依然可以使用java -jar xxx.jar --spring.profiles.active命令来改变它的启动运行环境。

  在实际开发中,为了避免编写多个属性配置文件,我们可以将多个配置文件的内容,写到一个配置文件中,这里以一个application.yml为例,将SpringBoot应用的dev、test、prod等环境写到一个属性文件中,如下:

  server:

  port: 8820

  undertow:

  worker-threads: 400

  io-threads: 100

  buffer-size: 1024

  direct-buffers: true

  spring:

  application:

  name: fuwuhao-management

  profiles:

  active: dev

  jackson:

  time-zone: GMT+8

  ---

  spring:

  profiles: dev

  datasource:

  type: com.zaxxer.hikari.HikariDataSource

  driver-class-name: com.mysql.jdbc.Driver

  hikari:

  username: root

  password: root

  jdbc-url: jdbc:mysql://127.0.0.1:3306/dataBase?autoReconnect=truecharacterEncoding=UTF-8allowMultiQueries=trueuseSSL=false

  minimum-idle: 5

  maximum-pool-size: 15

  auto-commit: true

  idle-timeout: 30002

  pool-name: DatebookHikariCP

  max-lifetime: 500000

  connection-timeout: 30001

  #connection-test-query: SELECT 1

  validation-timeout: 5000

  ---

  spring:

  profiles: test

  datasource:

  type: com.zaxxer.hikari.HikariDataSource

  driver-class-name: com.mysql.jdbc.Driver

  hikari:

  username: root

  password: root

  jdbc-url: jdbc:mysql://127.0.0.1:3306/dataBase?autoReconnect=truecharacterEncoding=UTF-8allowMultiQueries=trueuseSSL=false

  minimum-idle: 5

  maximum-pool-size: 15

  auto-commit: true

  idle-timeout: 30002

  pool-name: DatebookHikariCP

  max-lifetime: 500000

  connection-timeout: 30001

  #connection-test-query: SELECT 1

  validation-timeout: 5000

  ---

  spring:

  profiles: prod

  datasource:

  type: com.zaxxer.hikari.HikariDataSource

  driver-class-name: com.mysql.jdbc.Driver

  hikari:

  username: root

  password: root

  jdbc-url: jdbc:mysql://127.0.0.1:3306/dataBase?autoReconnect=truecharacterEncoding=UTF-8allowMultiQueries=trueuseSSL=false

  minimum-idle: 5

  maximum-pool-size: 15

  auto-commit: true

  idle-timeout: 30002

  pool-name: DatebookHikariCP

  max-lifetime: 500000

  connection-timeout: 30001

  #connection-test-query: SELECT 1

  validation-timeout: 5000

  通过这种方式的配置,就避免了写太多的属性文件。在启动应用的时候,我们可以使用命令java -jar xxx.jar --spring.profiles.active=prod来随意切换环境即可。

  二、SpringBoot启动时加载顺序

  在SpringBoot应用启动时,将会按照下面的顺序来进行属性的加载:

  (1) 首先加载启动命令中传入的参数;

  (2) 加载SPRING_APPLICATION_JSON中的属性。SPRING_APPLICATION_JSON是以JSON格式配置在系统环境变量中的内容;

  (3) 加载java:comp/dev中的JNDI属性;

  (4) 加载Java的系统属性,可以通过System.getProperties()获取到的内容;

  (5) 加载操作系统的环境变量;

  (6) 加载random.*配置的随机属性;

  (7) 加载位于当前应用jar包之外,针对不同{profile}环境的配置文件内容,比如application-{profile}.properties或者YAML定义的配置文件;

  (8) 加载位于当前应用jar包之内,针对不同{profile}环境的配置文件内容,比如application-{profile}.properties或者YAML定义的配置文件;

  (9) 加载位于当前应用jar包之外的application.properties和YAML配置内容;

  (10) 加载位于当前应用jar包之内的application.properties和YAML配置内容;

  (11) 加载含有@Configuration注解的类,通过@PropertySource注解定义的属性;

  (12) 最后加载应用的默认属性,使用SpringApplication.setDefaultProperties定义的内容。

  加载的优先级按照以上顺序由高到底,数字越小的优先级越高,越先被加载。

  在这里额外说一下(6)中提到的随机数:

  在SpringBoot的属性配置文件中,可以通过使用${random}配置来产生随机的int值、long值或者string字符串,这样我们就可以容易地通过配置随机生成属性。

  ${random}的配置主要有以下几种形式:

  (1)随机字符串:

  random.stringValue=${random.value}

  (2)随机int:

  random.intValue=${random.int}

  (3)随机long:

  random.longValue=${random.long}

  (4)100以内的随机数:

  random.number=${random.int(100)}

  (5)100到1000的随机数:

  random.number=${random.int[100,1000]}