Asp.Net Mvc基于Fleck开发的多人网页版即时聊天室

本文章主要用于介绍在Asp.Net Mvc(C#)中使用Fleck制作一个Html5的即时聊天室，含有完整代码和演示Demo。

一、项目的核心说明

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下载源码。

疫情当前，公司发展不顺，旧项目停摆，新项目需求不明。像当前这样的企业破产潮，我是比较紧张的，毕竟不是小年轻，技术又不是特别过硬，不上不下的焦虑的很。但是也明白，行动起来，每天让自己靠近目标一点点，是解决焦虑的不二法门。

能写一些博客，就写一些博客吧，我也不确定写这个对我自己有什么帮助，对读者都多大的帮助，就当备忘录吧。

当一个会折腾的“前浪”…

欢迎建设性的批评和指导意见。

本文链接：https://www.cnblogs.com/dissun/p/12932239.html

Asp.Net Mvc基于Fleck开发的多人网页版即时聊天室

Asp.Net Mvc基于Fleck开发的多人网页版即时聊天室的更多相关文章

随机推荐

热门专题

目录导航