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
