Java参数如何解析

在 Java 中，“参数解析”通常指从命令行、配置文件或请求中解析参数。下面按常见场景给你一个系统性的说明。

一、命令行参数解析（最常见）

1️⃣ 使用 main 方法的 String[] args（最基础）

public class Main {
    public static void main(String[] args) {
        for (String arg : args) {
            System.out.println(arg);
        }
    }
}

运行：

java Main hello world --name=Tom

args 内容：

["hello", "world", "--name=Tom"]

✅ 优点：简单
❌ 缺点：需要自己解析格式，不适合复杂参数

2️⃣ Apache Commons CLI（推荐 ✅）

适合：传统命令行程序

依赖（Maven）

<dependency>
  <groupId>commons-cli</groupId>
  <artifactId>commons-cli</artifactId>
  <version>1.5.0</version>
</dependency>

示例

import org.apache.commons.cli.*;

public class CliDemo {
    public static void main(String[] args) throws Exception {
        Options options = new Options();
        options.addOption("h", "help", false, "打印帮助信息");
        options.addOption("n", "name", true, "姓名");

        CommandLineParser parser = new DefaultParser();
        CommandLine cmd = parser.parse(options, args);

        if (cmd.hasOption("h")) {
            new HelpFormatter().printHelp("java Main", options);
        }

        if (cmd.hasOption("n")) {
            System.out.println("name = " + cmd.getOptionValue("n"));
        }
    }
}

运行：

java Main -n Tom
java Main --name Tom

✅ 支持短参数、长参数、帮助信息
✅ 企业级常用

3️⃣ picocli（现代、最推荐 ✅✅）

适合：复杂 CLI 工具

依赖

<dependency>
  <groupId>info.picocli</groupId>
  <artifactId>picocli</artifactId>
  <version>4.7.5</version>
</dependency>

示例

import picocli.CommandLine;

@CommandLine.Command(name = "hello", mixinStandardHelpOptions = true)
public class Hello implements Runnable {

    @CommandLine.Option(names = {"-n", "--name"}, description = "姓名")
    String name;

    public void run() {
        System.out.println("Hello " + name);
    }

    public static void main(String[] args) {
        new CommandLine(new Hello()).execute(args);
    }
}

运行：

java Hello -n Tom
java Hello --name Tom

✅ 自动生成帮助
✅ 支持子命令、类型转换、校验
✅ 目前 Java CLI 首选

二、Spring Boot 参数解析

1️⃣ 命令行参数

java -jar app.jar --server.port=8081 --name=Tom

获取方式：

@Value("${name}")
private String name;

或

@ConfigurationProperties(prefix = "server")
public class ServerConfig {
    private int port;
}

2️⃣ 请求参数（Web）

GET 参数

@GetMapping("/test")
public String test(@RequestParam String name) {
    return name;
}

JSON 参数

@PostMapping("/test")
public String test(@RequestBody User user) {
    return user.getName();
}

三、配置文件参数解析

application.properties / yml

name=Tom
age=18

读取：

@Value("${name}")
private String name;

四、手动解析（不推荐）

for (String arg : args) {
    if (arg.startsWith("--name=")) {
        String name = arg.split("=")[1];
    }
}

❌ 易出错
❌ 可维护性差

五、如何选择？

如果你愿意，可以告诉我：

• ✅ 是 普通 Java 程序还是 Spring Boot
• ✅ 参数是 命令行 / HTTP / 配置文件
• ✅ 是否需要 子命令、必填参数、校验

我可以给你一个完全贴合你项目的示例。