使用 SignalR 实现实时通信

SignalR 是一个用于构建实时 Web 应用程序的开源库。它提供了一种简单的方式来在客户端和服务器之间建立双向通信。无论是在桌面端还是网页端，SignalR 都能够实现实时数据传输和即时通信。本文将介绍如何在 ASP.NET 中使用 SignalR 实现实时通信。

服务器端

在服务器端，首先需要创建一个 SignalR Hub 类。Hub 类是 SignalR 的核心组件，负责处理客户端和服务器之间的通信。以下是一个简单的 SignalR Hub 类的示例：

using Microsoft.AspNetCore.SignalR;

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

上述示例中，ChatHub 类继承自 Hub 类，并定义了一个名为 SendMessage 的方法。该方法接收一个用户名和一条消息，然后将消息广播给所有客户端。

要在 ASP.NET 项目中启用 SignalR，需要在 Startup.cs 文件中进行配置。在 ConfigureServices 方法中添加以下代码：

services.AddSignalR();

接下来，在 Configure 方法中启用 SignalR：

app.UseEndpoints(endpoints =>
{
    endpoints.MapHub<ChatHub>("/chathub");
});

现在，服务器端的配置已经完成。

客户端（桌面端和网页端）

客户端可以使用不同的技术来连接和与 SignalR 通信，例如 JavaScript、TypeScript 或 C#。在本文中，我们将分别介绍桌面端和网页端的客户端实现方式。

桌面端

在桌面端，可以使用 SignalR 的 .NET 客户端库来连接和与服务器进行通信。以下是一个示例：

using Microsoft.AspNetCore.SignalR.Client;

var connection = new HubConnectionBuilder()
    .WithUrl("http://localhost:5000/chathub")
    .Build();

connection.On<string, string>("ReceiveMessage", (user, message) =>
{
    Console.WriteLine($"{user}: {message}");
});

await connection.StartAsync();

while (true)
{
    Console.Write("Enter your name: ");
    var user = Console.ReadLine();

    Console.Write("Enter your message: ");
    var message = Console.ReadLine();

    await connection.SendAsync("SendMessage", user, message);
}

上述示例中，我们首先创建了一个 HubConnection 对象，并指定了服务器的 URL。然后，使用 On 方法来订阅 ReceiveMessage 事件，以接收服务器端广播的消息。最后，使用 SendAsync 方法发送消息到服务器。

网页端

在网页端，可以使用 JavaScript 或 TypeScript 来连接和与 SignalR 通信。以下是一个使用 JavaScript 的示例：

const connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .build();

connection.on("ReceiveMessage", (user, message) => {
    console.log(`${user}: ${message}`);
});

connection.start()
    .then(() => {
        while (true) {
            const user = prompt("Enter your name:");
            const message = prompt("Enter your message:");

            connection.invoke("SendMessage", user, message);
        }
    });

在上述示例中，我们首先创建了一个 HubConnection 对象，并指定了服务器的 URL。然后，使用 on 方法来订阅 ReceiveMessage 事件，以接收服务器端广播的消息。最后，使用 invoke 方法发送消息到服务器。

现在，客户端的配置已经完成。

总结

本文介绍了如何在 ASP.NET 中使用 SignalR 实现实时通信。通过创建一个 SignalR Hub 类，并在客户端上连接和与服务器进行通信，我们可以实现双向通信和实时数据传输。无论是在桌面端还是网页端，SignalR 都是一个强大而简单的工具，可以帮助我们构建实时 Web 应用程序。