《Apache Common CLI官方文档

本篇文章是并发编程网组织的一次Apache Common组件翻译的一部分,因为无意中看到了Apache Common CLI感觉很好奇,因为这个工具很少在网上看到,当然或许我没有关注过。因为我之前也写过类似的CLI工具所以感觉情有独钟吧。所以让我来为大家揭开CLI的神秘面纱。

虽然各种人机交互技术飞速发展,但最传统的命令行模式依然被广泛应用于各个领域:从编译代码到系统管理,命令行因其简洁高效而备受宠爱。各种工具和系统都提供了详尽的使用手册,有些还提供示例说明如何二次开发。然而关于如何开发一个易用、强壮的命令行工具的文章却很少。

简介

构建命令行程序需要三个步骤. 分别是定义, 解析和询问. 下面的章节将轮流介绍每一个阶段,将介绍如何去实现一个CLI .

定义阶段

每一条命令行都必须定义一组参数,它们被用来定义应用程序的接口.

CLI 使用 Options 类类来定义和设置参数, 它是所有  Option 实例的容器. 目前有两种方式来创建 Options in CLI. 一种是通过构造函数,这是最普通也是最为大家所熟知的一种方式;另外一种方法是通过 Options 中定义的工厂方式来实现.

Usage Scenarios 文档提供了实例怎么去创建一个 Options 对象同时也提供了一个真实的示例.

定义阶段的目的是创建一个Options 实例.

解析阶段

在解析阶段中,通过命令行传入应用程序的文本来进行处理. 处理过程将根据在解析器的实现过程中定义的规则来进行.

在 CommandLineParser 类中定义的方法将用 CLI 定义阶段中产生的 Options 实例和一组字符串作为输入,并返回解析后生成的CommandLine.

解析阶段的目的是创建一个CommandLine 实例.

询问阶段

在询问阶段中,应用程序通过查询 CommandLine,并通过其中的布尔参数和提供给应用程序的参数值来决定需要执行哪些程序分支.

这个阶段在用户的代码中实现,CommandLine 中的访问方法为用户代码提供了 CLI 的询问能力.

询问阶段的目的是根据命令行和解析器处理的Options规则与用户的代码相匹配.

转载自 并发编程网 - ifeve.com

时间: 2024-10-26 05:37:59

《Apache Common CLI官方文档的相关文章

《I'm a Mac:雄狮训练手册》——2.4 快速用户切换

2.4 快速用户切换 I'm a Mac:雄狮训练手册 传统的用户切换需要登出系统重新登录,这样一方面耗时较长,另一方面一次只能登录一个用户,再者会关闭原用户已打开的程序和窗口. 而快速切换则用于不登出系统就切换到另外一个用户,使得多账户同时运行.切换到另一个用户时,前一用户的所有已打开程序和窗口都将暂停并保持原装,不受干扰.当再次切回时,所有一切都像原来一样,所不同的只是时间变了. 2.4.1 在菜单栏上显示快速用户切换菜单 打开"系统偏好设置",点击"用户与群组→解锁→登

《I'm a Mac:雄狮训练手册》——2.3 账户类型

2.3 账户类型 I'm a Mac:雄狮训练手册 用户的社会属性并不决定它的计算机角色,虽然这个世界上有成千上万的Mac用户,形形色色,但是Mac认不过来,它才不管你是美国总统还是平头百姓.用户是指人,账户是指OS分配给用户的系统角色. Mac下的账户类型有五种:超级用户(Super User),管理员,普通用户,客人用户和仅限共享. 2.3.1 超级用户 超级用户也叫root用户,享有对计算机的绝对控制权限,可以任意删除和移动任何文件,所以Mac默认不启用.因为权力太大.当一个人的权力大到无

《I'm a Mac:雄狮训练手册》——2.2 用户账户

2.2 用户账户 I'm a Mac:雄狮训练手册 用户和账户是两个概念,用户是指人,账户是指赋予用户的系统身份,也就是登录凭证,Mac ID.一个用户要登录系统首先要有一个账户,以下为方便说明,假设二者一致. Mac下所有账户和登录都是通过"用户与群组"偏好设置来进行设置.所以要对登录和账户进行设置,首先要打开"用户与群组"偏好设置. 2.2.1 "用户与群组"偏好设置 打开"用户与群组"偏好设置,有五种方式. (1)打开&

《I'm a Mac:雄狮训练手册》——序章 0.1 Mac

序章 0.1 Mac I'm a Mac:雄狮训练手册 苹果电脑共有3种类型:掌上型.膝上型和桌面型. 掌上型也叫平板电脑,膝上型也叫笔记本,桌面型也叫台式机. 0.1.1 笔记本 笔记本原来有3种:MacBook.MacBook Air和MacBook Pro,分别简称MB.MBA和MBP.Macbook是苹果的入门级电脑产品,因塑料全白外壳而得名小白,但小白的命运比较坎坷,曾经一度被拿掉,后来又上,又被拿掉,2012年苹果宣布不再生产白色塑料外壳的MacBook.因为和MBA和MBP相比,小

《I'm a Mac:雄狮训练手册》——0.2 OS X

0.2 OS X I'm a Mac:雄狮训练手册 用乔布斯的话说,Mac之所以是Mac,是因为Mac OS.硬件是骨架,软件是灵魂,正是因为Mac OS才让Mac是Mac.否则,它与PC没有什么不同,只是漂亮一些,电路板整齐一些. Mac是苹果电脑,OS X是装在苹果电脑上的操作系统.以前叫做Mac OS X,Lion之后叫做OS X,去掉Mac的概念是因为苹果想淡化Mac的概念.搭载在Mac上的操作系统可以有很多,OS X是原配,最新版本是10.7,叫做Lion. Mac OS有两个版本,一

《I'm a Mac:雄狮训练手册》——1.7 shift键在开机时的作用

1.7 shift键在开机时的作用 I'm a Mac:雄狮训练手册shift键在开机时的作用有三:①在开机"咚"声时按住shift键将以安全模式启动:②在屏幕闪烁时按住shift键将取消自动登录:③在白屏时按住shift键将取消系统重返和停止加载登录项. 1.7.1 以安全模式启动在开机"咚"声时按住shift直到看到灰色的Apple Logo和进度指示器表示以安全模式启动.所谓安全模式是仅加载核心进程,强制对启动卷宗进行目录检查,并停用一切与系统核心无关的应用,

《I'm a Mac:雄狮训练手册》——0.6 如何快速熟悉Mac

0.6 如何快速熟悉Mac I'm a Mac:雄狮训练手册(1)要了解系统相关的设置,请看"系统偏好设置". (2)要查看程序的功能,请看菜单栏. (3)想知道程序都可以做那些设置,请看程序"偏好设置"(按command,或者点击"'程序'菜单→偏好设置"). (4)要了解电脑的信息,请查看"系统信息"("Launchpad/实用工具/系统信息"或者按住option点击"图片 19菜单→系统信息

《I'm a Mac:雄狮训练手册》——1.6 查看开机信息

1.6 查看开机信息 I'm a Mac:雄狮训练手册Mac的一个设计原则就是隐藏一切与用户无关的信息,不需要你知道的不让你知道,不需要你看到的不让你看到,一切从简,所以在开机的时候你只会听见一个简单的"咚"声和看到一个简单的画面,但其实在这些简单的表面背后有很多复杂的操作.只不过用幕布遮起来不需要用户看到,因为用户关注应用,而不需要看到内核. 如果你要查看Mac的启动过程和开机信息,就可以Verbose模式启动. 开机时按command-V,将以Verbose模式,也就是详细模式启动

《I'm a Mac:雄狮训练手册》——1.8 以32位模式启动

1.8 以32位模式启动 I'm a Mac:雄狮训练手册Lion是64位系统,如果你想以32位模式启动,就可以在开机"咚"声时同时按住数字键3和2以32位模式启动.Mac下的开机设置,都是一次设置,单次有效,下次开机时则正常启动,所以下次开机时系统则以默认的64位方式启动. 查看系统是32位还是64位如果你没有以32位模式启动,则默认是64位. 打开"系统信息"(按住option点击"→系统信息..."),点击"软件",就可

《I'm a Mac:雄狮训练手册》——1.9 恢复磁盘助理

1.9 恢复磁盘助理 I'm a Mac:雄狮训练手册Lion内置了恢复功能,让你可以无须安装盘即可恢复Mac.在开机"咚"声时按住command-R将会直接打开Lion的恢复磁盘助理(相当于按住option,然后选择Recovery HD磁盘). 通过此Recovery HD你可以修复磁盘.重装系统.在外部驱动器上创建Lion恢复,从TimeMachine备份恢复或使用Safari浏览网页. 注:要创建外部Lion恢复,请下载Lion恢复磁盘助理应用程序.插入外部驱动器并启动Lion