控制台程序小工具：输入密码、指令指派、自动补全与帮助集成

  一、简介

    控制台程序小巧、便捷，开发起来简单。一般，我写项目时习惯在原定客户端之外，写一个控制台的客户端。这样有几个好处：

（1）       开发量较Web或GUI少得多。

（2）       运行起来简单，占有资源很少。

（3）       便于跟踪程序的运行。比如，用 log4net 记录日志的话，将appender-ref设置成ConsoleAppender，可以清楚看清系统运行轨迹，在使用nhibernate/activerecord开发时尤其方便。

（4）       当为同一个系统开发两种不同的UI时，会自觉的做好分层，这样可以使系统的层次结构更清晰，便于维护。

然而，虽然控制台程序的开发量少，也还是有一些常用功能实现起来较繁琐。比如，以下几个问题：

（1）       输入密码。用户输入密码时，控制台显示****而不是密码明文；

（2）       指令的解析与分派。控制台中，经常需要向程序输入纯字符串格式的指令，解析指令，解析参数的个数，调用相应的方法。

（3）       指令的帮助系统。显示全部指令及其介绍。

（4）       指令的自动补全。

这几个问题在写控制台程序上经常会碰到，为此我写了两个类 ConsoleUtil 和 CmdDispatcher，实现了上述功能，以供复用。于此下载代码。

代码是C#3.0 写的，若要用在其它C#版本，需要做一定的改动。

二、使用方式：

（1）       输入密码

调用静态方法String ConsoleUtil.ReadPassword(String msg, String errMsgOnNull) 获取输入的密码。

（2）       指令的解析、分派、自动补全与帮助系统

（a）创建一个 CmdDispatcher 对象。

（b）使用CmdDispatcher对象的AddCmdFunc方法，加入指令委托。这里定义了五种委托：

     delegate   void  Func0();
     delegate   void  Func1(String s1);
     delegate   void  Func2(String s1, String s2);
     delegate   void  Func3(String s1, String s2, String s3);
     delegate   void  Func4(String s1, String s2, String s3, String s4);

AddCmdFunc方法有两种使用方式。

AddCmdFunc(String cmd, Func0|Func1|Func2|Func3|Func4 func)

和

AddCmdFunc(String cmd, String argsString, String introduce, Func0|Func1|Func2|Func3|Func4 func)

后一种方式中 argsString 是该指令的参数字符串，introduce 是对这个指令的介绍。这两个变量的唯一意义是显示在该指令的help信息之中。如果使用前一种方式，该指令的help信息便是光秃秃的。

比如，

            CmdDispatcher cd  =   new  CmdDispatcher();
            cd.AddCmdFunc( " help " ,  " 无参数 " ,  " 查询帮助. " ,
                ()  =>   { cd.PrintHelp(); } );
            cd.AddCmdFunc( " cmd1 " ,  " 无参数 " ,  " 指令cmd1. " ,
                ()  =>   { Console.WriteLine(String.Format("Invoke cmd1.")); } );
            cd.AddCmdFunc( " cmd2 " ,  " arg0 arg1 " ,  " 指令cmd1. " ,
                (arg0, arg1)  =>   { Console.WriteLine(String.Format("Invoke cmd1({0},{1}).", arg0, arg1)); } );
            cd.AddCmdFunc( " cmd3 " ,
                (arg0, arg1, arg2)  =>   { Console.WriteLine(String.Format("Invoke cmd1({0},{1},{2}).", arg0, arg1, arg2)); } );

显示出来的 help 信息为：

help    无参数
        查询帮助.

cmd2    arg0 arg1
        指令cmd1.

cmd3    无参数

    （3）通过CmdDispatcher对象的String ReadlineWithIntelliSence()方法获取控制台输入的指令.通过CmdDispatcher对象的Handle(String input)方法便可解析指令，分派给相应的委托完成。

    举例:

             while  ( true )
             {
                Console.Write(cd.Prefix);    // 在控制台上输出提示符 >>。
                String input = cd.ReadlineWithIntelliSence();
                cd.Handle(input);
            }

三、一个完整的例子

    下面是一个完整的例子：

 1 using  System;
 2 using  System.Collections.Generic;
 3 using  System.Linq;
 4 using  System.Text;
 5
 6 namespace  ConsoleTest
 7 {
 8    class Program
 9    {
10        static Boolean EXIT = false;
11        static void Main(string[] args)
12        {
13            String id = ConsoleUtil.Readline("请输入帐号:","帐号不能为空.");
14            String pwd = ConsoleUtil.ReadPassword("请输入密码:","密码不能为空.");
15            Console.WriteLine("欢迎你，"+ id + "!");
16            CmdDispatcher cd = CreateDispatcher();
17            while (true)
18            {
19                Console.Write(cd.Prefix);
20                String input = cd.ReadlineWithIntelliSence();
21                cd.Handle(input);
22                if (EXIT) return;
23            }
24        }
25
26        static CmdDispatcher CreateDispatcher()
27        {
28            CmdDispatcher cd = new CmdDispatcher();
29            cd.AddCmdFunc("help", "无参数", "查询帮助.",
30                () => { cd.PrintHelp(); });
31            cd.AddCmdFunc("help", "cmd", "查询指定指令的帮助.",
32                (cmd) => { cd.PrintHelp(cmd); });
33            cd.AddCmdFunc("exit","无参数","退出程序.",
34                () => { EXIT = true; });
35            cd.AddCmdFunc("cmd1", "无参数", "指令cmd1.",
36                () => { Console.WriteLine(String.Format("Invoke cmd1.")); });
37            cd.AddCmdFunc("cmd1", "arg0", "指令cmd1.",
38                (arg0) => { Console.WriteLine(String.Format("Invoke cmd1({0}).", arg0)); });
39            cd.AddCmdFunc("cmd2", "arg0 arg1", "指令cmd1.",
40                (arg0, arg1) => { Console.WriteLine(String.Format("Invoke cmd1({0},{1}).", arg0, arg1)); });
41            cd.AddCmdFunc("cmd3",
42                (arg0, arg1, arg2) => { Console.WriteLine(String.Format("Invoke cmd1({0},{1},{2}).", arg0, arg1, arg2)); });
43            return cd;
44        }
45    }
46}
47

    运行结果：



下载代码

本文转自xiaotie博客园博客，原文链接http://www.cnblogs.com/xiaotie/archive/2008/05/22/1204445.html如需转载请自行联系原作者

xiaotie 集异璧实验室(GEBLAB)