使用 Picocli，我如何需要一个位置参数，然后根据位置参数的值选择可选参数

Question

我有一种情况需要三个强制参数（field1、field2 和 field3。然后我希望用户输入 command name（ mandatory, values can be create, list, etc. 命令名称必须输入，并且必须是单数（只能输入其中一个）。

有些命令会有参数，有些则没有。我该如何处理？

我尝试了以下方法，但出现错误：

ArgGroup has no options or positional parameters, and no subgroups

public class CliParserArgs {
    @Option(names = {"--field1"}, required = true)
    private String field1;

    @Option(names = {"--field2"}, required = true)
    String field2;

    @Option(names={"--field3"}, required = true)
    String field3;

    @Option(names = {"-h", "--help"}, usageHelp = true) boolean help;

    class Create {
        private final String val;
        public Create(final String val) {
            this.val = val;
        }
    }

    class ListObjects {
        private final String val;
        public ListObjects(final String val) {
            this.val = val;
        }
    }

    @ArgGroup(heading = "Command", exclusive = true, multiplicity = "1")
    Create create;
    ListObjects listObjects;

    public static void main(String[] args) {
        CliParserArgs cliParserArgs = new CliParserArgs();
        CommandLine cmd = new CommandLine(cliParserArgs);
        CommandLine.ParseResult parseResult = cmd.parseArgs(args);
        System.err.println("parse results: " + parseResult.matchedArgs().toString());

        try {
        if (cmd.isUsageHelpRequested()) {
            cmd.usage(System.out);
        }
        } catch (CommandLine.ParameterException e) {
            System.err.println("error: " + e.getMessage());
            System.err.println(e.getStackTrace());

        }
    }
}

Answer 1

听起来您想用父命令的 subcommands. You can do this in picocli by either marking a method with the @Command annotation or by creating a separate command class and registering it as a subcommand 创建一个命令。如果你的子命令有很多选项，你可能想为它创建一个单独的 class。

创建子命令后，您希望调用用户指定的子命令的逻辑。您可以使用 CommandLine.parseArgs 方法手动执行此操作，但这是 lot of work. I would recommend using the CommandLine.execute method。

execute方法会解析用户输入，处理--help和--version请求，处理无效的用户输入，最后（如果用户输入有效）调用业务用户指定的子命令的逻辑。它还将 return 一个退出代码。

execute 方法要求子命令是 @Command 注释方法或 @Command 注释 class 实现 Runnable 或 Callable.

下面是一个基于您的示例代码的示例，作为子命令实现。

@Command(name = "cli", version = "1.0",
    mixinStandardHelpOptions = true,
    subcommands = {Create.class, ListObjects.class})
public class Cli implements Runnable {
    @Option(names = {"--field1"}, required = true)
    private String field1;

    @Option(names = {"--field2"}, required = true)
    String field2;

    @Option(names={"--field3"}, required = true)
    String field3;

    // not needed because we have mixinStandardHelpOptions=true
    //@Option(names = {"-h", "--help"}, usageHelp = true) boolean help;

    public void run() {
        // business logic of the top-level cmd here
        System.out.println("hi, field1="+field1);
    }

    public static void main(String[] args) {
        int exitCode = new CommandLine(new Cli()).execute(args);
        System.exit(exitCode);
    }
}

@Command(name = "create", description = "create ...",
        mixinStandardHelpOptions = true, version = "1.0")
class Create implements Callable<Integer> {
    @Option(names = {"-x", "--times"}, description = "...")
    int x;

    @Override
    public Integer call() {
        // business logic for "create" here...
        return ok ? 0 : 1; // exit code support
    }
}

@Command(name = "list", description = "create ...",
        mixinStandardHelpOptions = true, version = "1.0")
class ListObjects implements Runnable {
    @Option(names = {"-x", "--times"}, description = "...")
    int x;

    @Override
    public void run() {
        // business logic for "list" here...
    }
}

使用 Picocli，我如何需要一个位置参数，然后根据位置参数的值选择可选参数

Using Picocli, how do I require a positional argument and then optional arguments depending on the value of the positional argument

java

command-line-arguments

picocli