|
| 1 | +--- |
| 2 | +layout: post |
| 3 | +title: "Apache Commons CLI 使用说明 " |
| 4 | +subtitle: "信息、载体、抽象、线程 设计乱谈" |
| 5 | +date: 2019-10-15 |
| 6 | +author: "LSG" |
| 7 | +header-img: "img/home-bg-o.jpg" |
| 8 | +catalog: true |
| 9 | +tags: |
| 10 | + - shell |
| 11 | + - Commons-CLI |
| 12 | + - java |
| 13 | +--- |
| 14 | + |
| 15 | +> Apache Commons CLI 提供了很多实用的工具和类实现,方便了我们对命令行工具的开发。 |
| 16 | +
|
| 17 | +### 1.Commons-CLI 介绍 |
| 18 | + |
| 19 | +> 随着科学计算可视化飞速发展,人机交互技术不断更新,但传统的命令行模式依旧被广泛应用。 |
| 20 | +
|
| 21 | +Commons-CLI依旧广泛应用的原因是命令行界面要较图形用户界面节约更多的计算机系统资源,利于客户进行二次开发,方便应用程序的整合。 |
| 22 | + |
| 23 | +### 2.简单使用 |
| 24 | + |
| 25 | +```java |
| 26 | +private static Config parseCmdLine(String[] args) { |
| 27 | +// 1.CLI 定义阶段 |
| 28 | + initOpt(); |
| 29 | +// 2.CLI 解析阶段 |
| 30 | + // 初始化一个命令行解析器,一般用默认的就可以 |
| 31 | + CommandLineParser parser = new DefaultParser(); |
| 32 | + Config config = new Config(); |
| 33 | + try { |
| 34 | + // 解析后会得到一个 CommandLine 对象 |
| 35 | + CommandLine cmd = parser.parse(options, args); |
| 36 | + config = new Config(); |
| 37 | +// 3.CLI 询问阶段 |
| 38 | + // 获取选项 -c 的参数值,如果没有则使用第二个参数所指定的默认值 |
| 39 | + config.ssdbConfigPath = cmd.getOptionValue("c", "./ssdb.cfg"); |
| 40 | + // 判断选项 -rm 是否存在,返回的是 boolean 值 |
| 41 | + if (cmd.hasOption("rm")) { |
| 42 | + config.operation = Operation.rm; |
| 43 | + } |
| 44 | + else if (cmd.hasOption("disable")) { |
| 45 | + config.operation = Operation.disable; |
| 46 | + } |
| 47 | + else if (cmd.hasOption("get")) { |
| 48 | + config.operation = Operation.get; |
| 49 | + } |
| 50 | + else if (cmd.hasOption("mv")) { |
| 51 | + config.operation = Operation.mv; |
| 52 | + } |
| 53 | + else { |
| 54 | + config.operation = Operation.unknown; |
| 55 | + } |
| 56 | + } catch (ParseException e) { |
| 57 | + System.out.println(e.getMessage()); |
| 58 | + // 解析失败是用 HelpFormatter 打印 帮助信息 |
| 59 | + HelpFormatter formatter = new HelpFormatter(); |
| 60 | + formatter.printHelp( |
| 61 | + "java ssdb-del-helper-1.0-SNAPSHOT-jar-with-dependencies.jar", |
| 62 | + options); |
| 63 | + } |
| 64 | + return config; |
| 65 | +} |
| 66 | + |
| 67 | +private static Config initOpt(String[] args) { |
| 68 | +// 定义一个可选选项集 |
| 69 | + Options options = new Options(); |
| 70 | + // 添加一个选项 c ,并加上对应的简短说明,第二个参数表明这个选项是否跟有参数 |
| 71 | + options.addOption("c", true, "configOpt file, default path is ./ssdb.cfg"); |
| 72 | + |
| 73 | + // 定义一个选项组,这个组限定其所包含的选项是互斥的 |
| 74 | + OptionGroup optionGroup = new OptionGroup(); |
| 75 | + // 这里的 Option 方法只有两个参数,表明这个命令行选项不带参数 |
| 76 | + optionGroup.addOption(new Option("rm", "remove K/V from ssdb")); |
| 77 | + optionGroup.addOption(new Option("disable", "disable K/V from ssdb with data remained")); |
| 78 | + optionGroup.addOption(new Option("get", "get value from ssdb")); |
| 79 | + optionGroup.addOption(new Option("mv", "mv from new client to old")); |
| 80 | + // 设定此选项组是必选的,从而实现上面 4 个选项必须且只能选择一个 |
| 81 | + optionGroup.setRequired(true); |
| 82 | + options.addOptionGroup(optionGroup); |
| 83 | +} |
| 84 | + |
| 85 | +private static class Config { |
| 86 | + String ssdbConfigPath; |
| 87 | + Operation operation = Operation.unknown; |
| 88 | +} |
| 89 | +``` |
| 90 | + |
| 91 | +### 3.设计思想 |
| 92 | +#### 3.1 CLI 定义阶段 |
| 93 | +初始化Options: |
| 94 | + |
| 95 | +- CLI 定义阶段的目标结果就是创建 Options 实例 |
| 96 | + |
| 97 | +代码片段: |
| 98 | +```java |
| 99 | +// 创建 Options 对象 |
| 100 | +Options options = new Options(); |
| 101 | + |
| 102 | +// 添加 -h 参数 |
| 103 | +options.addOption("h", false, "Lists short help"); |
| 104 | + |
| 105 | +// 添加 -t 参数 |
| 106 | +options.addOption("t", true, "Sets the HTTP communication protocol for CIM connection"); |
| 107 | +``` |
| 108 | + |
| 109 | +#### 3.2 CLI 解析阶段 |
| 110 | +创建 CommandLine 实例: |
| 111 | + |
| 112 | +- 在 CommandLineParser 类中定义的 parse 方法将用 CLI 定义阶段中产生的 Options 实例和一组字符串作为输入,并返回解析后生成的 CommandLine。 |
| 113 | + |
| 114 | +代码片段: |
| 115 | +```java |
| 116 | +CommandLineParser parser = new PosixParser(); |
| 117 | +CommandLine cmd = parser.parse(options, args); |
| 118 | + |
| 119 | +if(cmd.hasOption("h")) { |
| 120 | + // 这里显示简短的帮助信息 |
| 121 | +} |
| 122 | +``` |
| 123 | + |
| 124 | +#### 3.3 CLI 询问阶段 |
| 125 | +通过查询 CommandLine,应用程序做出对应的判断: |
| 126 | + |
| 127 | +- 将所有通过命令行以及处理参数过程中得到的文本信息传递给用户的代码。 |
| 128 | + |
| 129 | +代码片段: |
| 130 | +```java |
| 131 | +// 获取 -t 参数值 |
| 132 | +String protocol = cmd.getOptionValue("t"); |
| 133 | + |
| 134 | +if(protocol == null) { |
| 135 | + // 设置默认的 HTTP 传输协议 |
| 136 | +} else { |
| 137 | +// 设置用户自定义的 HTTP 传输协议 |
| 138 | +} |
| 139 | +``` |
| 140 | + |
| 141 | +### 4.流程图 |
| 142 | + |
| 143 | +命令行执行流程图 |
| 144 | +### Reference |
| 145 | + |
| 146 | +- [Java Commons-CLI 命令行参数解析](https://www.zfl9.com/java-commons-cli.html) |
| 147 | +- [简书: java 使用 commons-cli 实现命令行参数](https://www.jianshu.com/p/cf325454be07) |
| 148 | +- [IBM: 使用 Apache Commons CLI 开发命令行工具](https://www.ibm.com/developerworks/cn/java/j-lo-commonscli/) |
0 commit comments