通常我们在开发完成一个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=true&characterEncoding=UTF-8&allowMultiQueries=true&useSSL=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=true&characterEncoding=UTF-8&allowMultiQueries=true&useSSL=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=true&characterEncoding=UTF-8&allowMultiQueries=true&useSSL=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]}