Asp.NET MVC 使用 SignalR 实现推送功能一(Hubs 在线聊天室)
简介
使用
很多新的技术没有必要非得理解,只需要知道你的应用环境可以用这项技术很简便的去实现,用的多了,用的久了,自然而然就会慢慢的理解这项技术的原理了。
今天我们一步一步来介绍一下如何使用SignalR,这一篇文章介绍的是使用Hubs SignalR集线器去实现,下一篇我们将介绍使用SignalR永久连接类去实现,我们做个简单的聊天室。
先给大家贴一下Demo的效果图:
一、准备:
SignalR 运行在 .NET 4.5 平台上,所以需要安装 .NET 4.5。为了方便演示,本示例使用 ASP.NET MVC 在 Win 7 系统来实现。这需要安装 ASP.NET MVC 3 或 ASP.NET MVC 4。
二:Hubs代码示例:
1、首先我们创建一个MVC项目工程名字叫做SignalR_Chat
2、然后打开 工具 - NuGet程序包管理器 - 程序包管理器控制台
3、安装SignalR
输出NuGet命令:Install-Package Microsoft.AspNet.SignalR
安装成功后我们发现我们的bin里已经添加了我们需要的组件,并且在Scripts文件夹下添加了SignalR的Jquery引用
4、我们新建一个文件夹叫Hubs,然后添加SignalR集线器类ChatHub.cs
在上面的代码中:
(1)HubName 这个特性是为了让客户端知道如何建立与服务器端对应服务的代理对象,如果没有设定该属性,则以服务器端的服务类名字作为 HubName 的缺省值;
(2)Chat 继承自 Hub,从下面 Hub 的接口图可以看出:Hub 支持向发起请求者(Caller),所有客户端(Clients),特定组(Group) 推送消息。
5、添加OWIN Startup Class
修改 Configuration方法
using Microsoft.Owin;
using Owin;
using SignalR_Chat.Connections; [assembly: OwinStartupAttribute(typeof(SignalR_Chat.Startup))]
namespace SignalR_Chat
{
public partial class Startup
{
public void Configuration(IAppBuilder app)
{
app.MapSignalR();
//这个是下一篇永久连接类的 我们先不用
//app.MapSignalR<MyConnection>("/echo");
}
}
}
6、我们实现一个聊天室,代码我是分步贴出来的,后面我会附上完整的代码和Demo。
首先,我们新建一个类 标记用户和在线状态
public class OnlineUserInfo
{
//用户ID
public string UserId { get; set; }
//用户连接ID
public string ConnectionId { get; set; }
//用户昵称
public string UserNickName { get; set; }
//用户头像
public string UserFaceImg { get; set; }
//用户状态
public string UserStates { get; set; }
}
然后,我们在ChatHub中实例化一下这个类
/// <summary>
/// 这个是通过Hub集线器 大家可以参考 Connections下的 MyConnection 永久连接
/// </summary>
[HubName("chat")]
public class ChatHub : Hub
{
static List<OnlineUserInfo> UserList = new List<OnlineUserInfo>();
}
我们写一个用户连接时注册一个群组,用户后面的组播
/// <summary>
/// 注册群组 注册用户信息
/// </summary>
/// <param name="groupid">群组ID</param>
/// <param name="usernickname">用户昵称</param>
/// <param name="userfaceimg">用户头像</param>
/// <param name="userid">用户在网站中的唯一标识ID</param>
public void Group(string groupid, string usernickname, string userfaceimg, string userid)
{
//添加用户到群组 Groups.Add(用户连接ID,群组)
Groups.Add(Context.ConnectionId, groupid); //如果说是一个简单的聊天室 下面这段代码是没有什么作用的 因为Context.ConnectionId是唯一的用户于服务器之间的连接
//这里我传递进来了 用户的昵称和头像 还有网站中用户的ID 所以我要把用户的信息添加到我们上面建立的那个列表类中 //如果用户不存在在线列表中
if (UserList.Where(p => p.UserId == userid).FirstOrDefault() == null)
{
//我们在列表中 添加这个用户 并且标记用户在线 UserStates = "True"
UserList.Add(new OnlineUserInfo() { UserId = userid, ConnectionId = Context.ConnectionId, UserNickName = usernickname, UserFaceImg = userfaceimg, UserStates = "True" });
}
//如果用户已经存在于在线列表中
else
{
//我们更新用户列表中用户的信息 (这里更新的信息主要是用户的连接ID ConnectionId = Context.ConnectionId)
var UserInfo = UserList.Where(p => p.UserId == userid).FirstOrDefault();
UserList.Remove(UserInfo);
UserList.Add(new OnlineUserInfo() { UserId = userid, ConnectionId = Context.ConnectionId, UserNickName = usernickname, UserFaceImg = userfaceimg, UserStates = "True" });
}
//这个方法是调用客户端LoginUser方法 并且传递当前用户列表 客户端会刷新当前用户列表 调用的是全部的已连接的用户 Clients.All
Clients.All.LoginUser(Common.JsonConverter.Serialize(UserList));
//这个方法是调用客户端的 addNewMessageToPage方法 目的是实现 当一个用户上线是 提醒所有的用户 某个用户上线了 提醒的是所有的已连接用户 所以也是Clients.All
Clients.All.addNewMessageToPage("<dl class=\"messageTip clearfix\"><dt></dt><dd>系统消息:" + DateTime.Now.ToString("HH:mm:ss") + " " + usernickname + " 上线了<dd></dl>");
}
为了方便大家理解,我这里就先把客户端的LoginUser和addNewMessageToPage方法贴出来,让大家好理解服务器是怎样调用客户端的js方法的
//接收服务器信息
chat.client.addNewMessageToPage = function (message) {
//#chatContent就是一个div层 我们把服务器返回的信息追加到这个层上 跟QQ聊天相反,新的信息我们追加顶部
$('#chatContent').prepend(message);
};
//服务器端调用的LoginUser方法,根据返回的用户列表 输出用户列表到页面上
chat.client.LoginUser = function (UserList) {
//在下一篇介绍的持久连接类中 是可以直接返回Json的 这里不知道怎么回事 接收的Json总是被接收成字符串 所以这里我们解析一下
var data = eval("(" + UserList + ")");
var html = "";
for(var i=;i<data.length;i++)
{
//这里我们做了一个判断 就是 解析用户列表Json时 如果用户的ID 就是当前用户的ID 那么就不添加 这跟QQ不一样啊 QQ中好友列表中是有自己的
if (data[i].UserId != $("#Juser-userid").val()) {
//如果用户的在线状态是在线呢 我们就添加onclick方法 实现 点击用户的用户 可以私聊 如果不在线 就不添加了 因为我们这个是没有存数据库的 所以没有做离线消息
if (data[i].UserStates == "True") {
html += "<dl onclick=\"javascript:sendPerMessage('" + data[i].ConnectionId + "','" + data[i].UserNickName + "')\" class=\"clearfix tab-item-1\"><dt><img src=\"" + data[i].UserFaceImg + "\"></dt><dd>" + data[i].UserNickName + "</dd></dl>";
}
else
{
html += "<dl onclick=\"javascript:void(0)\" class=\"clearfix tab-item-1 liveout\"><dt><img src=\"" + data[i].UserFaceImg + "\"></dt><dd>" + data[i].UserNickName + "</dd></dl>";
}
}
}
//更新页面用户列表
$("#OnlineUsers").html(html);
};
这里注意的是服务器调用的客户端方法跟客户端写的JS方法大小写是一样的,后面我们介绍客户端调用服务器方法的时候会将 客户端调用服务器方法的时候 服务器方法的首字母是小写的,这里提醒一下。
下面是我们的发送消息的方法,当我发送消息的时候 传递我的头像和昵称给服务器 让别人显示消息的时候能显示出谁发送的(这个跟QQ消息类似啊 方便大家理解)
一个是群组消息当然也可以是全部消息,另一个是私聊,就是指定发送个某一个用户
/// <summary>
/// 发送消息 自定义判断是发送给全部用户还是某一个组(类似于群聊啦)
/// </summary>
/// <param name="groupid">接收的组</param>
/// <param name="userfaceimg">发送用户的头像</param>
/// <param name="usernickname">发送用户的昵称</param>
/// <param name="message">发送的消息</param>
public void Send(string groupid, string userfaceimg, string usernickname, string message)
{
if (groupid == "All")//全部用户(广播)
{
//调用所有客户端的addNewMessageToPage方法 推送一条消息
Clients.All.addNewMessageToPage("<dl class=\"clearfix\"><dt><img src=\"" + userfaceimg + "\" /></dt><dd><i></i><div class=\"J_Users\">" + usernickname + "</div><div class=\"J_Content\">" + message + "</div></dd></dl>");
}
else//指定组(组播)
{
//调用指定客户端的addNewMessageToPage方法 推送一条消息(所有属于组groupid的已连接用户)
Clients.Group(groupid).addNewMessageToPage("<dl class=\"clearfix\"><dt><img src=\"" + userfaceimg + "\" /></dt><dd><i></i><div class=\"J_Users\">" + usernickname + "</div><div class=\"J_Content\">" + message + "</div></dd></dl>");
}
} /// <summary>
/// 发送给指定用户(单播)
/// </summary>
/// <param name="clientId">接收用户的连接ID</param>
/// <param name="userfaceimg">发送用户的头像</param>
/// <param name="usernickname">发送用户的昵称</param>
/// <param name="message">发送的消息</param>
public void SendSingle(string clientId, string userfaceimg, string usernickname, string message)
{
//首先我们获取一下接收用户的信息
var UserInfo = UserList.Where(p => p.ConnectionId == clientId).FirstOrDefault();
//如果用户不存在或用户的在线状态为False 那么提醒一下 发送用户 对方不在线
if (UserInfo == null || UserInfo.UserStates == "False")
{
Clients.Client(Context.ConnectionId).addNewMessageToPage("<dl class=\"messageTip clearfix\"><dt></dt><dd>系统消息:当前用户不在线<dd></dl>");
}
else
{
//如果用户存在并且在线呢 就把消息推送给接收的用户 并且加上当前用户信息 以及添加一个onclick事件 让接收的用户 可以直接点击消息的用户 回复 私聊信息 (不然还要在用户列表中找到谁给我发的消息 点击回复 这不科学...)
Clients.Client(clientId).addNewMessageToPage("<dl class=\"clearfix\"><dt onclick=\"javascript:sendPerMessage('" + Context.ConnectionId + "','" + usernickname + "')\"><img src=\"" + userfaceimg + "\" /></dt><dd class=\"per\"><s></s><div onclick=\"javascript:sendPerMessage('" + Context.ConnectionId + "','" + usernickname + "')\" class=\"J_Users\">" + usernickname + "<span>私聊</span></div><div class=\"J_Content\">" + message + "</div></dd></dl>");
//这句是发送给发送用户的 总不能我发送个私聊 对方收到了信息 我这里什么都不显示是吧 我也显示我发送的私聊信息 因为发送发就是我自己 所以不加onclick事件了 不允许自己跟自己聊天哦
Clients.Client(Context.ConnectionId).addNewMessageToPage("<dl class=\"clearfix\"><dt><img src=\"" + userfaceimg + "\" /></dt><dd class=\"per\"><s></s><div class=\"J_Users\">" + usernickname + "<span>私聊</span></div><div class=\"J_Content\">" + message + "</div></dd></dl>");
}
}
这里我贴一下前台代码
$.connection.hub.start().done(function () {
//用户连接时 注册一下群组和个人信息哦 这个的服务器代码 我们上面贴出来了
//这个Demo是为了让大家理解SigalR所以没有做多复杂的流程 个人信息 我是直接传递的
//$("#groupid").val()这个是要注册的群组,可以自己定义 组播的时候 只要是在这一个组里的都会收到
//$("#Juser-login").val()这个是发送方也就是我的昵称
//$("#Juser-faceimg").val()这个是我的头像
//$("#Juser-userid").val()这个是我在网站中的唯一标识ID,用户连接的ID(Context.ConnectionId)也是唯一的,那么为什么还要我在这个网站中的ID呢?
//解释一下子:单页面的聊天室是没有多大必要的,但是比如我们这个功能是放到公用里的,就像网站的在线客服一样,你总不能每个页面都写一套吧 既然是引用的这一个页面
//那么用户打开其他页面的时候 这个Context.ConnectionId是会变的,那我怎么知道这又是谁呢 我们就用用户在网站中的唯一标识ID作为参照,当新的连接进来时 我们看下是不是ID一样
//一样的话我们就更新用户列表中这个唯一标识ID用户的Context.ConnectionId和在线状态 不一样的话就添加新用户
chat.server.group($("#groupid").val(), $("#Juser-login").val(), $("#Juser-faceimg").val(), $("#Juser-userid").val());
$('.sendBtn').click(function () {
//这里做一下判断 如果没有输入消息就发送 那么提示一下
if ($('#MessageBox').val().length <= )
{
$('#chatContent').prepend("<dl class=\"messageTip clearfix\"><dt></dt><dd>系统消息:请输入信息<dd></dl>");
}
else
{
//sendToConnectId 是我们自定义的一个字段 如果你点击了某一个用户 那么就把他的ConnectionId赋给sendToConnectId 我们知道是私聊
//当然,用户点击退出私聊的时候 这个字段会被赋为空 表示是群聊 这个大家在Demo中一看就明白了
if (sendToConnectId != "" && sendToConnectId.length > ) {
//调用服务器私聊方法 !!!注意啊!!!服务器的私聊方法是 public void SendSingle(string clientId, string userfaceimg, string usernickname, string message)
//这里是chat.server.sendSingle 首字母小写啊 客户端调用的服务器方法首字母要小写 服务器调用的客户端方法 大小写一致
chat.server.sendSingle(sendToConnectId, $("#Juser-faceimg").val(), $("#Juser-login").val(), $('#MessageBox').val());
$('#MessageBox').val("").focus();
}
else {
//这里是群聊 我们演示的没有做群组聊天 所以这里传递的是"All"表示 全部,会发送给全部用户
//说明一下方便理解:比如我们有这么一个情景,这个聊天是一个讨论,对某一篇文章或产品的讨论,那么是不是应该只在这篇文章或这个产品页面的用户才能收发属于这篇文章或产品消息呢,在其他页面
//的用户不应该能收发这里的消息呀 那么我们上面的代码chat.server.group中传递的groupid就应该是某篇文章或产品的标识,把他们划分到一个组里比如chat.server.group("A123")一个自定义字符串加上文章或产品ID,
//或直接用文章或产品的IDchat.server.group("123") 这里就chat.server.send("123", ...);就实现了 只有在这个页面中的用户才能收到此消息 就跟QQ的群是一样的
chat.server.send("All", $("#Juser-faceimg").val(), $("#Juser-login").val(), $('#MessageBox').val());
$('#MessageBox').val("").focus();
}
}
});
});
使用者离线或重新连接 重写Hub的方法
//使用者离线
public override Task OnDisconnected(bool stopCalled)
{
var UserInfo = UserList.Where(p => p.ConnectionId == Context.ConnectionId).FirstOrDefault();
var userid = UserInfo.UserId;
var usernickname = UserInfo.UserNickName;
var userfaceimg = UserInfo.UserFaceImg;
UserList.Remove(UserInfo);
UserList.Add(new OnlineUserInfo() { UserId = userid, ConnectionId = Context.ConnectionId, UserNickName = usernickname, UserFaceImg = userfaceimg, UserStates = "False" }); Clients.All.LoginUser(Common.JsonConverter.Serialize(UserList));
Clients.All.addNewMessageToPage("<dl class=\"messageTip clearfix\"><dt></dt><dd>系统消息:" + DateTime.Now.ToString("HH:mm:ss") + " " + usernickname + " 离线了<dd></dl>"); return base.OnDisconnected(true);
} //使用者重新连接
public override Task OnReconnected()
{
var UserInfo = UserList.Where(p => p.ConnectionId == Context.ConnectionId).FirstOrDefault();
if (UserInfo != null)
{
var userid = UserInfo.UserId;
var usernickname = UserInfo.UserNickName;
var userfaceimg = UserInfo.UserFaceImg;
UserList.Remove(UserInfo);
UserList.Add(new OnlineUserInfo() { UserId = userid, ConnectionId = Context.ConnectionId, UserNickName = usernickname, UserFaceImg = userfaceimg, UserStates = "True" });
Clients.All.LoginUser(Common.JsonConverter.Serialize(UserList));
}
return base.OnReconnected();
}
还有一些辅助的JS方法,在这里我就不一一贴出来了,我把demo地址留给大家 ,大家可以搭建起来研究一下。
这篇文章仅仅是个人的一些理解和实现,可能中间会出现一些不合理的地方或是错误,请大家指正,我们共同学习研究。
Demo是用VS 2013写的
下载:百度网盘
补充:Demo是我写这个博客之前写的 没有用到HubName 这个特性 所以Demo跑起来会有错误 大家删除这个特性就没有错误了 在Hubs文件夹下的ChatHub.cs
原创文章 转载请尊重劳动成果 http://yuangang.cnblogs.com
Asp.NET MVC 使用 SignalR 实现推送功能一(Hubs 在线聊天室)的更多相关文章
- Asp.NET MVC 使用 SignalR 实现推送功能二(Hubs 在线聊天室 获取保存用户信息)
简单介绍 关于SignalR的简单实用 请参考 Asp.NET MVC 使用 SignalR 实现推送功能一(Hubs 在线聊天室) 在上一篇中,我们只是介绍了简单的消息推送,今天我们来修改一下,实现 ...
- Asp.NET websocket,Asp.NET MVC 使用 SignalR 实现推送功能一(Hubs 在线聊天室)
ASP .NET SignalR 是一个ASP .NET 下的类库,可以在ASP .NET 的Web项目中实现实时通信.什么是实时通信的Web呢?就是让客户端(Web页面)和服务器端可以互相通知消息及 ...
- 在 Asp.NET MVC 中使用 SignalR 实现推送功能 [转]
在 Asp.NET MVC 中使用 SignalR 实现推送功能 罗朝辉 ( http://blog.csdn.net/kesalin ) CC许可,转载请注明出处 一,简介 Signal 是微软支持 ...
- MVC 中使用 SignalR 实现推送功能
MVC 中使用 SignalR 实现推送功能 一,简介 Signal 是微软支持的一个运行在 Dot NET 平台上的 html websocket 框架.它出现的主要目的是实现服务器主动推送(Pus ...
- 史上最全面的SignalR系列教程-3、SignalR 实现推送功能-集线器类实现方式
1.概述 通过前两篇 史上最全面的SignalR系列教程-1.认识SignalR 史上最全面的SignalR系列教程-2.SignalR 实现推送功能-永久连接类实现方式 文章对SignalR的介绍, ...
- 使用 SignalR 实现推送功能
百度搜索:使用 SignalR 实现推送功能
- Asp.NET MVC 中使用 SignalR 实现推送功能
一,简介Signal 是微软支持的一个运行在 Dot NET 平台上的 html websocket 框架.它出现的主要目的是实现服务器主动推送(Push)消息到客户端页面,这样客户端就不必重新发送请 ...
- 在 Asp.NET MVC 中使用 SignalR 实现推送功能
一,简介Signal 是微软支持的一个运行在 Dot NET 平台上的 html websocket 框架.它出现的主要目的是实现服务器主动推送(Push)消息到客户端页面,这样客户端就不必重新发送请 ...
- 史上最全面的SignalR系列教程-2、SignalR 实现推送功能-永久连接类实现方式
1.概述 通过上篇史上最全面的SignalR系列教程-1.认识SignalR文章的介绍,我们对SignalR技术已经有了一个全面的了解.本篇开始就通过SignalR的典型应用的实现方式做介绍,例子虽然 ...
随机推荐
- 玩转JavaScript OOP[3]——彻底理解继承和原型链
概述 上一篇我们介绍了通过构造函数和原型可以实现JavaScript中的“类”,由于构造函数和函数的原型都是对象,所以JavaScript的“类”本质上也是对象.这一篇我们将介绍JavaScript中 ...
- Javascript分号,加还是不加?
关于这个问题,网上已经有很多人讨论过了,我先说说自己对这个问题的回答:加!(但非必须) 有些人写代码,懒得加分号,除非是迫不得已才勉强放一个分号上去.如果你可以保证你写的代码不出现任何 bug,那当然 ...
- Mongoose Schemas定义中timestamps选项的妙用
在Node.js中使用MongoDB少不了Mongoose. 假设有如下Mongoose Schemas的定义: var ItemSchema = new mongoose.Schema({ biz: ...
- C语言 · 2的次幂表示
问题描述 任何一个正整数都可以用2进制表示,例如:137的2进制表示为10001001. 将这种2进制表示写成2的次幂的和的形式,令次幂高的排在前面,可得到如下表达式:137=2^7+2^3+2^0 ...
- spring快速入门(一)
对于为什么使用spring框架,这里不多做解释,详情请百度.本人推荐面向驱动程序学习,通过实战来瞧瞧spring技术的伟大.所以先来看看原始开发一个简单的例子,由例子引入spring相关的技术.如果错 ...
- MySQL常用命令和常见问题
MySQL常用命令和常见问题 --创建数据库并设置字符集 create database wip default character set utf8 collate utf8_general_ci; ...
- Entity Framework Core 1.1 Preview 1 简介
实体框架核心(EF Core)是Entity Framework的一个轻量级,可扩展和跨平台版本. 10月25日,Entity Framework Core 1.1 Preview 1发布了. 升级到 ...
- Ajax概要:
Ajax概要: Ajax不是个全新的技术,它是多种技术合并在一起产生的,包括XHTML,CSS,JavaScript,XmlHttpRequest,XML,JSON,DOM等 优点:(这也解释了为何我 ...
- 开源地图SharpMap源码解析-(1)简介
1.简介 SharpMap最新版基于.NET Framework 4,采用C#开发的地图渲染引擎,非常易于使用.我这次研究的是比较稳定发布的V1.1版本.可以在GitHub下载该源码,地址:https ...
- MyEclipse 2014(激活)
激活 破解附件包下载:http://pan.baidu.com/s/1c27Dwe0 提取密码:qy38 详细破解步骤请参考:http://blog.my-eclipse.cn/myeclipse-2 ...