WebSocketHostBuilder

WebSocketHostBuilder 是 ASP.NET Core 中用于配置和创建 WebSocket 服务器的辅助构建器类。它可以帮助我们轻松地创建和配置 WebSocket 服务器。

使用 WebSocketHostBuilder，我们可以通过链式调用一系列方法来配置 WebSocket 服务器的各种属性和行为。这些方法包括设置服务器的主机地址、端口号，配置 SSL/TLS 加密，配置消息处理程序，设置最大连接数等等。

下面是一个示例代码，演示了如何使用 WebSocketHostBuilder 创建一个简单的 WebSocket 服务器：

using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;

public class Program
{
    public static void Main(string[] args)
    {
        WebHost.CreateDefaultBuilder(args)
            .Configure(app =>
            {
                app.UseWebSockets();
                app.Use(async (context, next) =>
                {
                    if (context.WebSockets.IsWebSocketRequest)
                    {
                        var webSocket = await context.WebSockets.AcceptWebSocketAsync();
                        await HandleWebSocket(webSocket);
                    }
                    else
                    {
                        await next();
                    }
                });
                app.Run(async context =>
                {
                    await context.Response.WriteAsync("Hello, World!");
                });
            })
            .Build()
            .Run();
    }

    private static async Task HandleWebSocket(WebSocket webSocket)
    {
        // 在这里处理 WebSocket 的逻辑
    }
}

上述代码中，我们使用了 `WebHost.CreateDefaultBuilder` 创建了一个默认的 Web 主机，并通过 `Configure` 方法来配置中间件管道。在中间件管道中，我们首先使用 `UseWebSockets` 方法启用了 WebSocket 支持，然后使用 `Use` 方法来处理 WebSocket 请求。如果是 WebSocket 请求，我们将通过 `AcceptWebSocketAsync` 方法来接受连接，并通过自定义的 `HandleWebSocket` 方法来处理相关逻辑。

当然，这只是一个简单的示例，实际上我们可以根据需要进行更复杂的配置和处理。WebSocketHostBuilder 提供了很多其他方法，可以满足各种不同的需求。