0 序言

一次沒搞懂，處處受影響。這個問題屬于基礎(chǔ)問題，但又經(jīng)常踩坑，不得不重視一下了。

1 Java程序動態(tài)參數(shù)的配置途徑：系統(tǒng)變量與JVM參數(shù)(VM Option) vs 環(huán)境變量 vs 啟動程序參數(shù)args

IDEA中的配置位置文章來源地址http://www.zghlxwxcb.cn/news/detail-476910.html

2 工具類：SystemVariableTool

import cn.xx.bd.xx.common.debug.Print;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.ApplicationArguments;
import org.springframework.boot.DefaultApplicationArguments;
import org.springframework.util.ObjectUtils;

import java.util.*;

/**
 * @author johnny-zen
 * @version v1.0
 * @create-time 2023/6/9 9:57
 * @description 系統(tǒng)屬性讀取工具
 *  [VM options]
 *      VM options其實(shí)就是我們在程序中需要的運(yùn)行時環(huán)境變量，它需要以-D或-X或-XX開頭，每個參數(shù)使用空格分隔
 *      使用最多的就是-Dkey=value設(shè)定系統(tǒng)屬性值，比如-Dspring.profiles.active=dev3
 *  [Program arguments]
 *      Program arguments為我們傳入main方法的字符串?dāng)?shù)組args[]，它通常以--開頭，如--spring.profiles.active=dev3
 *      等價于-Dspring.profiles.active=dev3如果同時存在，以Program arguments配置優(yōu)先
 * @refrence-doc
 * @gpt-promt
 */
public class SystemVariableTool {
    private final static Logger logger = LoggerFactory.getLogger(SystemVariableTool.class);

    public static final String SYSTEM_PROPERTY_PARAM = "SYSTEM_PROPERTY";

    public static final String ENVIRONMENT_VARIABLE_PARAM = "ENVIRONMENT_VARIABLE";

    /** args **/
    public static final String ARGS_PARAM = "ARGS_PARAM";
    // 可選參數(shù)
    public static final String OPTION_ARG_PARAM = "OPTION_ARG_VARIABLE";
    // 非可選參數(shù)
    public static final String NON_OPTION_ARG_PARAM = "NON_OPTION_ARG_PARAM";

    private ApplicationArguments applicationArguments;

    public SystemVariableTool(ApplicationArguments applicationArguments){
        this.applicationArguments = applicationArguments;
    }

    /**
     * 讀取系統(tǒng)屬性
     * @param propertyName
     * @config-method 配置方法
     *  1 ) IDEA - (Select one Program) - Edit Configurations - VM Options - ( "-Dserver.port=8088" / "-Xmx239m" )
     * @sample
     * server.port
     * -----------------------------
     * java.version Java 運(yùn)行時環(huán)境版本
     * java.vendor Java 運(yùn)行時環(huán)境供應(yīng)商
     * java.vendor.url Java 供應(yīng)商的 URL
     * java.home Java 安裝目錄
     * java.vm.specification.version Java 虛擬機(jī)規(guī)范版本
     * java.vm.specification.vendor Java 虛擬機(jī)規(guī)范供應(yīng)商
     * java.vm.specification.name Java 虛擬機(jī)規(guī)范名稱
     * java.vm.version Java 虛擬機(jī)實(shí)現(xiàn)版本
     * java.vm.vendor Java 虛擬機(jī)實(shí)現(xiàn)供應(yīng)商
     * java.vm.name Java 虛擬機(jī)實(shí)現(xiàn)名稱
     * java.specification.version Java 運(yùn)行時環(huán)境規(guī)范版本
     * java.specification.vendor Java 運(yùn)行時環(huán)境規(guī)范供應(yīng)商
     * java.specification.name Java 運(yùn)行時環(huán)境規(guī)范名稱
     * java.class.version Java 類格式版本號
     * java.class.path Java 類路徑
     * java.library.path 加載庫時搜索的路徑列表
     * java.io.tmpdir 默認(rèn)的臨時文件路徑
     * java.compiler 要使用的 JIT 編譯器的名稱
     * java.ext.dirs 一個或多個擴(kuò)展目錄的路徑
     * os.name 操作系統(tǒng)的名稱
     * os.arch 操作系統(tǒng)的架構(gòu) 例如: "amd64"
     * os.version 操作系統(tǒng)的版本 例如: "10.0"
     * file.separator 文件分隔符(在 UNIX 系統(tǒng)中是"/")
     * path.separator 路徑分隔符(在 UNIX 系統(tǒng)中是":")
     * line.separator 行分隔符(在 UNIX 系統(tǒng)中是"/n")
     * user.country 用戶所在國家
     * user.name 用戶的賬戶名稱
     * user.home 用戶的主目錄 例如: "C:\Users\Johnny"
     * user.dir 用戶的當(dāng)前工作目錄 例如: "E:\source_code\BigData\bdp_common_data_service"
     * user.language 用戶當(dāng)前的語言 例如: "zh"
     * user.timezone 用戶所在時區(qū) 例如: "Asia/Shanghai"
     * @return
     */
    public static String getSystemProperty(String propertyName){
        Map enviromentProperties = System.getProperties();
        return (String) enviromentProperties.get(propertyName);
    }

    /**
     * 讀取環(huán)境變量
     * @config-method 配置方式 :
     *  優(yōu)先級 : 方式1 < 方式2
     *  1) My Computer - 屬性 - 高級系統(tǒng)設(shè)置 - 環(huán)境變量 - ...
     *  2) IDEA - (Select one Program) - Edit Configurations - Environment Variables - ( ENV_VAR="env-var-demo" server.port=8090 ...)
     *
     * @sample
     * USERPROFILE        ：用戶目錄
     * USERDNSDOMAIN      ：用戶域
     * PATHEXT            ：可執(zhí)行后綴
     * JAVA_HOME          ：Java安裝目錄
     * TEMP               ：用戶臨時文件目錄
     * SystemDrive        ：系統(tǒng)盤符
     * ProgramFiles       ：默認(rèn)程序目錄
     * USERDOMAIN         ：帳戶的域的名稱
     * ALLUSERSPROFILE    ：用戶公共目錄
     * SESSIONNAME        ：Session名稱
     * TMP                ：臨時目錄
     * Path               ：path環(huán)境變量
     * CLASSPATH          ：classpath環(huán)境變量
     * PROCESSOR_ARCHITECTURE ：處理器體系結(jié)構(gòu)
     * OS                     ：操作系統(tǒng)類型
     * PROCESSOR_LEVEL    ：處理級別
     * COMPUTERNAME       ：計(jì)算機(jī)名
     * Windir             ：系統(tǒng)安裝目錄
     * SystemRoot         ：系統(tǒng)啟動目錄
     * USERNAME           ：用戶名
     * ComSpec            ：命令行解釋器可執(zhí)行程序的準(zhǔn)確路徑
     * APPDATA            ：應(yīng)用程序數(shù)據(jù)目錄
     * @return
     */
    public static String getEnvironmentVariable(String variableName){
        Map enviromentProperties = System.getenv();
        return (String) enviromentProperties.get(variableName);
    }

    public Map<String, Object> getVariables(String variableName){
        Map<String, Object> resultMap = new HashMap<>();
        String systemProperty = getSystemProperty(variableName);
        resultMap.put(SYSTEM_PROPERTY_PARAM, systemProperty);

        String environmentVariable = getEnvironmentVariable(variableName);
        resultMap.put(ENVIRONMENT_VARIABLE_PARAM, environmentVariable);

        //解析 args
        String argsValue = null;
        String[] args = applicationArguments.getSourceArgs();
        if(!ObjectUtils.isEmpty(args)){
            for(int i = 0; i < args.length; i++){
                if(args[i].toLowerCase().contains(variableName.toLowerCase())){
                    argsValue = args[i];
                }
            }
        }
        resultMap.put(ARGS_PARAM, argsValue);
        /**
         * 解析選項(xiàng)參數(shù)
         * @description
         *  1. 不同框架 對 args 的解析策略均不同。例如 Flink 的 ParameterTool 與 SpringBoot 的 DefaultApplicationArguments，解析規(guī)則和解析結(jié)果有很大差異
         *  1. 基于 SpringBoot 的 ApplicationArguments 接口, DefaultApplicationArguments 。 如果是以”--“為前綴，則判定為選項(xiàng)參數(shù);反之，被判定為 非選項(xiàng)參數(shù)
         * @sample
         * [1] 選項(xiàng)參數(shù)的有效示例
         *  --foo
         *  --foo=
         *  --foo=""
         *  --foo=bar
         *  --foo="bar then baz"
         *  --foo=bar,baz,biz
         * [2] 選項(xiàng)參數(shù)的無效示例
         *  -foo
         *  --foo bar
         *  --foo = bar
         *  --foo=bar --foo=baz --foo=biz
         */
        List<String> optionArgs = applicationArguments.getOptionValues(variableName);// args = { "--foo="bar then baz" } , variableName = "foo" => optionArgs = {"bar then baz"}
        resultMap.put(OPTION_ARG_PARAM, optionArgs);

        List<String> allNonOptionArgs = applicationArguments.getNonOptionArgs();// { "server.port=8089" , "server.port=8090", "boo=bar,then,baz" , "foo=bar then baz" }
        List<String> nonOptionArgs = new ArrayList<>();
        for(int i=0;i<allNonOptionArgs.size();i++){
            if(allNonOptionArgs.get(i).toLowerCase().contains(variableName.toLowerCase())){
                nonOptionArgs.add( allNonOptionArgs.get(i) );
            }
        }
        resultMap.put(NON_OPTION_ARG_PARAM, nonOptionArgs);
        return resultMap;
    }

    public static void main(String[] args) {
        ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
        SystemVariableTool systemPropertiesUtil = new SystemVariableTool(applicationArguments);
        Map<String, Object> map = systemPropertiesUtil.getVariables("server.port");
        Print.print(map);
    }
}

X 參考文獻(xiàn)

• Java中System.getProperty()的作用及使用 - CSDN
• Idea中的VM Options、Program Arguments、Environment Variable全解析 - CSDN
• java 獲取系統(tǒng)變量(環(huán)境變量和設(shè)置變量) - CSDN
• idea為java程序添加啟動參數(shù)（program arguments，vm arguments，Environment variable），并在程序中獲取使用 - CSDN
• 【Flink】關(guān)于ParameterTool - CSDN
• 如何使用 Flink ParameterTool 讀取配置 - CSDN

到了這里，關(guān)于[Java SE] 徹底搞懂Java程序的三大參數(shù)配置途徑：系統(tǒng)變量與JVM參數(shù)(VM Option)/環(huán)境變量/啟動程序參數(shù)args的文章就介紹完了。如果您還想了解更多內(nèi)容，請?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！