看到这篇文章的题目,估计不少人都会问,这个组件是否是有些显的无聊了,说到web通讯,不少人都会想到ASP.NET SignalR,或者Nodejs等等,实现web的网络实时通信。有关于web实时通讯的相关概念问题,在这里就再也不作具体的介绍了,有兴趣的能够自行百度。web
下面咱们介绍一款WebSocket组件websocket-sharp的相关内容。安全
一.websocket-sharp组件概述服务器
websocket-sharp是一个C#实现websocket协议客户端和服务端,websocket-sharp支持RFC 6455;WebSocket客户端和服务器;消息压缩扩展;安全链接;HTTP身份验证;查询字符串,起始标题和Cookie;经过HTTP代理服务器链接;.NET Framework 3.5或更高版本(包括兼容环境,如Mono)。websocket
websocket-sharp是一个单一的组件,websocket-sharp.dll。websocket-sharp是用MonoDevelop开发的。因此创建一个简单的方式是打开websocket-sharp.sln并使用MonoDevelop中的任何构建配置(例如Debug)运行websocket-sharp项目的构建。cookie
上面介绍了.NET项目中添加websocket-sharp组件,若是想向Unity项目中使用该DLL ,则应将其添加到Unity Editor中的项目的任何文件夹。在Unity的项目中,Unity Free有一些约束:Webplayer的安全沙箱(Web Player中不提供该服务器);WebGL网络( WebGL中不可用);不适用于此类UWP;对System.IO.Compression的有限支持(压缩扩展在Windows上不可用);iOS / Android的.NET Socket支持(若是您的Unity早于Unity 5,则须要iOS / Android Pro);适用于iOS / Android的.NET API 2.0兼容级别。适用于iOS / Android的.NET API 2.0兼容性级别可能须要在.NET 2.0以后修复缺乏某些功能,例如System.Func<...>代理(所以我已将其添加到该资产包中)。网络
二.websocket-sharp组件使用方法并发
1.WebSocket客户端框架
using System; using WebSocketSharp; namespace Example { public class Program { public static void Main (string[] args) { using (var ws = new WebSocket ("ws://dragonsnest.far/Laputa")) { ws.OnMessage += (sender, e) => Console.WriteLine ("Laputa says: " + e.Data); ws.Connect (); ws.Send ("BALUS"); Console.ReadKey (true); } } } }
由上面的代码示例中,使用WebSocketWebSocket URL 建立类的新实例来链接。一个WebSocket.OnOpen当WebSocket链接已经创建发生的事件。WebSocket.OnMessage当发生事件WebSocket接收消息。一个WebSocket.OnClose当WebSocket的链接已关闭发生的事件。若是要异步链接到服务器,应该使用该WebSocket.ConnectAsync ()方法。可使用WebSocket.Send (string),WebSocket.Send (byte[])或WebSocket.Send (System.IO.FileInfo)方法来发送数据。若是您想要异步发送数据,则应该使用该WebSocket.SendAsync方法。若是要明确地关闭链接,应该使用该WebSocket.Close方法。异步
2.WebSocket服务器socket
using System; using WebSocketSharp; using WebSocketSharp.Server; namespace Example { public class Laputa : WebSocketBehavior { protected override void OnMessage (MessageEventArgs e) { var msg = e.Data == "BALUS" ? "I've been balused already..." : "I'm not available now."; Send (msg); } } public class Program { public static void Main (string[] args) { var wssv = new WebSocketServer ("ws://dragonsnest.far"); wssv.AddWebSocketService<Laputa> ("/Laputa"); wssv.Start (); Console.ReadKey (true); wssv.Stop (); } } }
以经过建立继承WebSocketBehavior该类的类定义任何WebSocket服务的行为。能够WebSocketServer经过使用WebSocketServer.AddWebSocketService<TBehaviorWithNew> (string)或WebSocketServer.AddWebSocketService<TBehavior> (string, Func<TBehavior>)方法将任何WebSocket服务添加到服务的指定行为和路径。wssv.Start ();启动WebSocket服务器。wssv.Stop (code, reason);中止WebSocket服务器。
3.消息压缩
ws.Compression = CompressionMethod.Deflate;
4.HTTP身份验证
ws.SetCredentials ("nobita", "password", preAuth);
5.经过HTTP代理服务器链接
var ws = new WebSocket ("ws://example.com"); ws.SetProxy ("http://localhost:3128", "nobita", "password");
三.websocket-sharp组件核心对象解析
1.WebSocket.Send():
private bool send (Opcode opcode, Stream stream) { lock (_forSend) { var src = stream; var compressed = false; var sent = false; try { if (_compression != CompressionMethod.None) { stream = stream.Compress (_compression); compressed = true; } sent = send (opcode, stream, compressed); if (!sent) error ("A send has been interrupted.", null); } catch (Exception ex) { _logger.Error (ex.ToString ()); error ("An error has occurred during a send.", ex); } finally { if (compressed) stream.Dispose (); src.Dispose (); } return sent; } }
使用WebSocket链接发送指定的数据,该方法存在多个重载版本,而且该方法也有异步实现。该方法返回一个布尔类型的参数,表示本次信息是否发送成功。该方法接受两个参数,Opcode是一个枚举类型,表示WebSocket框架类型。该枚举类型值有Cont(等于数值0.表示连续帧),Text(至关于数值1.表示文本框),Binary(至关于数值2.表示二进制帧),Close(至关于数值8.表示链接关闭框架),Ping(至关于数值9.表示ping帧),Pong(至关于数值10.指示pong框)。stream表示一个流对象。该方法设置了锁操做,防止并发时出现死锁问题。不过看到代码中对异常的捕获仍是有些问题,该方法是直接捕获exception异常,这样会致使程序捕获代码块中的全部异常,这样会影响代码的稳定性和代码的可修复性,异常捕获的最好处理方式是将程序进行恢复。
2.WebSocket.CloseAsync():
public void CloseAsync (CloseStatusCode code, string reason) { string msg; if (!CheckParametersForClose (code, reason, _client, out msg)) { _logger.Error (msg); error ("An error has occurred in closing the connection.", null); return; } closeAsync ((ushort) code, reason); }
该方法以指定的方式异步关闭WebSocket链接,该方法接受两个参数,CloseStatusCode表示关闭缘由的状态码,该参数是一个枚举类型。reason表示关闭的缘由。大小必须是123字节或更少。if (!CheckParametersForClose (code, reason, _client, out msg))检查参数关闭。
3.WebSocket.createHandshakeRequest():
private HttpRequest createHandshakeRequest() { var ret = HttpRequest.CreateWebSocketRequest(_uri); var headers = ret.Headers; if (!_origin.IsNullOrEmpty()) headers["Origin"] = _origin; headers["Sec-WebSocket-Key"] = _base64Key; _protocolsRequested = _protocols != null; if (_protocolsRequested) headers["Sec-WebSocket-Protocol"] = _protocols.ToString(", "); _extensionsRequested = _compression != CompressionMethod.None; if (_extensionsRequested) headers["Sec-WebSocket-Extensions"] = createExtensions(); headers["Sec-WebSocket-Version"] = _version; AuthenticationResponse authRes = null; if (_authChallenge != null && _credentials != null) { authRes = new AuthenticationResponse(_authChallenge, _credentials, _nonceCount); _nonceCount = authRes.NonceCount; } else if (_preAuth) { authRes = new AuthenticationResponse(_credentials); } if (authRes != null) headers["Authorization"] = authRes.ToString(); if (_cookies.Count > 0) ret.SetCookies(_cookies); return ret; }
该方法用于客户端建立一个websocket请求,建立握手请求。var ret = HttpRequest.CreateWebSocketRequest(_uri);根据传入的uri调用HttpRequest的方法建立请求。该方法主要操做http头部信息,建立请求。
四.总结
对于这个组件,我的感受仍是有一些用,这个组件很好的实现了websocket,这里也只是简单的介绍,须要使用的同窗,能够自取,由于该组件是开源的,因此一些实际状况中能够自行修改源码,达到最大限度的扩展性。在项目的技术选择中,我的比较主张开源免费的框架和组件,不只是项目预算的问题,更有方便扩展的做用。
********转载:https://m.jb51.net/article/111064.htm