gRPC官方快速上手學習筆記（c#版）

上手前準備工做

支持操做系統：windows、OS X、Linux。實例採用.net、.net core sdk。

• The .NET Core SDK command line tools.
• The .NET framework 4.5 (for OS X and Linux, the open source .NET Framework implementation, 「Mono」, at version 4+, is suitable)
• Git (to download the sample code)

在windows系統開發環境, 採用 Visual Studio開發工具, 須要知足如下要求:

• .NET Framework 4.5+
• Visual Studio 2013 or 2015.

• Git (to download the sample code)

  在OS X 系統開發環境, 採用Xamarin Studio開發工具, 須要知足如下要求:

• Mono 4.4.2+ (or Mono 4+ is sufficient if you manually update NuGet to version 2.12+)
• Xamarin Studio 6.0+

• Git (to download the sample code)

  在 Linux 系統開發環境, 採用 the Monodevelop IDE,須要知足如下要求 :

• Mono 4.4.2+ (or Mono 4+ is sufficient if you manually update nuget to version 2.12+)
• MonoDevelop 5.9+
• A NuGet executable, at version 2.12+ (you’ll need to restore NuGet package dependencies from the command line)

• Git (to download the sample code)

下載官方demo

git clone -b v1.6.x https://github.com/grpc/grpc

1. 打開下載的demo文C:\Users\YPF\Desktop\grpc
2. 進入目錄examples/csharp/helloworld

Build the example

1. 使用Visual Studio打開Greeter.sln
2. 在該項目的解決右鍵從新生成解決方案
   

項目會自動使用NuGet進行必要的package的安裝。

運行 a gRPC application

1. 運行服務

> cd GreeterServer/bin/Debug
> GreeterServer.exe

1. 運行客戶端

> cd GreeterClient/bin/Debug
> GreeterClient.exe

更新 a gRPC service

打開目錄examples/protos/helloworld.proto
將原來的文件修改成以下並保存：

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

// The request message containing the user's name.
message HelloRequest {
  string name = 1;
}

// The response message containing the greetings
message HelloReply {
  string message = 1;
}

生成 gRPC code

在demo的根目錄（examples/csharp/helloworld）下執行以下命令:

packages\Grpc.Tools.1.6.1\tools\windows_x86\protoc.exe -I../../protos --csharp_out Greeter --grpc_out Greeter ../../protos/helloworld.proto --plugin=protoc-gen-grpc=packages/Grpc.Tools.1.6.1/tools/windows_x86/grpc_csharp_plugin.exe

這裏的Grpc.Tools.1.6.1這個命令必須是跟項目中使用NuGet安裝的版本一致，不然會報錯。

更新並重新運行

修改服務端代碼

GreeterServer/Program.cs

class GreeterImpl : Greeter.GreeterBase
{
    // Server side handler of the SayHello RPC
    public override Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)
    {
        return Task.FromResult(new HelloReply { Message = "Hello " + request.Name });
    }

    // Server side handler for the SayHelloAgain RPC
    public override Task<HelloReply> SayHelloAgain(HelloRequest request, ServerCallContext context)
    {
        return Task.FromResult(new HelloReply { Message = "Hello again " + request.Name });
    }
}

修改服務端代碼

GreeterClient/Program.cs

public static void Main(string[] args)
{
    Channel channel = new Channel("127.0.0.1:50051", ChannelCredentials.Insecure);

    var client = new Greeter.GreeterClient(channel);
    String user = "you";

    var reply = client.SayHello(new HelloRequest { Name = user });
    Console.WriteLine("Greeting: " + reply.Message);
    
    var secondReply = client.SayHelloAgain(new HelloRequest { Name = user });
    Console.WriteLine("Greeting: " + secondReply.Message);

    channel.ShutdownAsync().Wait();
    Console.WriteLine("Press any key to exit...");
    Console.ReadKey();
}

運行 a gRPC application

• 運行服務

  cd GreeterServer/bin/Debug
  GreeterServer.exe

• 運行客戶端

  cd GreeterClient/bin/Debug
  GreeterClient.exe

參考文章：

• grpc官方文檔
  -gRPC官方文檔中文版