SPRING BOOT啟動命令參數及源碼詳析
前言
使用過Spring Boot，我們都知道通過java -jar可以快速啟動Spring Boot項目。同時，也可以通過在執(zhí)行jar -jar時傳遞參數來進行配置。本文帶大家系統(tǒng)的了解一下Spring Boot命令行參數相關的功能及相關源碼分析。
命令行參數使用
啟動Spring Boot項目時，我們可以通過如下方式傳遞參數：
java -jar xxx.jar --server.port=8081
默認情況下Spring Boot使用8080端口，通過上述參數將其修改為8081端口，而且通過命令行傳遞的參數具有更高的優(yōu)先級，會覆蓋同名的其他配置參數。
啟動Spring Boot項目時傳遞參數，有三種參數形式：
- 選項參數
- 非選項參數
- 系統(tǒng)參數
選項參數，上面的示例便是選項參數的使用方法，通過“–-server.port”來設置應用程序的端口?；靖袷綖椤皑Cname=value”（“–”為連續(xù)兩個減號）。其配置作用等價于在application.properties中配置的server.port=8081。
非選項參數的使用示例如下：
java -jar xxx.jar abc def
上述示例中，“abc”和“def”便是非選項參數。
系統(tǒng)參數，該參數會被設置到系統(tǒng)變量中，使用示例如下：
java -jar -Dserver.port=8081 xxx.jar
參數值的獲取
選項參數和非選項參數均可以通過ApplicationArguments接口獲取，具體獲取方法直接在使用參數的類中注入該接口即可。
@RestController
public class ArgumentsController {
@Resource
private ApplicationArguments arguments;
}
通過ApplicationArguments接口提供的方法即可獲得對應的參數。關于該接口后面會詳細講解。
另外，選項參數，也可以直接通過@Value在類中獲取，如下：
@RestController
public class ParamController {
@Value("${server.port}")
private String serverPort;
}
系統(tǒng)參數可以通過java.lang.System提供的方法獲?。?/p>
String systemServerPort = System.getProperty("server.port");
參數值的區(qū)別
關于參數值區(qū)別，重點看選項參數和系統(tǒng)參數。通過上面的示例我們已經發(fā)現使用選項參數時，參數在命令中是位于xxx.jar之后傳遞的，而系統(tǒng)參數是緊隨java -jar之后。
如果不按照該順序進行執(zhí)行，比如使用如下方式使用選項參數：
java -jar --server.port=8081 xxx.jar
則會拋出如下異常：
Unrecognized option: --server.port=8081
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.
如果將系統(tǒng)參數放在jar包后面，問題會更嚴重。會出現可以正常啟動，但參數無法生效。這也是為什么有時候明明傳遞了參數但是卻未生效，那很可能是因為把參數的位置寫錯了。
這個錯誤是最坑的，所以一定謹記：通過-D傳遞系統(tǒng)參數時，務必放置在待執(zhí)行的jar包之前。
另外一個重要的不同是：通過@Value形式可以獲得系統(tǒng)參數和選項參數，但通過System.getProperty方法只能獲得系統(tǒng)參數。
ApplicationArguments解析
上面提到了可以通過注入ApplicationArguments接口獲得相關參數，下面看一下具體的使用示例：
@RestController
public class ArgumentsController {
@Resource
private ApplicationArguments arguments;
@GetMapping("/args")
public String getArgs() {
System.out.println("# 非選項參數數量: " + arguments.getNonOptionArgs().size());
System.out.println("# 選項參數數量: " + arguments.getOptionNames().size());
System.out.println("# 非選項具體參數:");
arguments.getNonOptionArgs().forEach(System.out::println);
System.out.println("# 選項參數具體參數:");
arguments.getOptionNames().forEach(optionName -> {
System.out.println("--" + optionName + "=" + arguments.getOptionValues(optionName));
});
return "success";
}
}
通過注入ApplicationArguments接口，然后在方法中調用該接口的方法即可獲得對應的參數信息。
ApplicationArguments接口中封裝了啟動時原始參數的數組、選項參數的列表、非選項參數的列表以及選項參數獲得和檢驗。相關源碼如下：
public interface ApplicationArguments {
/**
* 原始參數數組（未經過處理的參數）
*/
String[] getSourceArgs();
/**
* 選項參數名稱
*/
Set<String> getOptionNames();
/**
* 根據名稱校驗是否包含選項參數
*/
boolean containsOption(String name);
/**
* 根據名稱獲得選項參數
*/
List<String> getOptionValues(String name);
/**
* 獲取非選項參數列表
*/
List<String> getNonOptionArgs();
}
命令行參數的解析
上面直接使用了ApplicationArguments的注入和方法，那么它的對象是何時被創(chuàng)建，何時被注入Spring容器的？
在執(zhí)行SpringApplication的run方法的過程中會獲得傳入的參數，并封裝為ApplicationArguments對象。相關源代碼如下：
public ConfigurableApplicationContext run(String... args) {
try {
ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
// ...
prepareContext(context, environment, listeners, // ...
} catch (Throwable ex) {
// ...
}
return context;
}
在上述代碼中，通過創(chuàng)建一個它的實現類DefaultApplicationArguments來完成命令行參數的解析。
DefaultApplicationArguments部分代碼如下：
public class DefaultApplicationArguments implements ApplicationArguments {
private final Source source;
private final String[] args;
public DefaultApplicationArguments(String... args) {
Assert.notNull(args, "Args must not be null");
this.source = new Source(args);
this.args = args;
}
// ...
@Override
public List<String> getOptionValues(String name) {
List<String> values = this.source.getOptionValues(name);
return (values != null) ? Collections.unmodifiableList(values) : null;
}
private static class Source extends SimpleCommandLinePropertySource {
Source(String[] args) {
super(args);
}
// ...
}
}
通過構造方法，將args賦值給成員變量args，其中接口ApplicationArguments中getSourceArgs方法的實現在該類中便是返回args值。
針對成員變量Source（內部類）的設置，在創(chuàng)建Source對象時調用了其父類SimpleCommandLinePropertySource的構造方法：
public SimpleCommandLinePropertySource(String... args) {
super(new SimpleCommandLineArgsParser().parse(args));
}
在該方法中創(chuàng)建了真正的解析器SimpleCommandLineArgsParser并調用其parse方法對參數進行解析。
class SimpleCommandLineArgsParser {
public CommandLineArgs parse(String... args) {
CommandLineArgs commandLineArgs = new CommandLineArgs();
for (String arg : args) {
// --開頭的選參數解析
if (arg.startsWith("--")) {
// 獲得key=value或key值
String optionText = arg.substring(2, arg.length());
String optionName;
String optionValue = null;
// 如果是key=value格式則進行解析
if (optionText.contains("=")) {
optionName = optionText.substring(0, optionText.indexOf('='));
optionValue = optionText.substring(optionText.indexOf('=')+1, optionText.length());
} else {
// 如果是僅有key（--foo）則獲取其值
optionName = optionText;
}
// 如果optionName為空或者optionValue不為空但optionName為空則拋出異常
if (optionName.isEmpty() || (optionValue != null && optionValue.isEmpty())) {
throw new IllegalArgumentException("Invalid argument syntax: " + arg);
}
// 封裝入CommandLineArgs
commandLineArgs.addOptionArg(optionName, optionValue);
} else {
commandLineArgs.addNonOptionArg(arg);
}
}
return commandLineArgs;
}
}
上述解析規(guī)則比較簡單，就是根據“–”和“=”來區(qū)分和解析不同的參數類型。
通過上面的方法創(chuàng)建了ApplicationArguments的實現類的對象，但此刻還并未注入Spring容器，注入Spring容器是依舊是通過上述SpringApplication#run方法中調用的prepareContext方法來完成的。相關代碼如下：
private void prepareContext(ConfigurableApplicationContext context, ConfigurableEnvironment environment,
SpringApplicationRunListeners listeners, ApplicationArguments applicationArguments, Banner printedBanner) {
// ...
ConfigurableListableBeanFactory beanFactory = context.getBeanFactory();
// 通過beanFactory將ApplicationArguments的對象注入Spring容器
beanFactory.registerSingleton("springApplicationArguments", applicationArguments);
// ...
}
至此，關于Spring Boot中ApplicationArguments的相關源碼解析完成。
總結
以上就是這篇文章的全部內容了，希望本文的內容對大家的學習或者工作具有一定的參考學習價值，謝謝大家對腳本之家的支持。
相關文章
這篇文章主要介紹了Java安全后端返回文件流方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2023-07-07
Springboot Mybatis-Plus數據庫單元測試實戰(zhàn)(三種方式)
這篇文章主要介紹了Springboot Mybatis-Plus數據庫單元測試實戰(zhàn)(三種方式),文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2020-12-12
Spring?Boot獲取resources目錄下的文件三種方式詳解
在Spring?Boot項目中，經常需要獲取resources目錄下的文件，這些文件可以包括配置文件、模板文件、靜態(tài)資源等，這篇文章主要介紹了Spring?Boot獲取resources目錄下的文件的三種方式,需要的朋友可以參考下2023-06-06
面向對象的第三個特征是多態(tài)，實現多態(tài)有三個必要條件：繼承、方法重寫和向上轉型，在學習多態(tài)之前，我們還要先學習Java的類型轉換，本篇文章就來帶大家認識什么是類型轉換，看看類型轉換都有哪幾種情況，以及如何避免類型轉換時出現異常2023-05-05
這篇文章主要介紹了Java 讀取類路徑下的資源文件實現代碼的相關資料,主要實現工具類代碼ResourceLoadUtil.java的實例需要的朋友可以參考下2017-07-07
Java中Stringbuild,Date和Calendar類的用法詳解
這篇文章主要為大家詳細介紹了Java中Stringbuild、Date和Calendar類的用法，文中的示例代碼講解詳細，感興趣的小伙伴可以跟隨小編一起了解一下2023-04-04
這篇文章主要介紹了Mybatis批量更新報錯的問題及解決辦法，包括mybatis批量更新的兩種方式，需要的的朋友參考下2017-01-01
SpringBoot2.0整合SpringCloud Finchley @hystrixcommand注解找不到解決方案
這篇文章主要介紹了SpringBoot2.0整合SpringCloud Finchley @hystrixcommand注解找不到解決方案，小編覺得挺不錯的，現在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-08-08
springboot?log4j2.xml如何讀取application.yml中屬性值
這篇文章主要介紹了springboot?log4j2.xml如何讀取application.yml中屬性值問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-12-12
這篇文章主要為大家詳細介紹了Java實現快速并查集，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2020-07-07