使用ASP.NET SignalR实现一个简单的聊天室

 前言

  距离我写上一篇博客已经又过了一年半载了,时间过得很快,一眨眼,就把人变得沧桑了许多。青春是短暂的,知识是无限的。要用短暂的青春,去学无穷无尽的知识,及时当勉励,岁月不待人。今天写个随笔小结记录一下。

 什么是SignalR?

  陌生的关键字,百度科普一下,什么是SignalR?ASP .NET SignalR 是一个ASP .NET 下的类库,可以在web中实现实时通信。服务器端可以将消息自动推送到已连接的客户端。官方网站SignalR介绍写得很详细,http://www.asp.net/signalr/overview/getting-started/tutorial-getting-started-with-signalr 官网是英文的,如果像我一样看英文看的头疼的,可以像我一样试试把url中的  “en-us”改为 “zh-cn” 刷新即变成中文的了,

使用ASP.NET SignalR实现一个简单的聊天室

 

先看几个我做的效果图

使用ASP.NET SignalR实现一个简单的聊天室

使用ASP.NET SignalR实现一个简单的聊天室

使用ASP.NET SignalR实现一个简单的聊天室

这个聊天室,刚开始前端我用的是BootStrap,Css和页面布局我是拷贝了网上的别人改过的,直接搬过来用的,具体是哪里找的忘记了。。  QAQ。在此谢过了。聊天室中我实现了登录,公共聊天,组件群聊,私聊,消息推送,保存聊天记录等等功能。后来基本功能实现了后,前端我使用vue.js+webapi前后端分离了。

新建项目,SignalR入门

1)新建一个asp.net web项目,类型为MVC,取名为SignalRChat,然后在引用中添加NuGet浏览中安装SignalR。或者在工具栏中,程序包管理控制台输入如下语句安装SignalR:install-package Microsoft.AspNet.SignalR

2)  添加hub文件
 项目右键新建文件一个文件夹取名为Hubs,在该文件夹下新建一个Signalr集线类(v2),ChatHub类得上面自定义HubName,然后在 startup文件里配置hub路径,默认得HubName是该类名称开头字母小写

3)  建立一个 OWIN Startup 类来配置应用.

 [assembly: OwinStartup(typeof(SignalRChat.Startup))]
namespace SignalRChat
{
public class Startup
{
public void Configuration(IAppBuilder app)
{
app.MapSignalR();
}
}
}

 我的项目结构

使用ASP.NET SignalR实现一个简单的聊天室

Scripts中我只保留了必需用到的几个js,其他不必要的都删除,Model放实体类,common放公共类。SignalRContext类是自定义的一个类,用户保存在线用户的一些连接信息和房间信息等。没有涉及数据库,登陆数据是手动模拟造的数据。

重点在创建的ChatHub集线器中

  [HubName("chatHub")]
public class ChatHub : Hub
{
#region 全局对象
protected static List<UserInfo> userInfoList = new List<UserInfo>();
protected static SignalRContext DbContext = new SignalRContext();
protected static List<ChatHistory> chatHistoryList = new List<ChatHistory>();
#endregion #region 连接 /// <summary>
/// 客户端重连接时
/// </summary>
/// <returns></returns>
public override Task OnConnected()
{
AddUserGroup();//添加用户组
UpdateAllRoomList();//更新房间列表 return base.OnConnected();
}
/// <summary>
/// 断线
/// </summary>
/// <param name="stopCalled"></param>
/// <returns></returns>
public override Task OnDisconnected(bool stopCalled)
{
return base.OnDisconnected(stopCalled);
}
#endregion

1)前端引用自动生成得集线器代理对象

var chat = $.connection.chatHub;注意红色标明得注意取 HubName中得名称,如果hubname没注释,就取集线器类中得类名首字母小写。

2) 开始连接服务器
   $.connection.hub.start().done(function () {  });

公共聊天方法

  #region 公共聊天

         /// <summary>
/// 公共聊天
/// </summary>
/// <param name="message"></param>
/// <param name="name"></param>
public void PublicSendMsg(string message, string userId)
{
var user = userInfoList.FirstOrDefault(x => x.UserID == userId);
Clients.All.sendPublicMessage(user.UserID, user.UserName, message);
AddChatHistory(ChatType.PubChat,user.UserName, message, user.UserID,"");//添加历史记录
}
#endregion

一对一聊天方法

  /// <summary>
/// 发送私聊消息
/// </summary>
/// <param name="sendName">发送名称</param>
/// <param name="userId">用户id</param>
/// <param name="message">消息</param>
public void SendPrivateMsg(string sendName, string userId, string message)
{
var toUser = userInfoList.FirstOrDefault(x => x.UserID == userId);//接收用户信息
var fromUser = userInfoList.FirstOrDefault(x => x.ConnectionId == Context.ConnectionId);//发送用户信息
if (toUser != null && fromUser != null)
{
Clients.Caller.showMsgToPages(fromUser.UserID, sendName, message);
if (fromUser.UserID != userId)//判断是否是自己给自己发消息
{
Clients.Client(toUser.ConnectionId).remindMsg(fromUser.UserID, fromUser.UserName,message);
}
AddChatHistory(ChatType.PriChat, sendName, message, fromUser.UserID, userId, "");
}
}

多对多聊天,群聊方法

  /// <summary>
/// 创建聊天室
/// </summary>
/// <param name="roomName"></param>
public void CreateRoom(string roomName)
{
var room = DbContext.Rooms.Find(x => x.RoomName == roomName);
if (room == null)
{
var rom = new ChatRoom
{
RoomName = roomName,
RoomId = Guid.NewGuid().ToString().ToUpper()
};
DbContext.Rooms.Add(rom);//加入房间列表
UpdateAllRoomList();//更新房间列表
Clients.Client(Context.ConnectionId).showGroupMsg("success");
}
else
{
Clients.Client(Context.ConnectionId).showGroupMsg("error");
}
} /// <summary>
///加入聊天室
/// </summary>
public void JoinRoom(string roomId,string current_Id)
{
// 查询聊天室,
var room = DbContext.Rooms.Find(x => x.RoomId == roomId.Trim());
var u = userInfoList.Find(x => x.UserID == current_Id);
if (room != null)
{
//检测该用户是否存在在该房间
var isExistUser = room.Users.Find(x => x.UserConnectionId == Context.ConnectionId);
if (isExistUser == null)
{
var user = DbContext.Users.Find(x => x.UserConnectionId == Context.ConnectionId);
user.Rooms.Add(room);//用户信息中加入房间信息
room.Users.Add(user);//房间信息中加入用户信息
Groups.Add(Context.ConnectionId, room.RoomName);//添加到组中
Clients.Group(room.RoomName, new string[]).showSysGroupMsg(u.UserName);
}
}
else
{
Clients.Client(Context.ConnectionId).showMessage("该群组不存在");
}
} /// <summary>
/// 给指定房间内的所有用户发消息
/// </summary>
/// <param name="room">房间名</param>
/// <param name="message">消息</param>
public void SendMessageByRoom(string roomId, string current_Id, string message)
{
var room = DbContext.Rooms.FirstOrDefault(x=>x.RoomId==roomId);
var user = userInfoList.Find(x => x.UserID == current_Id);
if (room != null && user != null)
{
Clients.Group(room.RoomName, new string[]).showGroupByRoomMsg(user.UserName,room.RoomId, message);
AddChatHistory(ChatType.GroChat, user.UserName, message, user.UserID, "", room.RoomId);
}
} /// <summary>
/// 退出房间
/// </summary>
public void RemoveRoom(string roomId)
{
var room = DbContext.Rooms.Find(x => x.RoomId == roomId);
if (room != null)
{
var user = DbContext.Users.Find(x => x.UserConnectionId == Context.ConnectionId);
room.Users.Remove(user);//从房间里移除该用户
if (room.Users.Count <= )
{
DbContext.Rooms.Remove(room);//如果房间里没人了,删除该房间
}
Groups.Remove(Context.ConnectionId, room.RoomName);
UpdateAllRoomList();//更新房间列表
Clients.Client(Context.ConnectionId).removeRoom();
}
else
{
Clients.Client(Context.ConnectionId).showMessage("该房间不存在");
}
}

前端调用后台代码,使用  chat.server.方法名(参数1,参数2) 例如

   // 开始连接服务器
$.connection.hub.start().done(function () {
$('#btnSend').click(function () {
var msg = $('#textMessage').val().trim();
if (msg == "" || msg == undefined || msg == null) {
alert("请输入聊天信息");
$('#textMessage').focus();
} else {
// 调用服务器端集线器的Send方法
chat.server.publicSendMsg(msg, current_userid);
// 清空输入框信息并获取焦点
$('#textMessage').val('').focus();
}
});

后台调用前端的代码。使用 chat.client.方法名。例如

  //显示新用户加入消息
chat.client.showJoinMessage = function (nickName) {
$("#js-panel-content").append('<div class="js-time text-white text-center"><span>' + nickName + '加入了聊天</span></div>');
}

最后还有个保存和获取聊天记录的主要方法

 1        // <summary>
/// 获取历史记录
/// </summary>
/// <param name="chatType">消息类型0公共聊天,1好友,2群</param>
/// <param name="toId">接收者id</param>
/// <param name="frmId">发送方id</param>
/// <param name="roomId">房间id</param>
public void GetChatHistory(int chatType =(int)ChatType.PubChat,string toId="", string frmId="",string roomId="")
{
var list = chatHistoryList;
var type = (ChatType)chatType;
switch (type)
{
case ChatType.PubChat:
list = chatHistoryList.Where(x => x.ChatType == type).ToList();
break;
case ChatType.PriChat:
//自己发送给对方的,和对方发给自己的数据集合
list = chatHistoryList.Where(x => x.ChatType == type && ((x.toId == toId && x.frmId == frmId) || (x.toId == frmId && x.frmId == toId))).ToList();
break;
case ChatType.GroChat:
list = chatHistoryList.Where(x => x.ChatType == type && x.RoomId == roomId).ToList();
break;
default:
list = new List<ChatHistory>();
break;
}
var data = JsonHelper.ToJsonString(list);
var user = userInfoList.FirstOrDefault(x=>x.UserID== frmId);
var conid = Context.ConnectionId;
if (user != null)
{
conid = user.ConnectionId;
}
Clients.Client(conid).initChatHistoryData(data, chatType);
}
/// <summary>
/// 添加历史记录数据
/// </summary>
/// <param name="name"></param>
/// <param name="message"></param>
/// <param name="chatType">0公共聊天,1私聊,2群聊</param>
public void AddChatHistory(ChatType chatType = ,string userName="", string message="", string frmId="",string toId="",string roomId="")
{
ChatHistory history = new ChatHistory()
{
Hid = Guid.NewGuid().ToString().ToUpper(),
ChatType = chatType,
Message = message,
UserName = userName,
frmId = frmId,
toId = toId,
RoomId = roomId
};
 chatHistoryList.Add(history);  以上就是一些主要核心代码。分享给大家共同学习,共同进步,代码方面欢迎各位大佬指点。
后期补充:github地址

ASP.NET SignalR+MVC+BootStrap:https://github.com/wyanmei/SignalRChat前后端分离的部分,我做成了两个项目,ASP.NET SignalR+WepApi+BootStrap+Vue.js
WebApi后端项目地址:https://github.com/wyanmei/SignalRChatForWebApi
Vue.js前端项目地址:https://github.com/wyanmei/SignalRChatForVue

上一篇:各种数据库连接字符串 -- c#


下一篇:MFC-[转]基于MFC的ActiveX控件开发