IKende.CLI是一款开源的命令行分解组件,它能够简地把命令行字符转换成命令对象。在编写CLI应用的时候常常要对命令字符进行繁锁的分解和转换工做,而IKende.CLI的存也是为了解决以上问题而产生;经过特性的描述来简化命令分析工做,从而让在编写CLI的时候制定命令变得更方便简单。下面简单地讲解组件的使用git
在使用前先了解一下组件的结构github
Parse是组件的切入点,也是使用的主要对象。他依据两个对象来对数据进行分析处理分别是ILineAnalyzer和CommandBuilder.数据结构
ILineAnalyzerui
接口主要描述对命令行字符进行分析并返回一个统一的数据结构,组件提供一个默认实现;因为使用习惯的问题也能够制其余命令分解方式。spa
CommandBuilder 命令行
对象的主要做用是根据ILineAnalyzer结构绑定到对象中,经过CommandAttribute和ArgumentAttribute两个特性来描述对象及其属性和命令字符的对应关系。整个组件的设计都比较简单,还有两个接口ICommand和IConvert就不做详细介绍了分别的命令定义规则和参数转换规则的定义。设计
组件默认分析器命令属性是以[-字母]来描述一个命令属性,而后空格跟随就是属性的内容如:对象
login -h host -p port -u userName -w password
以上是一个简单地登录指令,分别有主机名,端口,用户名和密码等信息。针对以上字符命令制定的命令对象以下:blog
[Command("login")] public class Login : CommandBase { [Argument("h", "-h Host", Regex = @"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9])\.)+([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\-]*[A-Za-z0-9])$")] public string Host { get; set; } [Argument("p", "-p Port", DefaultValue = "8088", Regex = @"^\d{4,5}$")] public int Port { get; set; } [Argument("u", "-u userName")] public string UserName { get; set; } [Argument("w", "-w passWord")] public string Pwd { get; set; } }
因为有些属性的数据是规范的,因此能够经过Argument特性的Regex属性来制定一个数据约束规范;特性一样也提供DefaultValue来描述一个属性的默认值,若是在编写命令时没有指定该属性值则使用默认值。接口
命令定义好后只须要使用Parse对象对输入的字符命令分析便可。
Parse<LineAnalyzer> mParse = new Parse<LineAnalyzer>(); mParse.LoadAssembly(typeof(Login).Assembly);//or mParse.Load<Login>(); string line="login -h www.ikende.com -u henry -w 123456"; ParseResult presult = mParse.Execute(line); if (string.IsNullOrEmpty(presult.Error)) { //presult.Command }
在定义Parse对象的时候而要指定LineAnalyzer分析器,分析器类型的指定则根据实际应用的需求。Parse定义完成后须要加载相应的命令信息,类提供了两个方法Load和LoadAssembly分别用于加载单个对象或某程序集下面的全部命令对象。最后经过执行Execute方法获得具体ParseRresult对象,在分析过程有可能存在逻辑上的错误,经过ParseResult.Error属性能够获得具体逻辑错误信息。