首页 > temp > 简明python教程 >
-
Asp.Net Mvc基于Fleck开发的多人网页版即时聊天室
一、项目的核心说明
1、Fleck这个是实现websocket一个比较简单第三方组件,它不需要安装额外的容器。本身也就几个接口可供调用。
2、项目是基于.net framework 4.7.2 ,在vs2019上开发的,没试过在低版本上运行。但是代码上没怎么用到新特性,所以估计是可以被低版本使用的。
3、这个项目并不是真实项目,也就是玩一下,但是对熟悉Fleck或者了解及时聊天,应该有一丁点的启发作用。
二、Fleck 的简要说明(https://github.com/statianzo/Fleck)
1、最简单、最常用的调用方法:(ws://172.10.3.4:8111改成您的服务器本地IP和端口)
//控制台代码 var server = new WebSocketServer("ws://172.10.3.4:8111"); server.Start(socket => { socket.OnOpen = () => Console.WriteLine("产生连接处理"); socket.OnClose = () => Console.WriteLine("连接断开处理"); socket.OnMessage = (message) => { //1、此方法用于接收客户端发送来的消息 //2、可以做一些自己的操作,例如存入数据库 //3、为了响应客户端,一般会使用下面的send函数,返回响应结果。 socket.Send(message); } });
2、Fleck本身只负责帮你单线联系。也就是客户端A和服务器建立连接后,会产生一个IWebSocketConnection,也就是上面代码中socket变量的类型,它包含了接收方法、发送方法,但是都仅限于单一连接内。至于客户端A想发送消息给客户端B、C、D亦或者想群发,不好意思Fleck本身不Care。。。当然了那并不是这个功能就不能实现了,只是要开发者自己去把每一个IWebSocketConnection存储起来,并管理他们的生存周期,通过自己的代码去实现客户端A给B发信息或者群发。
3、Fleck不需要额外的容器或进程来运行,它随着IIS网站运行,也就是在w3wp.exe。至于它是怎么运行的,目前我还没有去看源码,后期有时间再瞧瞧。
三、聊天室源码位置
1、GitHub:https://github.com/DisSunRestart2020/DisSunChat
2、码云:https://gitee.com/dissun/DisSunChat
3、微信扫码演示(网络时好时坏)
四、核心代码说明。
1、IWebSocketHelper接口。因为一开始,我是想用多个插件来实现聊天室,所以想用一个接口来做行为封装。结果完成了Fleck之后,发现其他的操作模式都不太相同,很难封装就放弃了,但是保留这个接口,是为了体现扩展性。
/// <summary> /// 所有调用WebSocket的帮助类必须遵从的协议 /// </summary> public interface IWebSocketHelper { /// <summary> /// websocket连通后触发事件 /// </summary> event SwitchEventHandler WsOpenEventHandler; /// <summary> /// websocket连接关闭后触发事件 /// </summary> event SwitchEventHandler WsCloseEventHandler; /// <summary> /// websocket监听到消息后触发事件 /// </summary> event ListenEventHandler WsListenEventHandler; /// <summary> /// websocket响应处理事件 /// </summary> event ResponseTextEventHandler WsResponseTextEventHandler; /// <summary> /// 聊天室在线人数 /// </summary> int PlayerCount { get; set; } /// <summary> /// websocket初始化 /// </summary> void WebSocketInit(); /// <summary> /// 向全员发送信息 /// </summary> /// <param name="wsocketMsg"></param> void SendMessageToAll(WebSocketMessage wsocketMsg); /// <summary> /// 向自己发送信息 /// </summary> /// <param name="wsocketMsg"></param> void SendMessageToMe(WebSocketMessage wsocketMsg); }
接口中用到了4个委托事件,这里稍微简单的复习一下委托和事件。
①委托从使用形式来说,是指我们可以把一个函数作为参数进行传递,例如我们在解一道数学题,条件和要求都是一样的,但是求解的过程可以多种多样,通过委托就可以在不改变主体程序的同时,把不同的求解过程,封装到不同的函数中,然后把函数作为参数传入主体程序。
②委托从模式的角度来说,是在实现观察者模式。订阅者\观察者告诉发布者\主题,如果发生了某一特定事情该怎么处理,“怎么处理”的过程就是委托方法的内容
③事件其实就是一个委托,都说事件是一个特殊委托,特殊在哪里,特殊在它对委托增加了约束,让你不能毫无顾忌的使用委托,这是为了保证封装性。
④上面的4个事件,其实我可以直接换成4个委托属性,对程序运行不会有太大影响。但是为什么要使用事件,还是第三点的封装性。事件本来的用意,是达到特定条件后让发布者自己来触发委托方法的执行,但是如果使用委托属性,订阅者本身就可以进行调用,封装性就很差。
⑤上面的4个事件,分别是订阅者告诉Fleck中心,新长连接接通怎么办、长连接断开怎么办、客户端发来消息怎么办、要返回客户端的消息怎么转换。
2、Fleck类的实现。Fleck实现了IWebSocketHelper接口,这是这个项目的核心代码。
1 public class FleckHelper:IWebSocketHelper 2 { 3 /// <summary> 4 /// websocket连通后触发事件 5 /// </summary> 6 public event SwitchEventHandler WsOpenEventHandler; 7 /// <summary> 8 /// websocket连接关闭后触发事件 9 /// </summary> 10 public event SwitchEventHandler WsCloseEventHandler; 11 /// <summary> 12 /// websocket监听到消息后触发事件 13 /// </summary> 14 public event ListenEventHandler WsListenEventHandler; 15 /// <summary> 16 /// websocket反馈客户端的文本处理事件 17 /// </summary> 18 public event ResponseTextEventHandler WsResponseTextEventHandler; 19 /// <summary> 20 /// 聊天室在线人数 21 /// </summary> 22 public int PlayerCount 23 { 24 get; 25 set; 26 } 27 /// <summary> 28 /// websocket已经连通的连接集合 29 /// </summary> 30 private Hashtable socketListHs = new Hashtable(); 31 32 public void WebSocketInit() 33 { 34 35 string websocketPath = Utils.GetConfig("websocketPath"); 36 WebSocketServer wsServer = new WebSocketServer(websocketPath); 37 38 wsServer.Start(socket => 39 { 40 //以下的设置,每当一个新连接进来,都会生效。 41 socket.OnOpen = () => { 42 //自定义处理 43 44 if (this.WsOpenEventHandler != null) 45 { 46 WebsocketEventArgs args = new WebsocketEventArgs(); 47 this.WsOpenEventHandler(this, args); 48 } 49 }; 50 51 socket.OnClose = () => { 52 //从连接集合中移除 53 for (int i= socketListHs.Count-1; i>=0;i--) 54 { 55 if (socketListHs[i] == null) 56 { 57 socketListHs.Remove(i); 58 } 59 } 60 PlayerCount = socketListHs.Count; 61 //自定义处理 62 if (this.WsCloseEventHandler != null) 63 { 64 WebsocketEventArgs args = new WebsocketEventArgs(); 65 this.WsCloseEventHandler(this, args); 66 } 67 }; 68 69 socket.OnMessage = (message) => 70 { 71 ClientData cData = Utils.JsonToObject<ClientData>(message); 72 WebSocketMessage wsocketMsg = new WebSocketMessage(socket.ConnectionInfo.ClientIpAddress, socket.ConnectionInfo.ClientPort.ToString(), socket.ConnectionInfo.Id.ToString("N"), cData); 73 74 if (Convert.ToBoolean(cData.IsConnSign)) 75 { 76 //收到用户上线信息,更新socket列表 77 if (!socketListHs.ContainsKey(cData.IdentityMd5)) 78 { 79 socketListHs.Add(cData.IdentityMd5, socket); 80 } 81 else 82 { 83 socketListHs[cData.IdentityMd5] = socket; 84 } 85 PlayerCount = socketListHs.Count; 86 } 87 88 if (this.WsListenEventHandler != null) 89 { 90 WebsocketEventArgs args = new WebsocketEventArgs(); 91 args.WebSocketMessage = wsocketMsg; 92 this.WsListenEventHandler(this, args); 93 } 94 }; 95 96 }); 97 } 98 99 /// <summary> 100 /// 向全员发送信息 101 /// </summary> 102 /// <param name="wsocketMsg"></param> 103 public void SendMessageToAll(WebSocketMessage wsocketMsg) 104 { 105 string resultData = ""; 106 if (this.WsResponseTextEventHandler != null) 107 { 108 WebsocketEventArgs args = new WebsocketEventArgs(); 109 args.WebSocketMessage = wsocketMsg; 110 this.WsResponseTextEventHandler(this, args); 111 resultData = args.ResultDataMsg; 112 } 113 114 if (!string.IsNullOrWhiteSpace(resultData)) 115 { 116 foreach (DictionaryEntry dey in socketListHs) 117 { 118 IWebSocketConnection subConn = (IWebSocketConnection)dey.Value; 119 subConn.Send(resultData); 120 } 121 } 122 } 123 124 }
①代码中IdentityMd5是我自己通过各种本地信息算出来的身份标识,因为在在微信上运行cookie不稳定,不能在本地存储任何信息,只能通过算法把环境信息合成一个唯一值。
②前面说过,Fleck只负责单线联系,每一个连接都是一个IWebSocketConnection,所以我需要把IdentityMd5和IWebSocketConnection存起来,方便索引调用。
③socket.OnMessage中,socketListHs是存储IWebSocketConnection的集合,每次有消息发来,如果判断是新的IdentityMd5就会存起来。
④socket.OnClose 中,如果有连接断开了,IWebSocketConnection就会为null,所以遍历集合,然后把值为null剔除就能保持socketListHs集合的有效性
⑤SendMessageToAll函数用于群发消息,遍历集合中所有的对象,调用每个IWebSocketConnection.Send(),就可以把消息发送出去。如果想从客户端A发到客户端B,也得利用IdentityMd5来做文章,本项目由于是聊天室并不需要这个功能,所以就省略了。
⑥socket.OnOpen、socket.OnClose、socket.OnMessage都是Fleck自行触发的事件,前面一开始我们介绍过了,例如OnOpen中,如果我们需要当建立新连接时记录日志,我们就可以对WsOpenEventHandler赋值(本项目在Global.asax的Application_Start中用lambda赋值),如下:
protected void Application_Start() { AreaRegistration.RegisterAllAreas(); RouteConfig.RegisterRoutes(RouteTable.Routes); App_Start.FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters); ChatService chatService = new ChatService(); try { IWebSocketHelper helper = new FleckHelper();//用FleckHelper来实例化IWebSocketHelper 接口。 helper.WebSocketInit(); helper.WsOpenEventHandler +=(sender, args)=>{ Utils.SaveLog("WebSocket已经开启2"); }; helper.WsCloseEventHandler += (sender, args) => { Utils.SaveLog("WebSocket已经关闭2"); }; helper.WsListenEventHandler += (sender, args) => { Utils.SaveLog("WebSocket监听到了消息2"); if (!Convert.ToBoolean(args.WebSocketMessage.ClientData.IsConnSign)) { chatService.CreateChatInfo(args.WebSocketMessage); args.WebSocketMessage.ClientData.SMsg = Utils.ReplaceIllegalWord(args.WebSocketMessage.ClientData.SMsg); } else { string clientName = args.WebSocketMessage.CIp + ":" + args.WebSocketMessage.CPort; string traceInfo = string.Format("{0} 加入聊天室(共{1}人在线)", clientName, helper.PlayerCount); args.WebSocketMessage.ClientData.SMsg = traceInfo; } //给所有人转发消息 helper.SendMessageToAll(args.WebSocketMessage); }; helper.WsResponseTextEventHandler += (sender, args) => { string jsonStr = Utils.ObjectToJsonStr(args.WebSocketMessage); args.ResultDataMsg = jsonStr; }; } catch(Exception ex) { Utils.SaveLog("发现了错误:" + ex.Message); } }
3、在html端连接Fleck,只须一个一个WebSocketJs.js文件。
var socket; var websocketInit = function (wsPath) { if (typeof (WebSocket) === "undefined") { socket = null; console.log("浏览器不支持websocket"); } else { // 实例化socket socket = new WebSocket(wsPath); // 监听socket连接 socket.onopen = wsOnOpen; //监听socket关闭 socket.onclose = wsOnClose; // 监听socket错误信息 socket.onerror = wsOnError; // 监听socket消息 socket.onmessage = wsOnMessage; } } var wsOnOpen = function () { console.log("已经成功连接"); var sMsg = ""; var sendMsg = "{\"IdentityMd5\":\"" + identityMd5 + "\",\"SMsg\":\"\",\"ImgIndex\":\"" + imgIndex + "\",\"IsConnSign\":\"true\"}"; socket.send(sendMsg); } var wsOnClose = function () { console.log("已经关闭连接"); } var wsOnError = function (evt) { console.log("异常:" + evt); } var wsSend = function (sMsg) { if (socket == null || sMsg == "") return false; console.log("消息成功发出"); socket.send(sMsg); }
①WebSocket是浏览器内置的一个类型,现在一般的浏览器都支持,但是还是typeof (WebSocket)来做一下判断。
②然后在启动时加载即可(ws://14.215.177.1:8111改成您的服务器公网IP和端口)。
$(function () { websocketInit("ws://14.215.177.1:8111"); });
********** End *****************
上面这些也只是部分代码,需要可运行代码,请去github下载源码。
疫情当前,公司发展不顺,旧项目停摆,新项目需求不明。像当前这样的企业破产潮,我是比较紧张的,毕竟不是小年轻,技术又不是特别过硬,不上不下的焦虑的很。但是也明白,行动起来,每天让自己靠近目标一点点,是解决焦虑的不二法门。
能写一些博客,就写一些博客吧,我也不确定写这个对我自己有什么帮助,对读者都多大的帮助,就当备忘录吧。
当一个会折腾的“前浪”...