Picocli：如何在父命令和子命令之间共享选项

Question

如何支持所有（或部分）命令和子命令的共享选项？例如，如果最终用户在命令行参数的任何位置提供--stacktrace，则打印的任何错误都将包括堆栈跟踪。

我们可以使用 Mixin 来定义布尔 --stacktrace 选项，并在所有（子）命令中包含此 Mixin，或者使用继承并让所有命令子类化定义布尔 --stacktrace 选项的类，但无论哪种方式，这将为每个命令定义一个单独的布尔选项。哪个选项为真取决于用户将--stacktrace 放在参数中的哪个位置，因此确定是否提供了--stacktrace 意味着遍历所有父命令并查看是否有任何为真。

如果有一种更方便的方法来检测用户是否指定了这样的共享选项，那就太好了。

（另见https://github.com/remkop/picocli/issues/580）

Answer 1

更新：使用 picocli 4.3 有两种方法可以完成此操作：

• inherited options
• 让子命令使用delegates to the parent 命令的mixin（因此选项修改的状态在一个地方）

---

实现此目的的一种方法是将布尔字段设为静态：

class Shared {
    @Option(names = "--stacktrace")
    static boolean stacktrace;
}

您仍然需要子类化或使用 mixin 在每个命令和子命令中定义此选项：

@Command(subcommands = {Subcommand1.class, Subcommand2.class /*, ...*/}
class MyCommand {
    @Mixin
    Shared shared = new Shared();

    // ...
}

@Command(name = "subcommand1")
class Subcommand1 {
    @Mixin
    Shared shared = new Shared();

    // ...
}

这种设计的好处是现在有一个地方可以让应用程序检测最终用户是否指定了--stacktrace：静态布尔字段：

public static void main(String... args) {
    assert Shared.stacktrace == false;

    MyCommand myCommand = new MyCommand();
    CommandLine.parseArgs(myCommand, "subcommand1", "--stacktrace");

    assert Shared.stacktrace == true;
}