使用JCommander开发命令行交互(CLI)式JAVA程序

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/u013128262/article/details/84556077

一、前言

最近在看pulsar源码时,发现他们使用了JCommander来开发命令行交互程序,便对这个framework产生了兴趣。 传统意义上讲,JAVA并不是开发命令行程序最合适的语言,但是因为依赖一些特定JAVA库(特别是大数据相关的)的CLI程序,用java来开发却是最方便的。

二、常见的linux命令行风格

首先我们先了解下常见的linux命令行风格:

  • Unix 风格参数,前面加单破折线 -
  • BSD 风格参数,前面不加破折线
  • GNU 风格参数,前面加双破折线 –
  • JAVA 风格参数

Unix风格

Unix是从贝尔实验室开发的AT&T Unix系统上原有的命令继承下来的。

ls -a
ls -lah

-后面可以跟多个字母,多个字母就是多个参数

BSD风格

ps aux

参数不带-

GNU风格

两个减号 – 加参数,一般后边的参数是跟上一个单词或短语

ps --no-headers

当然Unix和GUN风格很多混用,如ls -a 等于ls --all,-h 往往对应 --help

JAVA风格

比如java的命令行,-后面直接是单词

java -version

java -Djava.awt.headless=true -Djava.net.useSystemProxies=true Foo

三、JCommander

快速入门

首先我们看下官方的demo快速入门

java源程序

public class JCommanderTest {
    @Parameter
    public List<String> parameters = Lists.newArrayList();
 
    @Parameter(names = { "-log", "-verbose" }, description = "Level of verbosity")
    public Integer verbose = 1;
 
    @Parameter(names = "-groups", description = "Comma-separated list of group names to be run")
    public String groups;
 
    @Parameter(names = "-debug", description = "Debug mode")
    public boolean debug = false;

    @DynamicParameter(names = "-D", description = "Dynamic parameters go here")
    public Map<String, String> dynamicParams = new HashMap<String, String>();

}

所以我们这样调用

JCommanderTest jct = new JCommanderTest();
String[] argv = { "-log", "2", "-groups", "unit1,unit2,unit3",
                    "-debug", "-Doption=value", "a", "b", "c" };
JCommander.newBuilder()
  .addObject(jct)
  .build()
  .parse(argv);

Assert.assertEquals(2, jct.verbose.intValue());
Assert.assertEquals("unit1,unit2,unit3", jct.groups);
Assert.assertEquals(true, jct.debug);
Assert.assertEquals("value", jct.dynamicParams.get("option"));
Assert.assertEquals(Arrays.asList("a", "b", "c"), jct.parameters);

不难发现,JCommander有如下几个特点:

  • 注解驱动:@DynamicParameter(names = “-D”, description = “Dynamic parameters go here”) 一个类似注解(装饰)轻松做到命令行参数与属性的映射
  • 功能强大:支持多种风格,并可自动生成文档
  • 拓展性强

Jcommander属性值

  • names 设置命令行参数,如-old
  • required 设置此参数是否必须
  • description 设置参数的描述
  • order 设置帮助文档的顺序
  • help 设置此参数是否为展示帮助文档或者辅助功能

其中help最为强大,如demo

    @Parameter(names = "--help", help = true, order = 5)
    private boolean help;

则如下使用即可生成完善的文档

        if (help) {
            jCommander.usage();
            return;
        }
Usage: <main class> [options]
  Options:
    --help

    -debug
      Debug mode
      Default: true
    -host
      The host
      Default: []
    -password
      Connection password

密码类参数处理

在实际程序中,我们往往会遇到很多类似要输入密码的场景。此时我们并不希望密码出现在history中,你可以使用password这种类型,这样JCommander会让你在console中输入。

public class ArgsPassword {
  @Parameter(names = "-password", description = "Connection password", password = true)
  private String password;
}

正则表达式校验

当用户产生于预期不一致的输入时,我们希望便捷地使用正则表达式来校验这些值。

@Parameter(names = "-v",  validateWith = RegexValidator.class)
@Regex("(2\\.0|1\\.0)")
private String version = "2.0";

其他

当然我们还可以使用Apache Commons CLI实现相关功能

四、参考

文章首发云+ 社区:https://cloud.tencent.com/developer/article/1366912

阅读更多

没有更多推荐了,返回首页