ASP.NET Core 3.0 使用gRPC

目錄

• ASP.NET Core 3.0 使用gRPC
• ASP.NET Core 3.0 gRPC 雙向流
• ASP.NET Core 3.0 gRPC 攔截器

一.簡介

gRPC 是一個由Google開源的，跨語言的，高性能的遠程過程調用（RPC）框架。 gRPC使客戶端和服務端應用程序能夠透明地進行通訊，並簡化了鏈接系統的構建。它使用HTTP/2做爲通訊協議，使用 Protocol Buffers 做爲序列化協議。

它的主要優勢：

• 現代高性能輕量級 RPC 框架。
• 約定優先的 API 開發，默認使用 Protocol Buffers 做爲描述語言，容許與語言無關的實現。
• 可用於多種語言的工具，以生成強類型的服務器和客戶端。
• 支持客戶端，服務器雙向流調用。
• 經過Protocol Buffers二進制序列化減小網絡使用。
• 使用 HTTP/2 進行傳輸

這些優勢使gRPC很是適合：

• 高性能輕量級微服務 - gRPC設計爲低延遲和高吞吐量通訊，很是適合須要高性能的輕量級微服務。
• 多語言混合開發 - gRPC工具支持全部流行的開發語言，使gRPC成爲多語言開發環境的理想選擇。
• 點對點實時通訊 - gRPC對雙向流調用提供出色的支持。gRPC服務能夠實時推送消息而無需輪詢。
• 網絡受限環境 - 使用 Protocol Buffers二進制序列化消息，該序列化始終小於等效的JSON消息，對網絡帶寬需求比JSON小。

不建議使用gRPC的場景：

• 瀏覽器可訪問的API - 瀏覽器不徹底支持gRPC。雖然gRPC-Web能夠提供瀏覽器支持，可是它有侷限性，引入了服務器代理
• 廣播實時通訊 - gRPC支持經過流進行實時通訊，但不存在向已註冊鏈接廣播消息的概念
• 進程間通訊 - 進程必須承載HTTP/2才能接受傳入的gRPC調用，對於Windows，進程間通訊管道是一種更快速的方法。

摘自微軟官方文檔

支持的語言以下：

二.gRPC on .NET Core

gRPC 如今能夠很是簡單的在 .NET Core 和 ASP.NET Core 中使用，在 .NET Core 上的實現的開源地址：https://github.com/grpc/grpc-dotnet ，它目前由微軟官方 ASP.NET 項目的人員進行維護，良好的接入 .NET Core 生態。

.NET Core 的 gRPC 功能以下：

• Grpc.AspNetCore 一個用於在ASP.NET Core承載gRPC服務的框架，將 gRPC和ASP.NET Core 功能集成在一塊兒，如：日誌、依賴注入、身份認證和受權。
• Grpc.Net.Client 基於HttpClient （HttpClient現已支持HTTP/2）的 gRPC客戶端
• Grpc.Net.ClientFactory 與gRPC客戶端集成的HttpClientFactory，容許對gRPC客戶端進行集中配置，並使用DI注入到應用程序中

三.使用 ASP.NET Core 建立 gRPC 服務

1. 經過 Visual Studio 2019 （16.3.0）提供的模板，能夠快速建立 gRPC 服務。

來扒拉一下默認源碼包含了什麼東東。

① 配置文件 appsettings.json ，多了Kestrel 啓用 HTTP/2 的配置，由於 gRPC 是基於 HTTP/2 來通訊的

② PB協議文件 greet.proto 用於自動生成服務、客戶端和消息（表示傳遞的數據）的C# Class

③ 服務類 GreeterService ，服務類集成的 Greeter.GreeterBase 來自於根據proto文件自動生成的，生成的類在 obj\Debug\netcoreapp3.0目錄下

自動生成的類：

④ Startup.cs類，將 gRPC服務添加到了終結點路由中

⑤ csproj 項目文件，包含了 proto 文件引用

2.運行

第一次運行會提示是否信任證書，點擊「是」

這是由於HTTP/2須要HTTPS，儘管HTTP/2協議沒有明確規定須要HTTPS，可是爲了安全在瀏覽器實現上都要求了HTTPS，因此如今的HTTP/2和HTTPS基本都是一對。

四. 建立 gRPC 客戶端

1.添加一個.NET Core 控制檯應用程序

2.經過nuget添加包：Grpc.Net.Client、Google.Protobuf、Grpc.Tools

3.將服務的 proto 文件複製到客戶端

4.編輯客戶端項目文件，添加關於proto文件的描述

<ItemGroup>
    <Protobuf Include="Protos\greet.proto" GrpcServices="Client" />
</ItemGroup>

注意 GrpcServices="Client" 這裏是Client和服務是不同的

5.生成客戶端項目能夠經過proto文件生成類

6.添加客戶端調用代碼

static async Task Main(string[] args)
{
    var channel = GrpcChannel.ForAddress("https://localhost:5001");
    var client = new Greeter.GreeterClient(channel);
    var reply = await client.SayHelloAsync(
        new HelloRequest { Name = "曉晨" });
    Console.WriteLine("Greeter 服務返回數據: " + reply.Message);
    Console.ReadKey();
}

7.先啓動服務，而後運行客戶端

這裏能夠看到，客戶端成功調用了服務，收到了返回的消息。

五.本身動手寫一個服務

前面咱們使用的 Greeter 服務是由模板自動給咱們建立的，如今咱們來本身動手寫一個服務。

編寫一個「擼貓服務」

1.定義 proto 文件 LuCat.proto，並在csproj項目文件中添加描述

syntax = "proto3";

option csharp_namespace = "AspNetCoregRpcService";

import "google/protobuf/empty.proto";
package LuCat; //定義包名

//定義服務
service LuCat{
    //定義吸貓方法
	rpc SuckingCat(google.protobuf.Empty) returns(SuckingCatResult);
}

message SuckingCatResult{
	string message=1;
}

2.實現服務 LuCatService.cs

public class LuCatService:LuCat.LuCatBase
{
    private static readonly List<string> Cats=new List<string>(){"英短銀漸層","英短金漸層","美短","藍貓","狸花貓","橘貓"};
    private static readonly Random Rand=new Random(DateTime.Now.Millisecond);
    public override Task<SuckingCatResult> SuckingCat(Empty request, ServerCallContext context)
    {
        return Task.FromResult(new SuckingCatResult()
        {
            Message = $"您吸了一隻{Cats[Rand.Next(0, Cats.Count)]}"
        });
    }
}

3.在 Startup終結點路由中註冊

endpoints.MapGrpcService<LuCatService>();

4.添加客戶端調用

var catClient = new LuCat.LuCatClient(channel);
var catReply = await catClient.SuckingCatAsync(new Empty());
Console.WriteLine("調用擼貓服務："+ catReply.Message);

5.運行測試

六.實際使用中的技巧

技巧1

上面章節的操做步驟中，咱們須要在服務和客戶端之間複製proto，這是一個能夠省略掉的步驟。

1.複製 Protos 文件夾到解決方案根目錄（sln文件所在目錄）

2.刪除客戶端和服務項目中的 Protos 文件夾

3.在客戶端項目文件csproj中添加關於proto文件的描述

<ItemGroup>
    <Protobuf Include="..\..\Protos\greet.proto" GrpcServices="Client" Link="Protos\greet.proto" />
  </ItemGroup>

4.在服務項目文件csproj中添加關於proto文件的描述

<ItemGroup>
    <Protobuf Include="..\..\Protos\greet.proto" GrpcServices="Server" Link="Protos\greet.proto" />
  </ItemGroup>

在實際項目中，請本身計算相對路徑

5.這樣兩個項目都是使用的一個proto文件，只用維護這一個文件便可

技巧2

咱們在實際項目中使用，確定有多個 proto 文件，難道咱們每添加一個 proto 文件都要去更新 csproj文件？

咱們可使用MSBuild變量來幫咱們完成，咱們將 csproj 項目文件中引入proto文件信息進行修改。

服務端：

<ItemGroup>
    <Protobuf Include="..\..\Protos\*.proto" GrpcServices="Server" Link="Protos\%(RecursiveDir)%(Filename)%(Extension)" />
  </ItemGroup>

客戶端：

<ItemGroup>
    <Protobuf Include="..\..\Protos\*.proto" GrpcServices="Client" Link="Protos\%(RecursiveDir)%(Filename)%(Extension)" />
  </ItemGroup>

示例：

七.總結

gRPC 現目前是一款很是成熟的高性能RPC框架，當前的生態是很是好的，不少公司的產品或者開源項目都有在使用gRPC，有了它，相信可讓咱們更容易的構建.NET Core 微服務，可讓 .NET Core 更好的接入 gRPC 生態。不得不說這是 .NET Core 3.0 帶來的最使人振奮的特性之一。

參考資料：

• proto3 說明文檔
• 在ASP.NET Core中建立gRPC客戶端和服務
• Demo 地址

若是你們沒法訪問proto3說明文檔，這裏提供一個離線網頁版（請另存爲下載後用Chrome打開）

原文出處：https://www.cnblogs.com/stulzq/p/11581967.html