一、前言
上次我们讲到过如何在ASP.NET Core中使用WebSocket 。这次的主角是SignalR它为我们提供了简化操作WebSocket的框架。
ASP .NET SignalR 是一个ASP.NET 下的类库,可以在ASP.NET 的Web项目中实现实时通信。什么是实时通信的Web呢?就是让客户端(Web页面)和服务器端可以互相通知消息及调用方法,当然这是实时操作的。WebSockets是HTML5提供的新的API,可以在Web网页与服务器端间建立Socket连接,当WebSockets可用时(即浏览器支持Html5)SignalR使用WebSockets,当不支持时SignalR将使用其它技术来保证达到相同效果。
SignalR当然也提供了非常简单易用的高阶API,使服务器端可以单个或批量调用客户端上的JavaScript函数,并且非常 方便地进行连接管理,例如客户端连接到服务器端,或断开连接,客户端分组,以及客户端授权,使用SignalR都非常容易实现。
二、SignalR目前情况
我们知道在ASP.NET Core 1.0.x 版本中并没有包含SignalR,但是SignalR技术计划集成在ASP.NET Core 1.2版本中,并且它的开发团队还要使用TypeScript对它的javascript客户端进行重写,服务端方面也会贴近ASP.NET Core的开发方式,比如会集成到ASP.NET Core依赖注入框架中。
目前的情况就是在1.0中无法使用SignalR技术,本文实现的Demo都是在1.1下进行的。
三、集成SignalR
当然ASP.NET Core 1.2离正式发布还有一段时间,目前想集成SignalR都不是现成的方案,我们要通过手动的方式集成SignalR。
要在ASP.NET Core中使用SignalR,要先引用Microsoft.AspNetCore.SignalR.Server 、 Microsoft.AspNetCore.WebSockets 的NuGet Package包。
当然上面也说过目前没有ASP.NET Core没有集成SignalR,所以NUGET上也找不到SignalR的程序包,想添加引用我们就得去MyGet上去找找。
1.添加NuGet源
在程序根目录新建一个命为NuGet.Config的文件内容如下:
1
2
3
4
5
6
7
8
|
<? xml version = "0" encoding = "utf-8" ?> < configuration > < packageSources > < clear /> </ packageSources > </ configuration > |
当然我们也可以通过在Visual Studio中设置 NuGet Packages的源,来引用这个程序集。
2.在project.json添加引用
1
2
|
"MicrosoftAspNetCoreSignalRServer" : "0-*" , "MicrosoftAspNetCoreWebSockets" : "0-*" |
可以注意到SignalR的版本是0.2.0的alpha版本,所以后续版本可能变化也会比较大! 听说是好重写的。
值得注意的是,SignalR目前只能在ASP.NET Core 1.1及以上版本上使用,在这个文章中我使用的.NET Core SDK版本为 1.0.0-preview2-003131 ,所以引用有问题的同学可以尝试把CoreApp版本改为1.1,所有AspNetCore的程序集也都改变为1.1的版本。
3.添加配置代码
我们需要在Startup类中的 ConfigureServices方法中添加如下代码:
1
2
3
4
5
6
7
|
public void ConfigureServices(IServiceCollection services) { servicesAddSignalR(options => { optionsHubsEnableDetailedErrors = true ; }); } |
在Startup类中的Configure方法中添加如下代码:
1
2
|
appUseWebSockets(); appUseSignalR(); |
4.添加一个HUB类
这里我们只实现一个小Demo,一个简单的聊天室,多个人进入可以看到各自发送的信息:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
public class ChatHub : Hub { public static List< string > ConnectedUsers; public void Send( string originatorUser, string message) { ClientsAllmessageReceived(originatorUser, message); } public void Connect( string newUser) { if (ConnectedUsers == null ) ConnectedUsers = new List< string >(); ConnectedUsersAdd(newUser); ClientsCallergetConnectedUsers(ConnectedUsers); ClientsOthersnewUserAdded(newUser); } } |
5.客户端支持
在wwwroot目录下创建一个名为chat.html的Html静态文件,内容如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
<!DOCTYPE html> <html> <head> <title>Awesome Chat Application</title> <meta charset= "utf-8" /> </head> <body> <style type= "text/css" > userListDiv{ float: right; } </style> <ul id= "messages" ></ul> <input type= "text" id= "messageBox" /> <input type= "button" id= "sendMessage" value= "Send Message!" /> <div class= "userListDiv" > <ul id= "userList" > </ul> </div> <script src= "signalr/hubs" ></script> <script src= "chatjs" ></script> </body> </html> |
同目录下建立一个chat.js添加要实现功能的脚本:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
|
var userName = prompt( "Enter your name: " ); var chat = $connectionchatHub; chatclientmessageReceived = function (originatorUser, message) { $( "#messages" )append( '<li><strong>' + originatorUser + '</strong>: ' + message); }; chatclientgetConnectedUsers = function (userList) { for ( var i = 0; i < userListlength; i++) addUser(userList[i]); }; chatclientnewUserAdded = function (newUser) { addUser(newUser); } $( "#messageBox" )focus(); $( "#sendMessage" )click( function () { chatserversend(userName, $( "#messageBox" )val()); $( "#messageBox" )val( "" ); $( "#messageBox" )focus(); }); $( "#messageBox" )keyup( function (event) { if (eventkeyCode == 13) $( "#sendMessage" )click(); }); function addUser(user){ $( "#userList" )append( '<li>' + user + '</li>' ); } $connectionhublogging = true ; $connectionhubstart()done( function () { chatserverconnect(userName); }); |
最后我们来运行它吧:
四、最后
附上一个可用的Demo:AspNetCore.SignalRDemo.rar
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:http://www.cnblogs.com/maxzhang1985/p/6364588.html