ASP.NET Core SignalR 是微软开发的一套基于ASP.NET Core的与Web进行实时交互的类库，它使我们的应用能够实时的把数据推送给Web客户端。
功能
-
自动管理连接
-
允许同时广播到所有客户端
-
也可以广播到指定的组或者特定的客户端
-
在Github上开源，传送门（https://github.com/aspnet/signalr）
SignalR 提供了多种连接方式，在现代化应用中，WebSocket是最佳的传输协议，在客户端无法实现WebSocket协议的时候，SignalR就会采取其他方式，比如Server-Sent或者长轮询（在ws未出现之前，我们讨论的推拉模式）
中心 Hubs
SignalR是采用中心客户端和服务器进行通讯。
中心是一种高级的管道，允许客户端和服务器之间相互调用方法。
中心通过强类型参数传递给方法，进行模型绑定
Hubs.Clients
Clients属性包含了所有的客户端连接信息，它包含了3个属性：
-
All 所有客户端
-
Caller 进行此次请求的客户端
-
Others 排除此次请求客户端的其他客户端
包含了多个方法：
-
= AllExcept 在指定的连接除外的所有连接的客户端上调用方法
-
Client 在特定连接的客户端上调用方法
-
Clients 在特定连接的客户端上调用方法
-
Group 调用指定的组中的一种对所有连接方法
-
GroupExcept 调用中指定的组，除非指定连接到的所有连接的方法
-
Groups 调用一种对多个组的连接方法
-
OthersInGroup 调用一种对一组的连接，不包括客户端调用 hub 方法方法
-
User 调用一种对与特定用户关联的所有连接方法
-
Users 调用一种对与指定的用户相关联的所有连接方法
每个属性和方法返回的对象都包含一个SendAsync方法，可以对客户端进行调用。
HubContext
可以在应用其他地方通过使用IHubContext，达到调用Hub的目的。
两种协议
-
文本协议：JSON
-
二进制协议：MessagePack（https://msgpack.org/）
MessagePack类似于JSON，但传输比JSON更快，数据大小比JSON更小
服务器事项
-
创建的Hub必须继承Microsoft.AspNetCore.SignalR.Hub,Hub类已经包含了管理连接、组和发送接收消息的属性及事件
-
在Hub中使用的方法应该尽量使用异步的方式，因为SignalR在发送和接收消息的时候使用的是异步方法。
-
在Startup.ConfigureServices中通过services.AddSignalR对SignalR进行注册
-
在Startup.Configure中通过app.UseSignalR方法对Hub路由进行配置
代码解析
微软官方示范（https://docs.microsoft.com/en-us/aspnet/core/tutorials/signalr?view=aspnetcore-2.1&tabs=visual-studio）中的ChatHub：
using Microsoft.AspNetCore.SignalR;
using System.Threading.Tasks;
namespace SignalRChat.Hubs
{
public class ChatHub : Hub
{
//服务端方法
public async Task SendMessage(string user, string message)
{
//ReceiveMessage 为客户端方法，让所有客户端调用这个方法
await Clients.All.SendAsync("ReceiveMessage", user, message);
}
}
}
上述代码为当收到客户端发来的SendMessage请求后（发送聊天信息），我们把消息发送到所有客户端，让他们调用自身的ReceiveMessage方法。
用户标识
通常情况下，在用户进行连接后，Connection会保存用户的用户标识，以便对特定用户进行发送消息。
可以实现IUserIdProvider来自定义获取用户的方法，例如：
public class CustomUserIdProvider : IUserIdProvider
{
public virtual string GetUserId(HubConnectionContext connection)
{
return connection.User?.FindFirst(ClaimTypes.Email)?.Value;
}
}
在Startup.ConfigureServices中注册：
services.AddSingleton<IUserIdProvider, CustomUserIdProvider>();
Client的方法
T All { get; }
相当于持久连接中的 Broadcast。
T AllExcept(params string[] excludeConnectionIds);
给排除本人所有人发送消息。
T Client(string connectionId);
跟Send操作就是一样的了。
T Clients(IList<string> connectionIds);
和Send操作的重载方法一样，可以给一批指定的人发送。
T Group(string groupName, params string[] excludeConnectionIds);
给房间中的指定人发送消息： Clients.Group("room1", "asdfasdfads");
T Groups(IList<string> groupNames, params string[] excludeConnectionIds);
给房间列表中的指定人发送消息； 【天然的聊天室功能】
T User(string userId);
这个和Client是有区别的。 这个userId =＞ this.Context.Request.User.Identity.Name 【form验证】
cookie中间件来做到singlar的身份验证。
userId 是你自己定义的一个标识。
T Users(IList<string> userIds);
客户端JS使用方法
<script src="~/lib/signalr/signalr.js"></script>
<script type="text/javascript">
const connection = new signalR.HubConnectionBuilder()
.withUrl("/myChatHub")
.configureLogging(signalR.LogLevel.Information)
.build();
connection.start().catch(err => console.error(err.toString()));
//定义方法使用connection.on方法来接收返回数据
connection.on("SendMessage", (user, message) => {
const encodedMsg = user + " 说：" + message;
const li = document.createElement("li");
li.textContent = encodedMsg;
document.getElementById("messagesList").appendChild(li);
});
document.getElementById("sendBtn").addEventListener("click", function () {
var user = document.getElementById('userName').value;
var message = document.getElementById('message').value;
//从客户端中调用在此调用之前在自定义Hub定义的SendMessage方法
connection.invoke("SendMessage", user, message).catch(err => console.error(err.toString()));
document.getElementById('message').value = "";
});
</script>