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

Question

我遇到一种情况，我需要三个强制参数（field1、field2和 ）field3。然后我希望用户输入 a command name（强制，值可以是create、list等）。命令名称必须输入，并且必须是单数（只能是其中之一）可以输入它们）。

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

我尝试了以下操作，但出现错误：

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

听起来您想创建一个带有子命令的命令。您可以在 picocli 中通过使用注释标记方法或@Command创建单独的命令类并将其注册为父命令的子命令来执行此操作。如果您的子命令有很多选项，您可能需要为其创建一个单独的类。

创建子命令后，您需要调用用户指定的子命令的逻辑。您可以使用该CommandLine.parseArgs方法手动执行此操作，但这需要大量工作。我建议改用该CommandLine.execute方法。

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

该execute方法要求子命令是@Command- 注释的方法或@Command实现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...
    }
}