Cowboy开源WebSocket网络库.doc

Cowboy 开源 WebSocket 网络库 Cowboy.WebSockets 是一个托管在 GitHub 上的基于 .NET/C# 实现的开源 WebSocket 网络库，其完整的实现了 RFC 6455 (The WebSocket Protocol) 协议标准，并部分实现了 RFC 7692 (Compression Extensions for WebSocket) 协议标准。 WebSocket 可理解为建立在 TCP 连接通道上的更进一步的握手，并确定了消息封装格式。 通过定义控制帧 (Control Frame) 和数据帧 (Data Frame) 来控制通道内的通信和数据传输，下图用使用 ABNF 格式描述了帧头部的格式。 Cowboy.WebSockets 中对于 WebSocket 的 Client/Server 分别做了实现，分别对应代码中的： AsyncWebSocketClient AsyncWebSocketServer Cowboy.WebSockets 的内部实现是基于 Cowboy.Sockets 中的 TAP 模式的 AsyncTcpSocketServer 和 AsyncTcpSocketClient 。关于 Cowboy.Sockets 可以参考文章《C#高性能TCP服务的多种实现方式》。 可通过 NuGet 查找 Cowboy 来获取 nuget 包。 WebSocket 服务端应用 实现 AsyncWebSocketServerModule 抽象类，其中 ModulePath 对应着 ws://host:port/path 中的 path 部分。可以实现多个 Module，将多个 Module 注入到 AsyncWebSocketServerModuleCatalog 中，或者采用反射机制等自动发现 Module。 复制代码 public class TestWebSocketModule : AsyncWebSocketServerModule { public TestWebSocketModule() : base(@/test) { } public override async Task OnSessionStarted(AsyncWebSocketSession session) { Console.WriteLine(string.Format(WebSocket session [{0}] has connected., session.RemoteEndPoint)); await Task.CompletedTask; } public override async Task OnSessionTextReceived(AsyncWebSocketSession session, string text) { Console.Write(string.Format(WebSocket session [{0}] received Text -- , session.RemoteEndPoint)); Console.WriteLine(string.Format({0}, text)); await session.SendTextAsync(text); } public override async Task OnSessionBinaryReceived(AsyncWebSocketSession session, byte[] data, int offset, int count) { var text = Encoding.UTF8.GetString(data, offset, count); Console.Write(string.Format(WebSocket session [{0}] received Binary -- , session.REndPoint)); Console.WriteLine(string.Format({0}, text)); await session.SendBinaryAsync(Encoding.UTF8.GetBytes(text)); } public override async Task OnSes