1

当我在没有参数的情况下运行我的 CLI 应用程序时,我想自动显示帮助。我已经看到这个问题在 StackOverflow 上多次出现。我花了很多时间弄清楚这一点,我已经阅读了官方文档,查看了文章,但仍然不清楚如何实现这一点。

这就是我所拥有的:

主班

@Command(
        subcommands = {C1.class, C2.class}
)
public class HelloCli implements Callable<Integer>  {

    @Option(names = {"?", "-h", "--help"},
            usageHelp = true,
            description = "display this help message")
    boolean usageHelpRequested;

    @Override
    public Integer call() throws Exception {
        System.out.println("wanna show the help here");
        return 1;
    }

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

处理show-user函数的类:

@CommandLine.Command(name = "show-user",
                     aliases = "-show-user")
public class C1 implements Callable<Integer> {

    @CommandLine.Option(names = {"?", "-h", "--help"},
                        usageHelp = true,
                        description = "display this help message")
    boolean usageHelpRequested;

    @CommandLine.Option(names = {"-p1"},
                        description = "show-user: param 1")
    String  p1;

    @Override
    public Integer call() throws Exception {
        System.out.println("executing the 'show-user' business logic...");
        System.out.println("param 1: " + p1);
        return 4;
    }
}

处理create-user命令的类:

@CommandLine.Command(name = "create-user",
                     aliases = "-create-user")
public class C2  implements Callable<Integer> {

    @CommandLine.Option(names = {"?", "-h", "--help"},
                        usageHelp = true,
                        description = "display this help message")
    boolean usageHelpRequested;

    @CommandLine.Option(names = {"-p1"},
                        description = "create-user: another param 1")
    String  p1;

    @Override
    public Integer call() throws Exception {
        System.out.println("executing the 'create-user' business logic...");
        System.out.println("param 1: " + p1);
        return 5;
    }
}

案例1:当我调用这个应用程序时-h,帮助会正确显示:

Usage: <main class> [?] [COMMAND]
      ?, -h, --help   display this help message
Commands:
  show-user, -show-user
  create-user, -create-user

案例 2:显示第一个函数的帮助,调用show-user -h

Usage: <main class> show-user [?] [-p1=<p1>]
      ?, -h, --help   display this help message
      -p1=<p1>        show-user: param 1

案例 3:为第一个函数提供帮助,调用create-user -h

Usage: <main class> create-user [?] [-p1=<p1>]
      ?, -h, --help   display this help message
      -p1=<p1>        create-user: another param 1

案例 4:在没有参数的情况下调用我的应用程序显示:

wanna show the help here

我的问题很简单:

当我在没有参数 ( ) 的情况下运行 CLI 工具时如何显示帮助Case 4

我想我需要HelloCli.call()使用一个循环将自定义代码添加到方法中,该循环从实现这些功能的两个类中收集帮助文本。但不确定如何。对于这个流行的用例,我还没有找到任何示例代码。

我的附加问题与第一个问题类似:我能否以某种方式显示从Case 2和中的所有内容一起显示的全部帮助Case 3

4

1 回答 1

0

这在有关子命令的部分中进行了记录,使子命令成为必需

本质上,不要在顶级命令中实现 Callable 或 Runnable。这使得最终用户必须指定子命令。手册有一个例子。

关于你的第二个问题,如何自定义使用帮助信息,请看一下 picocli GitHub 项目的 picocli-examples 模块。很多示例都是关于自定义帮助的。例如,这个在顶级命令的使用帮助中显示了子命令(和子子命令)的完整层次结构。

于 2021-10-09T00:56:54.743 回答