ASP.NET Core 3.0 gRPC框架

作者：找不到一個滿意的暱稱

連結：http://www.cnblogs.com/wu_u/p/10783168.html

什麼是gRPC

 

gRPC是google開源的一個高效能、跨語言的RPC框架，基於HTTP2協議，採用ProtoBuf 定義的IDL。

 

gRPC 的主要優點是：

 

• 現代高效能輕量級 RPC 框架。

• 協定優先 API 開發，預設使用協議緩衝區，允許與語言無關的實現。

• 可用於多種語言的工具，以生成強型別伺服器和客戶端。

• 支援客戶端、伺服器和雙向流式處理呼叫。

• 使用 Protobuf 二進位制序列化減少對網路的使用。

 

這些優點使 gRPC 適用於：

 

• 效率至關重要的輕量級微服務。

• 需要多種語言用於開發的 Polyglot 系統。

• 需要處理流式處理請求或響應的點對點實時服務。

 

更多介紹請前往 https://grpc.io/docs/guides/

開始

.NET Core 3.0 中已經加入了gRPC的模板專案.

 

1、開啟VS 2019,建立一個ASP.NET Core Web專案

 

 

2、選擇ASP.NET Core 3.0 就會出現gRPC模板，點選建立。

 

如果沒安裝core3的SDK請前往https://dotnet.microsoft.com/download/dotnet-core/3.0下載最新版本安裝，

 

如果你已經安裝了core 3.0的SDK卻還是無法顯示其選項，工具 > 選項 ，勾選“使用 .NET Core SDK 預覽版”

 

 

3、模板只有一個服務端專案，需要自行建立一個客戶端來做演示，建立一個.netcore的控制檯程式即可。

 

客戶端需要安裝以下三個包

 

• Grpc.Core，包含C-core客戶端的C＃API。

• Google.Protobuf，包含C＃的protobuf訊息API。

• Grpc.Tools，包含對protobuf檔案的C＃工具支援。

 

服務端程式碼

greet.proto，proto相關語法只是，前往 https://developers.google.com/protocol-buffers/docs/proto3，可能需要梯子。

syntax = "proto3";
package Greet;

// The greeting service definition.
service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

// The request message containing the user's name.
message HelloRequest {
  string name = 1;
  enum Language{
    en_us = 0; //列舉必須以0開始
    zh_cn = 1;
  }
  Language languageEnum = 2;
}

// The response message containing the greetings.
message HelloReply {
  string message = 1;
  int32 num = 2;
  int32 adsa = 3;
}

 

GreeterService

public class GreeterService : Greeter.GreeterBase
{
    public override Task SayHello(HelloRequest request, ServerCallContext context)
    {
        var greeting = string.Empty;
        switch (request.LanguageEnum)
        {
            case HelloRequest.Types.Language.EnUs:
                greeting = "Hello";
                break;
            case HelloRequest.Types.Language.ZhCn:
                greeting = "你好";
                break;
        }
        return Task.FromResult(new HelloReply
        {
            Message = $"{greeting} {request.Name}",
            Num = new Random().Next()
        });
    }
}

客戶端程式碼

新增greet.proto檔案，將Protosgreet.proto檔案從服務端複製到客戶端專案。將greet.proto檔案路徑新增到專案檔案GrpcDemo.Client.csproj的節點內。

 

這裡我們不複製，直接定位到相關路徑即可。

GrpcDemo.Client.csproj
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>ExeOutputType>

<TargetFramework>netcoreapp3.0TargetFramework>
PropertyGroup>

<ItemGroup>
<PackageReference Include=“Google.Protobuf” Version=“3.7.0” />
<PackageReference Include=“Grpc.Core” Version=“1.20.1” />
<PackageReference Include=“Grpc.Tools” Version=“1.20.1”>
<PrivateAssets>allPrivateAssets>
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitiveIncludeAssets>
PackageReference>


<Protobuf Include=“..GrpcDemo.ServerProtos*.proto” GrpcServices=“Client” />
ItemGroup>
Project>

 

Program.cs

static async Task Main(string[] args)
{
    var serverAddress = "localhost:50051";
    //建立連線通道，埠80
    var channel = new Channel(serverAddress, ChannelCredentials.Insecure);
    var client = new Greeter.GreeterClient(channel);
    //請求
    var reply1 = await client.SayHelloAsync(
        new HelloRequest { Name = "wu", LanguageEnum = HelloRequest.Types.Language.EnUs });
    Console.WriteLine($"{reply1.Message} Num:{reply1.Num}");
    var reply2 = await client.SayHelloAsync(
        new HelloRequest { Name = "wu", LanguageEnum = HelloRequest.Types.Language.ZhCn });
    Console.WriteLine($"{reply2.Message} Num:{reply2.Num}");

    //使用完後應釋放資源
    await channel.ShutdownAsync();
    Console.WriteLine("已斷開連線");
    Console.WriteLine("Press any key to exit...");
    Console.ReadKey();
}

執行

 

Demo地址： https://github.com/wwwu/GrpcDemo