Java命令行界面(第13部分):JArgs
JArgs 1.0的区别在于,这是我的第13篇文章的主题,该文章是关于Java命令行参数解析的。 JArgs是一个开放源代码( BSD许可证 )库,主要由Steve Purcell和Ewan Mellor等 不同的贡献者支持。 事实证明,这在第一次使用JArgs时可能会引起一些困惑,因为程序包名称和其他详细信息会根据您应用的JArgs版本而变化。
JArgs项目页面将JArgs描述为“供Java程序员使用的便捷,紧凑,预先打包并有详细文档的命令行选项解析器套件。” 该页面断言,可能会选择JArgs而不是其他基于Java的命令行处理库,因为JArgs“易于使用,经过全面测试,有据可查并获得了广泛的许可(BSD许可,因此没有GNU混乱)”。 该页面还指出:“该软件包很小,没有多余的装饰,但是功能齐全,并且包含已投入生产使用相当一段时间的代码。”
JArgs确实很小。 jargs-1.0.zip文件的大小不足200 KB,而提取的核心jargs.jar仅约12 KB。 没有第三方库依赖项。 以下屏幕快照演示了从SourceForge下载的jargs.jar的内容( Maven存储库上可用的jargs-1.0.jar 与此类似)。
对于JArgs文档包括其主要Javadoc生成API文档和代码示例如OptionTest和CustomOptionTest 。
使用JArgs时,使用的主要类是CmdLineParser
( jargs.gnu.CmdLineParser或com.sanityinc.jargs.CmdLineParser取决于您在何处获得JArgs的发行版以及所获得的版本)。 如果使用通过SourceForge下载或通过Maven存储库 提供的JArgs JAR,则将使用的主要类是jargs.gnu.CmdLineParser
。 另一方面,如果您从GitHub(purcell / jargs)上的可用源构建JArgs,则主类将为com.sanityinc.jargs.CmdLineParser
。 无论哪种情况,都只有一个CmdLineParser
外部类,并且它使用嵌套类来提供额外的支持。 在本文中,我将使用jargs.gnu.CmdLineParser
演示基于SourceForge / Maven JAR的jargs.gnu.CmdLineParser
。 我的示例的完整源代码将发布在GitHub上,并且可能会对该版本进行编辑,以利用更明确的导入来提高代码的简洁性和可读性。
JArgs很小,因此令人惊讶地很简单。 它没有提供很多精美的功能,但是它确实使用不使用注释或反射的简单编程方法来进行基本的命令行参数处理。
为了实现使用JArgs解析命令行参数的“定义”阶段,需要实例化CmdLineParser类的实例,并为每个预期的命令行选项在该实例上调用addOption(CmdLineParser.Option)方法 。 每个选项都由扩展CmdLineParser.Option类的类的实例表示。 在本系列的示例中,我一直在使用基于字符串的文件路径/名称选项和基于布尔的详细选项。 因此,在将JArgs用于这些示例时,可以将CmdLineParser.Option.StringOption类用于文件路径和名称,将CmdLineParser.Option.BooleanOption类用于详细选项。 下一个代码清单演示了使用JArgs实现“定义”阶段的过程。
JArgs的“定义”阶段
public static void main(final String[] arguments)
{final CmdLineParser cmdLineParser = new CmdLineParser();final CmdLineParser.Option fileOption = new CmdLineParser.Option.StringOption('f', "file");cmdLineParser.addOption(fileOption);final CmdLineParser.Option verbosityOption = new CmdLineParser.Option.BooleanOption('v', "verbose");cmdLineParser.addOption(verbosityOption);
使用JArgs进行“解析”仅需要一条语句,但是您确实需要捕获CmdLineParser.parse(String [])方法引发的两个检查的异常,或者明确声明这些异常是从使用method调用的代码中引发的。 这显示在下一个代码清单中。
JArgs的“解析”阶段
try
{cmdLineParser.parse(arguments);
}
catch (CmdLineParser.IllegalOptionValueException | CmdLineParser.UnknownOptionException exception)
{out.println("Unable to parse command line options - " + exception);System.exit(-1);
}
当刚刚显示的代码成功执行(没有引发两个检查的异常之一)时,在其上调用parse(String[])
方法的CmdLineParser
实例现在包含为预期的命令行选项分析的值,因此我们准备“审讯”该实例。
JArgs命令行选项处理的“询问”阶段使用前面讨论的CmdLineParser.Option
-extended类上的方法来检索为每个选项解析的值。 CmdLineParser.getOptionValue()
方法的重载版本用于执行此询问。 如果未找到或解析选项,则仅接受需要其值的Option实例的方法[ getOptionValue(CmdLineParser.Option) ]返回null
。 如果未找到或解析该选项,则接受需要其值的Option实例和第二个“默认”对象[ getOptionValue(CmdLineParser.Option,Object) ]的方法将返回提供的默认对象。 在下面的代码清单中,我在两种情况下都使用了第二种形式,因此确保不必处理null
。
JArgs的“审讯”阶段
final String filePathName = cmdLineParser.getOptionValue(fileOption, "null").toString();
if (filePathName.equals("null"))
{out.println("ERROR: File path/name must be provided.");System.exit(-2);
}
out.println("File path/name is " + filePathName+ " and verbosity is " + cmdLineParser.getOptionValue(verbosityOption, false)+ ".");
有了这些基本代码示例,下面的屏幕快照中演示了如何运行使用JArgs进行命令行处理的简单Java应用程序。
CmdLineParser
类不附带任何内置的帮助/用法支持。 然而,在SourceForge上jargs-1.0.zip提供包括源代码AutoHelpParser ,延伸类CmdLineParser
和显示帮助/用法中如何实现。
由于它已经过时并且很简单,因此与本系列中讨论的其他一些基于Java的命令行解析库相比,JArgs可能可以与Java的较旧版本一起使用。 当我在Maven提供的jargs-1.0.jar
和SourceForge提供的jargs.jar
中的CmdLineParser
上运行javap以确定使用它编译的Java版本时,我看到它的主要版本为45 ! 正如我在“以编程方式确定Java类的JDK编译版本”一文中所写的那样,主要版本为45表示该代码是使用JDK 1.1编译的!
Maven提供的jargs-1.0.jar
版本信息(来自javap)
Classfile jar:file:/C:/lib/jargs-1.0/lib/jargs-1.0.jar!/jargs/gnu/CmdLineParser.classLast modified Apr 9, 2005; size 6032 bytesMD5 checksum b2d61c0ce786f8a661cccf1e61de2a19Compiled from "CmdLineParser.java"
public class jargs.gnu.CmdLineParserminor version: 3major version: 45
SourceForge提供的jargs.jar
版本信息(来自javap)
Classfile jar:file:/C:/lib/jargs-1.0/lib/jargs.jar!/jargs/gnu/CmdLineParser.classLast modified Apr 9, 2005; size 6032 bytesMD5 checksum b2d61c0ce786f8a661cccf1e61de2a19Compiled from "CmdLineParser.java"
public class jargs.gnu.CmdLineParserminor version: 3major version: 45
这是在选择框架或库以帮助Java进行命令行解析时要考虑的JArgs的特征。
- JArgs是开源的,并获得BSD许可证的许可。
- 对于JArgs的版本和主要贡献者似乎有些困惑, Maven和SourceForge具有一个版本,而GitHub上的purcell / jargs具有另一个版本。
- JArgs既小又简单:
jargs.jar
(或Maven上的jargs-1.0.jar
)只有大约12 KB的大小,并且没有第三方库依赖项。 - JArgs使用程序化API来定义,解析和询问选项,而不是使用注释或反射。
- JArgs的日期有些过时,许多主页都有“最新更新”,例如2005年。但是,本文中多次引用的GitHub页面(其主类的包名称不同)显示了其最新更新。是2012年。
- 我认为JArgs可以与当今的绝大多数Java应用程序一起使用,因为在我看来,JArgs可以使用Java版本,甚至可以追溯到Java SE 1.1 。
一个可能不得不使用JArgs而不是其他一些更常用的和/或最近更新的基于Java的命令行处理的最令人信服的原因是它的简单性和小巧的体积。 有时候我会面临一个决定,即我想支持JArgs提供什么级别的命令行选项,而当我想要的不仅仅是直接解析传入的String[]
到主函数时,可能需要的库。想要其他一些基于Java的命令行处理库的强大功能和复杂性。 我对使用JArgs的最大担心可能是它有一段时间没有更新,并且可能会导致其他人使用我的工作并不得不处理JArgs的两种不同表现形式,并且其主要类的包名称不同(使用依赖的Maven在这里可能会很有帮助)。 JArgs既小又简单,对于那些只希望最基本的命令行处理的人来说,它可能会找到自己的利基。
其他参考
- JArgs SourceForge页面
- JArgs在SourceForge上下载
- Maven上的JArgs
- Ewan Mellor的页面:“ JArgs:Java的命令行选项解析套件 ”
- JArgs API文档 (Javadoc)
- GitHub上的JArgs : purcell / jargs
翻译自: https://www.javacodegeeks.com/2017/08/java-command-line-interfaces-part-13-jargs.html
Java命令行界面(第13部分):JArgs相关推荐
- 我的世界java下载1.13_Minecraft Java版 1.13.1-pre2 发布
Minecraft Java 版 1.13.1-pre2 发布 Back from vacation, we're now trying to finalize 1.13.1 and get it t ...
- java request获取域,Java Web - Servlet(13)HttpServletRequest详解(获取请求数据、请求分派、请求域)(二)...
Java Web -- Servlet(13)HttpServletRequest详解(获取请求数据.请求分派.请求域)(2) HttpServletRequest ----------------- ...
- 【java】生成13位条形码(Ean-13码)
[java]生成13位条形码(Ean-13码) 题目: 生成13位条形码 Ean-13码规则:第十三位数字是前十二位数字经过计算得到的校验码. 例如:690123456789 计算其校验码的过程为: ...
- Java命令行界面(第10部分):picocli
picocli主页面将picocli描述为"强大的微小命令行界面"," picocli"是一个文件Java框架,用于解析命令行参数并生成精美,易于定制的用法帮助 ...
- Java命令行界面(第17部分):jw-options
JavaWorld文章处理Java中的命令行参数: Matthias Laux博士关闭的案例介绍了一个基于Java的简单库,用于处理命令行参数 ,在本文中我将其称为jw-options . 被引用的文 ...
- Java命令行界面(第21部分):航空公司2
本系列文章的第21篇关于Java中解析命令行参数的文章的重点是Airline 2库. Airline 2的GitHub项目页面描述了该库," Airline是一个Java库,提供了基于注释的 ...
- Java命令行界面(第14部分):google-options
google-options的GitHub页面指出google-options是"来自Google(java)的人们的命令行参数解析库." 该页面继续说:"这是Bazel ...
- Java命令行界面(第1部分):Apache Commons CLI
尽管我通常使用Groovy编写要从命令行运行的JVM托管脚本,但是有时候我需要解析Java应用程序中的命令行参数,并且有很多库可供Java开发人员用来解析命令行参数. 在本文中,我将介绍这些Java命 ...
- Java命令行界面(第18部分):JCLAP
Giles Winstanley的JCLAP ( Java命令行参数解析器 )是基于Java的命令行处理库的系列文章中介绍的第18个库. 这篇文章的示例基于需要Java 8的 JCLAP 1.4 . ...
最新文章
- OkHttp源码深度解析
- Debian Gnu/Linux 9关闭 111端口
- java学习(46):无参带返回
- 直通BAT必考题系列:7种JVM垃圾收集器特点,优劣势、及使用场景
- 华为智能手环智能手表软件测试,一块智能手表的测试之旅,揭秘华为运动健康科学实验室...
- 性能优化篇(5):css 内部 or 外部,该如何选择?
- 华为服务器默认什么系统,云服务器默认系统
- C/C++:Windows编程—Inline Hook内联钩子(上)
- Fedora进入超级用户的方法
- 最大-最小 滤波器实现 及用于边缘检测
- 线上服务器出现CPU飙升问题该怎么办?
- python同时输出名字和时间_Python练习小工具——根据Exif的拍摄时间和设备名批量重命名照片...
- 群晖Nas通过jellyfin搭建本地影音库详细全过程(一):通过群晖系统docker容器安装jellyfin影音库服务器
- wps居中对齐不在中间_如何解决wps表格居中调整
- 计算机桌面图标有箭头,解决方案:如果计算机桌面图标上有箭头,该怎么办?如何删除计算机桌面图片[图形]上的箭头...
- python学习之数据爬取及其可视化分析(一)
- 敏捷交付_确保敏捷交付
- vue实现自定义步骤条
- 数据结构--环形队列
- 漫画:5G 到底是个什么玩意儿?
热门文章
- 在JavaFX程序中嵌入Swing内容
- 如何在MyEclipse中显示行数
- 使用ueditor实现多图片上传案例——截取字符串层Util(SubString_text)
- 2016最佳温情小说:雨还在下....
- 求一个数字是几位数(简便)
- JDBC8.0 URL配置
- 简单解决“无法打开内核设备:\\Global\\vmx86”错误
- 柱状图python_python柱状图一行
- rabbitmq-通配符模式
- review_core_basic_java(1)java程序设计概述