在Beetle.Express1.2中加了UDP支持,而整体的设计结构也做了调整.只需要通过简单的配置就能实现高吐的TCP&UDP应用.由于组件引用UDP服务同样也支持会话状态所以对于服务是TCP或UDP对使用者来说完全是透明的.使用者只需要关心以下几个接口即可:IServer(服务描述接口),IChannel(通道会话),IData(发送数据描述),IReceiveData(数据接收描述)和IServerHandler(服务处理接口).而使用在使用组件的时候只需要实现IServerHandler.
该接口主要用于描述相关服务的工作,包括连接接入,连接释放,数据接收,数据发送完成和处理错误等过程.
/// <summary> /// 服务处理描述接口 /// </summary> public interface IServerHandler { /// <summary> /// 连接创建处理过程 /// </summary> /// <param name="server">对应的Tcp&UDP服务对象</param>
/// <param name="e">连接详细信息</param> void Connect(IServer server, ChannelConnectEventArgs e); /// <summary> /// 连接断开处理过程 /// </summary> /// <param name="server">对应的Tcp&UDP服务对象</param>
/// <param name="e">连接详细信息</param> void Disposed(IServer server, ChannelEventArgs e); /// <summary> /// 错误处理过程 /// </summary> /// <param name="server">对应的Tcp&UDP服务对象</param> /// <param name="e">详细错误信息</param> void Error(IServer server, ErrorEventArgs e); /// <summary> /// 数据接收处理过程 /// </summary> /// <param name="server">对应的Tcp&UDP服务对象</param> /// <param name="e">接收数据详细信息</param> void Receive(IServer server, ChannelReceiveEventArgs e); /// <summary> /// 数据发送情况处理过程 /// </summary> /// <param name="server">对应的Tcp&UDP服务对象</param>
/// <param name="e">数据发送状态信息</param> void SendCompleted(IServer server, ChannelSendEventArgs e); }
使用Beetle.Express构建TCP或UDP服务,只实现以上接口即可.完全不需要其他工作.
class Program:IServerHandler { public void Connect(IServer server, ChannelConnectEventArgs e) { Console.WriteLine("{0} connected @{1}", e.Channel.EndPoint,server.Name); } public void Disposed(IServer server, ChannelEventArgs e) { Console.WriteLine("{0} disposed", e.Channel.EndPoint); } public void Error(IServer server, ErrorEventArgs e) { Console.WriteLine("{0} error:{1}", e.Channel.EndPoint, e.Error.Message); } public void Receive(IServer server, ChannelReceiveEventArgs e) { string command = e.Data.ToString(Encoding.UTF8); Console.WriteLine("receive:{0}\t@{1}",command,server.Name); Data data = new Data(64); data.Write(server.Name, Encoding.UTF8); server.Send(data, e.Channel); } public void SendCompleted(IServer server, ChannelSendEventArgs e) { } }
以上是实现一个网络处理服务,对以上代码来说可以是一个TCP服务也可以是一个UDP服务.由于IServerHandler统一管理服务处理,因此这个实现是TCP或UDP服务取决于ServerFactory加载的配置信息.实际上可以N个TCP服务和UDP服务同时绑定到该Handler上.
组件是通过配置来描服务,可以同时描述多个TCP和UDP服务,下以配置在同一IServerHandler上同量启动TCP和UDP服务.
<?xml version="1.0"?> <configuration> <configSections> <section name="serverSection" type="Beetle.Express.ServerSection, Beetle.Express"/> </configSections> <serverSection xmlns="urn:Beetle.Express"> <listens> <add name="TEST_TCP" type="TCP" port="8088" handler="Beetle.Express.Sample.Program,Beetle.Express.Sample"/> <add name="TEST_UDP" type="UDP" port="8089" handler="Beetle.Express.Sample.Program,Beetle.Express.Sample"/> </listens> </serverSection> <startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/></startup></configuration>
以上配置是在同一个handler上分别在8088端口上打开TCP服务和在8089打开UDP服务.配置完成后只需要ServerFactory加载即可.
static ServerFactory mFactory; static void Main(string[] args) { mFactory = new ServerFactory("serverSection"); foreach (IServer item in mFactory.Servers) { Console.WriteLine("{0} start @{1}", item.Name, item.Port); } System.Threading.Thread.Sleep(-1); }
通过Beetle.Express可以非常方便就能构建TCP和UDP服务,而在购建的过程是完全不需要关心Socket相关细节,对于连接的处理和数据收发的细节对使用者来说都是完全透明的.组件还提供了基于LRU算法的连接清除对象,可以更方便地控制连接资源.