在Web應(yīng)用中，實(shí)時(shí)通信已經(jīng)成為了一個(gè)重要的功能需求。ASP.NET Core SignalR是一個(gè)ASP.NET Core庫，它簡(jiǎn)化了向連接的客戶端添加實(shí)時(shí)Web功能的過程。通過SignalR，開發(fā)人員可以添加實(shí)時(shí)消息推送功能，以便服務(wù)器可以將消息實(shí)時(shí)推送給連接的客戶端。

SignalR簡(jiǎn)介

SignalR是一個(gè)ASP.NET庫，用于簡(jiǎn)化開發(fā)人員將實(shí)時(shí)Web功能添加到應(yīng)用程序的過程。實(shí)時(shí)Web功能使服務(wù)器代碼能夠在內(nèi)容可用時(shí)立即將內(nèi)容推送到連接的客戶端。

SignalR提供了用于連接管理（例如，連接和斷開連接事件）、分組連接和用戶身份驗(yàn)證的API。同時(shí)，它還提供了一個(gè)簡(jiǎn)單的、高級(jí)的API用于發(fā)送消息到所有連接的客戶端或指定的客戶端組。

配置SignalR

首先，你需要在項(xiàng)目中安裝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是處理服務(wù)器和客戶端之間通信的類。你可以通過繼承Hub類來創(chuàng)建自定義的Hub。例如，下面是一個(gè)簡(jiǎn)單的Hub類：

using Microsoft.AspNetCore.SignalR;

public class MyHub : Hub
{
    public async Task SendMessage(string user, string message)
    {
        await Clients.All.SendAsync("ReceiveMessage", user, message);
    }
}

在這個(gè)例子中，MyHub類有一個(gè)SendMessage方法，該方法接收用戶名和消息作為參數(shù)，并將消息廣播給所有連接的客戶端。Clients.All.SendAsync方法用于向所有連接的客戶端發(fā)送消息。客戶端通過監(jiān)聽名為ReceiveMessage的事件來接收這些消息。

客戶端代碼示例（JavaScript）

下面是一個(gè)使用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());
    });
}

在這個(gè)示例中，我們首先創(chuàng)建了一個(gè)HubConnection對(duì)象，并指定了Hub的URL（/myhub）。然后，我們定義了一個(gè)名為ReceiveMessage的事件處理程序，該程序?qū)⒃诮邮盏椒?wù)器發(fā)送的消息時(shí)被調(diào)用。最后，我們通過調(diào)用connection.start()方法啟動(dòng)與服務(wù)器的連接。sendMessage函數(shù)用于向服務(wù)器發(fā)送消息。它通過調(diào)用connection.invoke方法并傳入SendMessage方法和相應(yīng)的參數(shù)來實(shí)現(xiàn)。

服務(wù)器端推送消息示例

在服務(wù)器端，你可以通過注入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);
    }
}

在這個(gè)示例中，MessageService類有一個(gè)SendMessage方法，該方法使用注入的IHubContext<MyHub>來向所有連接的客戶端推送消息。你可以通過依賴注入將IHubContext<MyHub>注入到你的服務(wù)或控制器中，并在需要時(shí)調(diào)用SendMessage方法。這種方法允許你在服務(wù)器端主動(dòng)推送消息給客戶端，而無需客戶端的請(qǐng)求。這對(duì)于實(shí)時(shí)更新、通知或廣播等場(chǎng)景非常有用。例如，當(dāng)某個(gè)用戶執(zhí)行了特定操作時(shí)，你可以使用這種方法將相關(guān)信息實(shí)時(shí)推送給其他用戶或管理員。請(qǐng)注意，為了使用SignalR進(jìn)行實(shí)時(shí)通信，你的服務(wù)器和客戶端都需要能夠處理WebSocket連接（這是SignalR默認(rèn)使用的傳輸方式）。如果你的服務(wù)器或客戶端位于防火墻或代理服務(wù)器后面，請(qǐng)確保已正確配置以允許WebSocket流量通過。