.NET Core SignalR：實現服務器實時消息推送
在Web應用中，實時通信已經成為了一個重要的功能需求。ASP.NET Core SignalR是一個ASP.NET Core庫，它簡化了向連接的客戶端添加實時Web功能的過程。通過SignalR，開發(fā)人員可以添加實時消息推送功能，以便服務器可以將消息實時推送給連接的客戶端。
SignalR簡介
SignalR是一個ASP.NET庫，用于簡化開發(fā)人員將實時Web功能添加到應用程序的過程。實時Web功能使服務器代碼能夠在內容可用時立即將內容推送到連接的客戶端。
SignalR提供了用于連接管理（例如，連接和斷開連接事件）、分組連接和用戶身份驗證的API。同時，它還提供了一個簡單的、高級的API用于發(fā)送消息到所有連接的客戶端或指定的客戶端組。
配置SignalR
首先，你需要在項目中安裝Microsoft.AspNetCore.SignalR NuGet包。
dotnet add package Microsoft.AspNetCore.SignalR然后，在Startup.cs中配置SignalR：
public void ConfigureServices(IServiceCollection services)
{
services.AddSignalR();
// ...
}
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
// ...
app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.MapHub<MyHub>("/myhub");
// ...
});
// ...
}創(chuàng)建Hub類
Hub是處理服務器和客戶端之間通信的類。你可以通過繼承Hub類來創(chuàng)建自定義的Hub。例如，下面是一個簡單的Hub類：
using Microsoft.AspNetCore.SignalR;
public class MyHub : Hub
{
public async Task SendMessage(string user, string message)
{
await Clients.All.SendAsync("ReceiveMessage", user, message);
}
}在這個例子中，MyHub類有一個SendMessage方法，該方法接收用戶名和消息作為參數，并將消息廣播給所有連接的客戶端。Clients.All.SendAsync方法用于向所有連接的客戶端發(fā)送消息。客戶端通過監(jiān)聽名為ReceiveMessage的事件來接收這些消息。
客戶端代碼示例（JavaScript）
下面是一個使用JavaScript的SignalR客戶端示例：
const connection = new signalR.HubConnectionBuilder()
.withUrl("/myhub")
.configureLogging(signalR.LogLevel.Information)
.build();
connection.on("ReceiveMessage", function (user, message) {
console.log(user + ": " + message);
});
connection.start().catch(function (err) {
return console.error(err.toString());
});
function sendMessage() {
var user = document.getElementById('userInput').value;
var message = document.getElementById('messageInput').value;
connection.invoke("SendMessage", user, message).catch(function (err) {
return console.error(err.toString());
});
}在這個示例中，我們首先創(chuàng)建了一個HubConnection對象，并指定了Hub的URL（/myhub）。然后，我們定義了一個名為ReceiveMessage的事件處理程序，該程序將在接收到服務器發(fā)送的消息時被調用。最后，我們通過調用connection.start()方法啟動與服務器的連接。sendMessage函數用于向服務器發(fā)送消息。它通過調用connection.invoke方法并傳入SendMessage方法和相應的參數來實現。
服務器端推送消息示例
在服務器端，你可以通過注入IHubContext<MyHub>來推送消息。例如：
public class MessageService
{
private readonly IHubContext<MyHub> _hubContext;
public MessageService(IHubContext<MyHub> hubContext)
{
_hubContext = hubContext;
}
public async Task SendMessage(string user, string message)
{
await _hubContext.Clients.All.SendAsync("ReceiveMessage", user, message);
}
}在這個示例中，MessageService類有一個SendMessage方法，該方法使用注入的IHubContext<MyHub>來向所有連接的客戶端推送消息。你可以通過依賴注入將IHubContext<MyHub>注入到你的服務或控制器中，并在需要時調用SendMessage方法。這種方法允許你在服務器端主動推送消息給客戶端，而無需客戶端的請求。這對于實時更新、通知或廣播等場景非常有用。例如，當某個用戶執(zhí)行了特定操作時，你可以使用這種方法將相關信息實時推送給其他用戶或管理員。請注意，為了使用SignalR進行實時通信，你的服務器和客戶端都需要能夠處理WebSocket連接（這是SignalR默認使用的傳輸方式）。如果你的服務器或客戶端位于防火墻或代理服務器后面，請確保已正確配置以允許WebSocket流量通過。
