ASP.NET Core SignalR :学习消息通讯,实现一个消息通知
什么是 SignalR
目前我用业余时间正在做一个博客系统,其中有个功能就是评论通知,就是假如A用户评论B用户的时候,如果B用户首页处于打开状态,那么就会提示B用户有未读消息。暂时用SignalR来实现这个功能。我也是看了两天的资料才明白怎么去使用。
关于SignalR的理论知识可以去官网或者百度,我这里只是结合自己的功能来分享下,如果有错,请原谅指出。
下载js
SignalR是需要微软提供的js,因为我的项目是前后端分离的,所以我是单独下载到一个文件夹,然后复制js到我的前端项目里。只需要signalr.js
页面加载创建连接
//创建连接
var connection = new signalR.HubConnectionBuilder().withUrl('http://127.0.0.1:5000/chatHub').build();
//ajax执行成功执行
首先你要了解到SignalR基本运行的原理,官网:https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/signalr?view=aspnetcore-3.1&tabs=visual-studio
你可以直接继承Hub这个类,我这里用的是强类型Hub<T>,我就是为了让前端和后端统一下。刚开始Hub<T>我纠结了好久,不知道怎么用,最后我手动做了下,认为它只是为了方便前端和后端统一。
如果你只是简单的继承Hub类,你就必须调用SendAsync方法,并且指定前端接收触发的方法名称“InvokeMessage”,如果你后端和前端名字对应不上,就会有问题。
public class SingalrService : Hub { private ISingalrSvc _singalrSvc; public SingalrService(ISingalrSvc singalrSvc) { _singalrSvc = singalrSvc; } public async Task SendMessageAsync(Message sendMessage) { await Clients.All.SendAsync("InvokeMessage",sendMessage); } public void SetConnectionMaps(string account) { string connectionid = Context.ConnectionId; _singalrSvc.SetConnectionMaps(connectionid, account); } public override Task OnDisconnectedAsync(Exception exception) { _singalrSvc.Remove(Context.ConnectionId); return base.OnDisconnectedAsync(exception); } }
所以有了强类型Hub<T>,自己定义一个接口,提过方法InvokeMessage供前前端调用。
/// <summary> /// 客户端js调用方法 /// </summary> public interface ISingalrClient { Task InvokeMessage(Message sendMessage); } public class SingalrService : Hub<ISingalrClient> { private ISingalrSvc _singalrSvc; public SingalrService(ISingalrSvc singalrSvc) { _singalrSvc = singalrSvc; } public void SetConnectionMaps(string account) { string connectionid = Context.ConnectionId; _singalrSvc.SetConnectionMaps(connectionid, account); }
//连接中断时执行,微软这样描述的:
//重写OnDisconnectedAsync
虚方法,以便在客户端断开连接时执行操作。 如果客户端故意断开连接(例如,通过调用connection.stop()
),exception
参数将null
。
//但是,如果客户端由于错误(例如网络故障)而断开连接,则exception
参数将包含描述失败的异常 public override Task OnDisconnectedAsync(Exception exception) { _singalrSvc.Remove(Context.ConnectionId); return base.OnDisconnectedAsync(exception); } }
这个时候一个用户打开了首页,然后首页有个js方法来初始化连接,同一个页面内的connectionid是一样的,每次刷新或新打开一个窗口的新页面的connectionid是不一样的,并且你刷新页面或者关掉会认为是连接中断,会执行OnDisconnectedAsync方法,这个方法时SingalR自带的,它是个虚方法,你也可以重写,就像我一样。我这里的代码逻辑是将连接id和当前登录人作为键值对存入内存,然后用户关掉页面就会执行OnDisconnectedAsync方法,将相关的coonectionid从内存删掉:
layui.use(['element', 'layer'], function () {
var element = layui.element; element.render('nav'); initLoad();
//初始化连接,每个页面的connection的connectionid是一样的,但是每次创建的不一样 var connection = new signalR.HubConnectionBuilder().withUrl('http://127.0.0.1:5000/chatHub').build();
//绑定后台触发的方法,前面已经讲过了,具体业务还没实现, connection.on('InvokeMessage', (reviceMessage) => { var v = reviceMessage; }); $.ajax({ url: url + 'user/userInfo', type: 'get', dataType: 'json', beforeSend: function (xhr) { doBeforeSend(xhr); }, success: function (response) { if (response.code == '1') { $("#nologin").show(); $("#user").hide(); } else { $("#nologin").hide(); $("#user").show(); $("#photo").attr('src', response.data.headPhoto);
//连接开始 connection.start().then(function () {
//调用后台方法,不是api接口,将当前登录人账号传过去 connection.invoke('SetConnectionMaps', response.data.account); }) } }, complete: function (xhr) { doComplete(xhr); }, }); });
这个时候连接已经创建完成,并且用户并没有关闭首页,连接一直处于连接状态。这个时候另一个用户打开了一篇文章详情,并且对它评论提交内容后,我让它触发了一个连接SingalR的事件,
form.on('submit(review)', function (data) { loading = layer.load(2); var commentModel = { 'Content': data.field.desc, } $.ajax({ url: url + 'article/review/' + id, contentType: 'application/json; charset=utf-8', type: 'post', datatype: 'json', data: JSON.stringify(commentModel), beforeSend: function (xhr) { doBeforeSend(xhr); }, success: function (response) { if (response.code == 0) { //另一个用户创建了连接 var connection = new signalR.HubConnectionBuilder().withUrl('http://127.0.0.1:5000/chatHub').build(); connection.start().then(function () { var apiRoute=url+'Singalr/admin';//admin是我设置死的,实际应该是自己判断,会调用下面的api,[Route("api/[controller]")],SingalR也是支持api调用的 var token=localStorage.getItem('token'); fetch(apiRoute,{ method:'get', headers:{ 'Authorization':'Bearer ' + token } }) event.preventDefault(); }) layer.close(loading); } else { layer.close(loading); layer.msg("评论失败", { icon: 5 }); } }, complete: function (xhr) { doComplete(xhr); }, })
[ApiController] public class SingalrController : ControllerBase { private IHubContext<SingalrService, ISingalrClient> _hubContext; private ISingalrSvc _singalrSvc; public SingalrController(IHubContext<SingalrService, ISingalrClient> hubContext, ISingalrSvc singalrSvc) { _hubContext = hubContext; _singalrSvc = singalrSvc; } /// <summary> /// 查询未处理数量 /// </summary> /// <param name="account"></param> /// <returns></returns> [HttpGet("{account}")] public async Task NewsCount(string account) { Message sendMessage = new Message(); sendMessage.Data = "11";
//刚已经讲了,用户加载首页的时候已经把connectionid和account存入到了内存里面,现在再取用户相关的connectionID,如果直接调用Clinets.ALL就是给所有客户端发送消息 IReadOnlyList<string> connectionIds = (IReadOnlyList<string>)_singalrSvc.GetConnectionIds(account); await _hubContext.Clients.Clients(connectionIds).InvokeMessage(sendMessage); } }
这个时候调用了这个api执行了里面的_hubContext.Clients.Clients(connectionIds).InvokeMessage(sendMessage),connectionIds是根据业务逻辑所判断的触发的那些客户端;然后前端会根据方法名响应对应的js代码,如下
layui.use(['element', 'layer'], function () { var element = layui.element; element.render('nav'); initLoad(); var connection = new signalR.HubConnectionBuilder().withUrl('http://127.0.0.1:5000/chatHub').build();
//我认为是一个用来侦听服务端方法的js connection.on('InvokeMessage', (reviceMessage) => { var v = reviceMessage;
//响应后端方法成功后,就开始自己的业务逻辑 }); $.ajax({ url: url + 'user/userInfo', type: 'get', dataType: 'json', beforeSend: function (xhr) { doBeforeSend(xhr); }, success: function (response) { if (response.code == '1') { $("#nologin").show(); $("#user").hide(); } else { $("#nologin").hide(); $("#user").show(); $("#photo").attr('src', response.data.headPhoto); connection.start().then(function () { connection.invoke('SetConnectionMaps', response.data.account); }) } }, complete: function (xhr) { doComplete(xhr); }, }); });
游戏也能赚钱?如果你热爱游戏,并且想通过游戏赢得零花钱,5173是个不错的选择 http://www.5173.com/?recommenduserid=US15061749098191-04F6