c#编写的基于Socket的异步通信系统封装DLL－－SanNiuSignal.DLL

SanNiuSignal是一个基于异步socket的完全免费DLL；它里面封装了Client,Server以及UDP；有了这个DLL；用户不用去关心心跳；粘包
；组包；发送文件等繁琐的事情；大家只要简单的几步就能实现强大的通信系统；能帮助到大家是本人觉得最幸福的事情，也希望大家

在用的过程中找出DLL中不足的地方；好改正；此DLL的苹果版和java版正在努力开发中......交流QQ：365368248；此演示源码下载地址:http://pan.baidu.com/s/1eQw1npw 里面包括了SanNiuSignal.DLL

下面为大家介绍一下
如何使用SanNiuSignal.

1 ) :TCPServer服务器,通过静态方法TxStart.startServer注册成功服务器ITxServer;然后通过ITxServer设置好各种属性；最后启动

ITxServer.StartEngine();就可以了；具体可以到demo里去看;相对来说比较简单，下面来说一下需要注意的地方

一:ITxServer.BufferSize,就是接收数据缓冲区大小；默认为1kb,不要小于50字节，而且要和客户端设置成一样；否则会出现不可预知

的错误；这个缓冲区的大小，不会影响你每次发送数据的大小；大小只能提高你的发送速度
二:ITxServer.sendMessage 发送前先判断此IPEndPoint客户端是否在线；因为如果不在线等情况发生；此方法没有任何消息产生；如

果发送成功并且对方已经收到；会触发发送成功的事件；
三:用户可以通过ITxServer.FileLog记录服务器的运行信息；

2 ) :TCPClient客户端,通过静态方法TxStart.startClient(服务器地址或网址, 服务器端口号)注册成功客户端ITxClient；然后通过

ITxClient设置好各种属性；最后启动ITxClient.StartEngine();跟服务器启动差不多；具体可以到demo里去看;客户端要注意的一些地

方
一：如果非服务器强制关闭客户端的情况下，掉线的话，客户端默认是要重连的；他的原理是这样的，每10秒重连一次；重连

ITxClient.ReconnectMax次如果失败；会自动关闭客户端引擎；在重连的过程中；你可以改变客户端连接服务器的IP地址和端口号；但

如果当断开的时候不想重连；可以设置ITxClient.ReconnectMax＝0；
二：登录篇,在引擎启动之前，用户可以设置ITxClient.OutTime来设置超时时间；默认为10秒，也就是说10秒之内肯定会有一个登录结果

；登录成功或登录失败。有了登录结果会触发登录结果事件；

3 ) :Udp引擎，通过静态方法TxStart.startUdp()注册成功UDP－－IUdpTx；然后通过IUdpTx设置好各种属性；最后启动

IUdpTx.StartEngine();如果在启动之前要绑定端口号，请在这里设置IUdpTx.Port；否则是随机使用本地端口；无论是UDP还是服务器和

客户端；它们的很多方法和属性以及事件都是相同的，因为他们都继承了通信系统的基接口ITxBase；下面是UDP引擎要注意的地方
一:UDP的优势在于速度快但不太可靠；所以有些属性不能设置的太过，如IUdpTx.BufferSize；默认为1KB，如果在广域网上发送信息，

缓冲区大小不要超过默认值；否则数据会丢失，如果一次性数据大于1KB；也没事，系统会自动分包发送；不太会丢包。

4 ) :文件发送系统，通过静态方法FileStart.StartFileSend(IFileSendMust)生成一个文件发送系统IFileSend;其中IFileSendMust是

必须实现的一个接口；具体参照demo；然后通过IFileSend设置好各种属性;发送还是要通过前面的三个引擎系统发送的；如

ITxClient.SendFile 这时会返回一个文件标签，是一个整数；IFileSend可以通过操作这个标签来操作这个正在发送的文件；接收文件

系统也一样；也是通过文件标签来操作；文件续传也是一样，也要通过前面的三个通信引擎系统进行续传；因为文件系统不能决定用户

通过哪个通信系统进行续传的；例如IUdpTx.ContinueFile进行续传；大家也可以试一下 掉线之后重新连接也可以续传；

5 ) :文件接收系统，通过静态方法FileStart.StartFileReceive(IFileReceiveMust)生成一个文件接收系统IFileReceive；其中

IFileReceiveMust是接收方必须实现的一个接口；具体参照demo；然后通过IFileReceive设置好各种属性；下面来讲讲文件系统要注意

的几个要点
一:每个文件都有一个文件标签，发送系统和接收系统是通过控制这个标签来控制这个文件的；如果是同一个文件传输，标签也一样的；
二:要注意属性BufferSize缓冲区大小，他是代表一次传送的字节数；如果这个文件缓冲区越大，传输速度越快；具体要设置成多少，大

家自己去调试；TCP传输的话一般可以设置成比较大，但UDP的话这个不要超过1KB；所以传输大文件尽量不要用UDP这种不可靠的东东；
三:当网络等各种原因中断文件的时候；会触发文件中断事件；文件自动处于暂停发送或接收状态；等待续传；续传的发送方，如果对方

同意续传；对方将不会触发续传开始的方法；别的大家可以通过demo里去发现；

总结:
其实这个DLL相对来讲是比较简单的;大家只要掌握这五个接口；1:ITxServer TCP服务器接口 2：ITxClient TCP客户端接口 3：IUdpTx

UDP接口 4：IFileSend 文件发送方接口 5：IFileReceive 文件接收方接口 前面三个接口是通过TxStart启动；后面二个文件接口

是通过FileStart启动

今天先讲到这里；希望这个DLL对大家有所帮助；不足之处希望通过QQ或博客园大家一起交流；谢谢

此演示源码下载地址:http://pan.baidu.com/s/1eQw1npw 里面包括了SanNiuSignal.DLL