Spring BOOT 啟動參數
在Java Web的開發完成后,以前我們都會打包成war文件,然后放大web容器,比如tomcat、jetty這樣的容器。現在基于SpringBoot開發的項目,我們直接打包成jar文件,基于內嵌的tomcat來實現一樣的效果。
而啟動的方式變成了這樣:
java [ options ] -jar *.jar [ arguments ]
常見配置
我們常見的配置有:
- --server.port:指定應用程序的端口號。
- --spring.profiles.active:設置應用程序使用的配置文件中的環境配置。
- --spring.config.additional-location:指定額外的配置文件路徑。
- --Xms:設置JVM初始堆大小。
- --Xmx:設置JVM最大堆大小。
- --XX:PermSize:設置JVM永久代大小。
- --XX:MaxPermSize:設置JVM最大永久代大小。
- --Xdebug:開啟遠程JDWP調試。
- -D:定義屬性。
options
在啟動參數中,我們可以通過添加這樣的配置,來覆蓋系統屬性中的值:
java -Dfile.encoding=UTF-8 -jar app.jar
在代碼中可以通過這樣獲取該值:
String fileEncoding = System.getProperties("file.encoding"); //UTF-8
在很多項目中,都會基于*System.getProperties()*來控制代碼流程,這里要注意,通過啟動參數配置的值優先級會大于系統中的配置。同時注意改配置出現的位置,在上面使用了options位置來進行區分。
arguments
在SpringBoot項目中,我們一般把配置都會寫在application.yml文件中,隨著項目一并打包到jar文件中,在生產環境中, 啟動項目時通過添加*--spring.config.location=/application.yml*來修改項目的配置文件指向,從而實現覆蓋application的效果。
同樣,我們可以通過配置啟動參數來覆蓋application中的某個配置項,比如:
java -Dfile.encoding=UTF-8 -jar app.jar --server.port=8080
可以在main方法的參數中獲取該值
log.info(" >> >> > args: {}", Arrays.toString(args) );
參數的位置在上面對應arguments位置。
優先級
系統參數或環境變量:
- 啟動配置
- set prop=value (export prop=value)
- 系統中配置的參數或環境變量
Spring中的配置:
- 啟動參數
- --spring.config.location=application.yml
- classpath:application.yml
EnvironmentAware
在Spring中,提供了一個Aware接口 EnvironmentAware ,通過該接口我們可以很方便地獲取上面說的那些參數,不用關心是系統屬性、環境變量還是main方法的args。
public class MyService implements ApplicationContextAware, EnvironmentAware {
@Override
public void setEnvironment(Environment environment) {
// 可以讀取System properties|env 數據;系統參數
log.info(" >> >> > 從系統屬性中取值: {}", environment.getProperty("file.encoding") );
}
}
通過觀察SpringBoot啟動流程中,其中在SpringApplication的run方法中,可以看到系統環境屬性加載過程
ConfigurableEnvironment environment = prepareEnvironment(listeners, applicationArguments);
基于StandardEnvironment的擴展。
public class StandardEnvironment extends AbstractEnvironment {
public static final String SYSTEM_ENVIRONMENT_PROPERTY_SOURCE_NAME = "systemEnvironment";
public static final String SYSTEM_PROPERTIES_PROPERTY_SOURCE_NAME = "systemProperties";
@Override
protected void customizePropertySources(MutablePropertySources propertySources) {
propertySources.addLast(
new PropertiesPropertySource(SYSTEM_PROPERTIES_PROPERTY_SOURCE_NAME, getSystemProperties()));
propertySources.addLast(
new SystemEnvironmentPropertySource(SYSTEM_ENVIRONMENT_PROPERTY_SOURCE_NAME, getSystemEnvironment()));
}
}
我們看到的這樣的寫法其實就是基于SpEL對PropertySources的資源的解析:
@Value("#{systemProperties['file.encoding']}")
private String fileEncoding;
@Value("#{systemEnvironment['JAVA_HOME']}")
private String javaHome;
讀取配置順序
- 默認配置:Spring Boot 默認提供了一些基本的配置,如應用程序的端口號、上下文路徑等。這些配置位于 SpringBoot jar 包中的默認配置文件中。
- 用戶自定義配置:如果應用程序中有自定義的配置文件,Spring Boot 會首先加載這些文件。用戶可以通過在應用程序的 classpath 下放置一個名為 application.properties 或 application.yml 的文件來提供自定義配置。
- 命令行參數:在啟動應用程序時,可以通過命令行參數來傳遞配置。這些參數會被加載并覆蓋默認配置和用戶自定義配置。
- 環境變量:環境變量也可以提供配置信息。如果應用程序中定義了環境變量,它們將被加載并覆蓋默認配置、用戶自定義配置和命令行參數。
- 系統屬性:系統屬性也可以提供配置信息。如果應用程序中定義了系統屬性,它們將被加載并覆蓋默認配置、用戶自定義配置、命令行參數和環境變量。
Springboot會先加載PropertiesPropertySourceLoader,后加載YamlPropertySourceLoader,所以先讀取的是properties文件。
結束語
了解SpringBoot配置加載相關知識,可以有效解決配置項不生效問題以及需要快速修改配置項的情況。
需要注意的是,在加載多個配置文件時,如果有沖突的配置項,后加載的配置文件中的配置項將覆蓋先加載的配置文件中的相同配置項。因此,在應用程序中,應該避免使用相同的配置項名來定義不同的配置值。
-
文件
+關注
關注
1文章
578瀏覽量
25250 -
端口
+關注
關注
4文章
1046瀏覽量
32764 -
容器
+關注
關注
0文章
508瀏覽量
22387 -
應用程序
+關注
關注
38文章
3324瀏覽量
58813 -
spring
+關注
關注
0文章
340瀏覽量
14927
發布評論請先 登錄
啟動Spring Boot項目應用的三種方法
Spring Boot嵌入式Web容器原理是什么
Spring Boot從零入門1 詳述
「Spring認證」什么是Spring GraphQL?

Spring Boot特有的實踐
強大的Spring Boot 3.0要來了
Spring Boot Web相關的基礎知識
簡述Spring Boot數據校驗
Spring Boot時配置JSON序列化選項的幾種方法
Spring Boot Actuator快速入門
Spring Boot啟動 Eureka流程

Spring Boot的啟動原理

評論