内置的命令行协议

    什么是协议? 很多人会回答 "TCP" 或者 "UDP"。 但是构建一个网络应用程序, 仅仅知道是 TCP 还是 UDP 是远远不够的。 TCP 和 UDP 是传输层协议。仅仅定义了传输层协议是不能让网络的两端进行通信的。你需要定义你的应用层通信协议把你接收到的二进制数据转化成你程序能理解的请求。

    命令行协议是一种被广泛应用的协议。一些成熟的协议如 Telnet, SMTP, POP3 和 FTP 都是基于命令行协议的。 在SuperSocket 中， 如果你没有定义自己的协议，SuperSocket 将会使用命令行协议, 这会使这样的协议的开发变得很简单。

    命令行协议定义了每个请求必须以回车换行结尾 "\r\n"。

    StringRequestInfo 是这样定义的:

    由于 SuperSocket 中内置的命令行协议用空格来分割请求的Key和参，因此当客户端发送如下数据到服务器端时:

    SuperSocket 服务器将会收到一个 StringRequestInfo 实例，这个实例的属性为:

    1. public class LOGIN : CommandBase<AppSession, StringRequestInfo>
    2. {
    3.     public override void ExecuteCommand(AppSession session, StringRequestInfo requestInfo)
    4.         //Implement your business logic
    5.     }
    6. }

    有些用户可能会有不同的请求格式, 比如:

    请求的 key 和 body 通过字符 ':' 分隔, 而且多个参数被字符 ',' 分隔。 支持这种类型的请求非常简单, 你只需要用下面的代码扩展命令行协议:

    2. {
    3.     public YourServer()
    4.         : base(new CommandLineReceiveFilterFactory(Encoding.Default, new BasicRequestInfoParser(":", ",")))
    5.     {
    6.     }
    7. }

    如果你想更深度的定义请求的格式, 你可以基于接口 IRequestInfoParser 来实现一个 RequestInfoParser 类, 然后当实例化 CommandLineReceiveFilterFactory 时传入拟定一个 RequestInfoParser 实例:

    2. {
    3.     public YourServer()
    4.         : base(new CommandLineReceiveFilterFactory(Encoding.UTF8))
    5.     {
    7. }