grpc-dotnet 專案在 PR #695 完成了 ASP.NET Core 服務與 .NET Core gRPC 客戶端的 gRPC-Web 實現。
雖然目前還是實驗性專案，但是並不阻礙我們為之興奮。下面我們來看看如何使用。

gRPC-Web 簡介

gRPC-Web 允許從瀏覽器應用程式使用 gRPC，gRPC-Web 支援在新場景中使用 gRPC：

• JavaScript 瀏覽器應用程式可以使用 gRPC-Web JavaScript 客戶端 呼叫 gRPC 服務。
• Blazor WebAssembly 應用程式可以使用.Net Core gRPC 客戶端呼叫 gRPC 服務。
• 可以讓 gRPC 服務被用於不完全支援 HTTP/2 的環境中。
• 可以讓 gRPC 用於 HTTP/2 中沒有的技術，例如 Windows 身份驗證。

Grpc.AspNetCore.Web 和 Grpc.Net.Client.Web 提供了擴充套件來為 .NET Core 支援端到端的 gRPC-Web。

服務端使用 Grpc.AspNetCore.Web

Grpc.AspNetCore.Web 提供了中介軟體使 ASP.NET Core gRPC 服務接受 gRPC- web 呼叫。

Startup.cs

public void ConfigureServices(IServiceCollection services)
{
    services.AddGrpc();
    services.AddGrpcWeb(o => o.GrpcWebEnabled = true);
}

public void Configure(IApplicationBuilder app)
{
    app.UseRouting();
    app.UseGrpcWeb();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapGrpcService<GreeterService>();
    });
}
 

gRPC-Web 可以通過設定 GrpcWebOptions.GrpcWebEnabled = true 來被應用於所有 gRPC 服務，或者通過EnableGrpcWeb()方法被應用於單個服務：

app.UseEndpoints(endpoints =>
{
    endpoints.MapGrpcService<GreeterService>().EnableGrpcWeb();
});

客戶端使用 Grpc.Net.Client.Web

Grpc.Net.Client.Web 提供了一個 HttpClient delegating handler 來配置 .NET Core gRPC 客戶端傳送 gRPC-Web 請求。

// Create channel
var handler = ew GrpcWebHandler(GrpcWebMode.GrpcWebText, new HttpClientHandler());
var channel = GrpcChannel.ForAddress("https://localhost:5001", new GrpcChannelOptions
    {
        HttpClient = new HttpClient(handler)
    });

// Make call with a client
var client = Greeter.GreeterClient(channel);
var response = await client.SayHelloAsync(new GreeterRequest { Name = ".NET" });

總結

可以看出，得益於 ASP.NET Core 3.0 以來對 gRPC 的深度整合，增加 gRPC 相關的新特性已經非常容易，使.NET Core 成為雲原生家族的重要成員。

近期，觀測分析平臺 SkyWalking 的 .NET 自動探針 (SkyAPM-dotnet) 也已經支援了 grpc-dotnet 遠端呼叫的鏈路跟蹤採集，歡迎大家使用！如果喜歡，也請大家給點個星星！

專案地址：https://github.com/SkyAPM/SkyAPM-dotnet