快捷導(dǎo)航

詳解在ASP.NET Core下使用SignalR技術(shù)

更新時(shí)間：2017年02月04日 16:18:20 作者：YOYOFx

本篇文章主要介紹了在ASP.NET Core下使用SignalR技術(shù) ，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

一、前言

上次我們講到過(guò)如何在ASP.NET Core中使用WebSocket 。這次的主角是SignalR它為我們提供了簡(jiǎn)化操作WebSocket的框架。

ASP .NET SignalR 是一個(gè)ASP.NET 下的類(lèi)庫(kù)，可以在ASP.NET 的Web項(xiàng)目中實(shí)現(xiàn)實(shí)時(shí)通信。什么是實(shí)時(shí)通信的Web呢？就是讓客戶(hù)端（Web頁(yè)面）和服務(wù)器端可以互相通知消息及調(diào)用方法，當(dāng)然這是實(shí)時(shí)操作的。WebSockets是HTML5提供的新的API，可以在Web網(wǎng)頁(yè)與服務(wù)器端間建立Socket連接，當(dāng)WebSockets可用時(shí)（即瀏覽器支持Html5）SignalR使用WebSockets，當(dāng)不支持時(shí)SignalR將使用其它技術(shù)來(lái)保證達(dá)到相同效果。

SignalR當(dāng)然也提供了非常簡(jiǎn)單易用的高階API，使服務(wù)器端可以單個(gè)或批量調(diào)用客戶(hù)端上的JavaScript函數(shù)，并且非常方便地進(jìn)行連接管理，例如客戶(hù)端連接到服務(wù)器端，或斷開(kāi)連接，客戶(hù)端分組，以及客戶(hù)端授權(quán)，使用SignalR都非常容易實(shí)現(xiàn)。

二、SignalR目前情況

我們知道在ASP.NET Core 1.0.x 版本中并沒(méi)有包含SignalR，但是SignalR技術(shù)計(jì)劃集成在ASP.NET Core 1.2版本中，并且它的開(kāi)發(fā)團(tuán)隊(duì)還要使用TypeScript對(duì)它的javascript客戶(hù)端進(jìn)行重寫(xiě)，服務(wù)端方面也會(huì)貼近ASP.NET Core的開(kāi)發(fā)方式，比如會(huì)集成到ASP.NET Core依賴(lài)注入框架中。

目前的情況就是在1.0中無(wú)法使用SignalR技術(shù)，本文實(shí)現(xiàn)的Demo都是在1.1下進(jìn)行的。

三、集成SignalR

當(dāng)然ASP.NET Core 1.2離正式發(fā)布還有一段時(shí)間，目前想集成SignalR都不是現(xiàn)成的方案，我們要通過(guò)手動(dòng)的方式集成SignalR。

要在ASP.NET Core中使用SignalR，要先引用Microsoft.AspNetCore.SignalR.Server 、 Microsoft.AspNetCore.WebSockets 的NuGet Package包。

當(dāng)然上面也說(shuō)過(guò)目前沒(méi)有ASP.NET Core沒(méi)有集成SignalR，所以NUGET上也找不到SignalR的程序包，想添加引用我們就得去MyGet上去找找。

1.添加NuGet源

在程序根目錄新建一個(gè)命為NuGet.Config的文件內(nèi)容如下：

<?xml version="0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear/>
      <add key="aspnetcidev" value="https://dotnetmygetorg/F/aspnetcore-ci-dev/api/v3/indexjson"/>
      <add key="apinugetorg" value="https://apinugetorg/v3/indexjson"/>
  </packageSources>
</configuration>

當(dāng)然我們也可以通過(guò)在Visual Studio中設(shè)置 NuGet Packages的源，來(lái)引用這個(gè)程序集。

2.在project.json添加引用

"MicrosoftAspNetCoreSignalRServer": "0-*",
"MicrosoftAspNetCoreWebSockets": "0-*"

可以注意到SignalR的版本是0.2.0的alpha版本，所以后續(xù)版本可能變化也會(huì)比較大！聽(tīng)說(shuō)是好重寫(xiě)的。

值得注意的是，SignalR目前只能在ASP.NET Core 1.1及以上版本上使用，在這個(gè)文章中我使用的.NET Core SDK版本為 1.0.0-preview2-003131 ，所以引用有問(wèn)題的同學(xué)可以嘗試把CoreApp版本改為1.1，所有AspNetCore的程序集也都改變?yōu)?.1的版本。

3.添加配置代碼

我們需要在Startup類(lèi)中的 ConfigureServices方法中添加如下代碼：

public void ConfigureServices(IServiceCollection services)
{
   servicesAddSignalR(options => 
   {
     optionsHubsEnableDetailedErrors = true;
   });
}

在Startup類(lèi)中的Configure方法中添加如下代碼：

appUseWebSockets();
appUseSignalR();

4.添加一個(gè)HUB類(lèi)

這里我們只實(shí)現(xiàn)一個(gè)小Demo，一個(gè)簡(jiǎn)單的聊天室，多個(gè)人進(jìn)入可以看到各自發(fā)送的信息：

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.客戶(hù)端支持

在wwwroot目錄下創(chuàng)建一個(gè)名為chat.html的Html靜態(tài)文件，內(nèi)容如下：

<!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="http://ajaxaspnetcdncom/ajax/jQuery/jquery-minjs"></script>
  <script src="http://ajaxaspnetcdncom/ajax/signalr/jquerysignalr-minjs"></script>
  <script src="signalr/hubs"></script>
  <script src="chatjs"></script>
</body>
</html>

同目錄下建立一個(gè)chat.js添加要實(shí)現(xiàn)功能的腳本：

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);
});

最后我們來(lái)運(yùn)行它吧：