Java命令行界面（第17部分）：jw-options

JavaWorld文章处理Java中的命令行参数： Matthias Laux博士关闭的案例介绍了一个基于Java的简单库，用于处理命令行参数，在本文中我将其称为jw-options 。被引用的文章提供了有关为何在构造Options类时做出某些设计决策的背景信息。本文的“结论”描述了使用附带的类和库的优点：“本文描述了一个Java类，该类允许方便地处理Java程序的命令行选项。该结构足够灵活，甚至可以处理复杂的情况，同时提供了API，可以用有限的编码工作来定义可接受的命令行语法。

此JavaWorld文章介绍的“库”包含三个Java类： Options ， OptionData和OptionSet 。下面的屏幕快照演示了这一点，该屏幕快照显示了options.jar的内容。

带有“ jw-options”的“定义”阶段是通过其Options和OptionSet类实现的。下一个代码清单中对此进行了演示（完整的代码清单可在GitHub上找到，并且此处的示例类似于本系列先前文章中使用的示例）。

带有jw-options的“定义”阶段

final Options options = new Options(arguments, Multiplicity.ZERO_OR_ONE);
final OptionSet defaultOptions = options.getSet();
defaultOptions.addOption("f", false, Separator.BLANK, Multiplicity.ONCE);
defaultOptions.addOption("v", Multiplicity.ZERO_OR_ONE);

刚刚显示的代码清单演示了如何使用几个OptionSet的重载addOption方法。为了设置文件路径和名称（ -f ）选项，将调用四参数版本，其中包含标志的单字母（f），标志与其参数之间的分隔符（空格）以及应当预期标志的次数（恰好发生一次）。冗长性的第二个参数（-v）通过调用addOption的两个参数版本来addOption ，该版本指定标志的字符（v）及其预期出现的次数（零出现或单出现）。

通过调用Options的check方法，可以在“ jw-options”中实现“解析”阶段。顾名思义，此方法也可用于检查参数的准确性。下一个代码清单对此进行了演示。

使用jw-options的“解析”阶段

if (!options.check(false, false))
{out.println("ERROR: " + options.getCheckErrors());System.exit(-1);
}

在刚刚显示的“解析”示例中，使用了Options类的方法getCheckErrors()来访问解析后的参数中的错误，这些错误导致Options.check方法返回false 。

下一个代码清单中演示了带有“ jw-options”的“询问”阶段。

jw-options的“审讯”阶段

out.println("File path/name is " + defaultOptions.getOption("f").getResultValue(0));
out.println("Verbosity is set to " + defaultOptions.isSet("v"));

“询问”示例演示了如何使用OptionSet的getOption方法访问表示“ -f”选项的选项，然后调用其getResultValue(0)方法访问与该“ -f”关联的第一个（也是在这种情况下）值”标志。该示例的第二行仅通过使用OptionSet的方法isSet查询是否已指定“ -v”标志（并且不必担心或期望与该标志关联的值）。

接下来显示一个屏幕快照，以演示到目前为止显示的使用“ jw-options”的代码。该图显示了未提供预期的命令行参数时报告的消息，并以两个示例按预期使用命令行标志结尾。

选择框架或库来帮助Java进行命令行解析时，要考虑“ jw-options”的特征。

“ jw-options”“库”是开放源代码，因为它的源代码已在JavaWorld文章“ 在Java中处理命令行参数：关闭案例且源代码包含在JAR中可供下载 ”中进行了全面介绍和讨论。作为jw-0816-command.zip ZIP文件。” 但是，该“图书馆”的许可证并不明显。
“ jw-options”库很小： options.jar文件的大小约为13 KB。
据我所知，没有办法用“ jw-options”用双连字符指定“长”标志名。
在“ jw-options” jar中的类上运行的javap命令显示“ main version：49 ”，这意味着它是针对J2SE 5编译的，并且可以与运行于J2SE 5的 Java上的应用程序一起使用（我注意到在Java中使用StringBuffer代码在StringBuilder也可以正常工作）。

这篇文章中讨论的“ jw-options”“库”最有可能引起那些需要将命令行处理库与旧版Java结合使用或对学术有兴趣的人。因为此“库”在相关的JavaWorld文章中进行了详细描述，并且因为它是开源的，所以人们可以仔细阅读代码并查看该文章，以了解其如何完成命令行解析以及为什么使用这种方法。鉴于“ jw-options”的许可证不明显，并且鉴于这是一个相对“老”的库，似乎没有收到更新，因此大多数Java开发人员可能更喜欢本文档中介绍的某些替代库。在许多情况下，“ jw-options”上的序列。

其他参考