GRPC 是Google发布的一个开源、高性能、通用RPC(Remote Procedure Call)框架。提供跨语言、跨平台支持。以下以一个.NET Core Console项目演示如何使用GRPC框架。
一、定义服务
通过proto定义一个数学计算服务,其中包括两个服务方法(Add, Multipy)以及4个请求响应对象(AddRequest, AddReply, MultiplyRequest, MultiplyReply)。
// 文件名:mathservice.protosyntax = "proto3";
option java_multiple_files = false;
option java_package = "MathServices";
option java_outer_classname = "MathServicesProto";
option objc_class_prefix = "MathServices";
package MathServices;// 数学运算服务service MathService
{
rpc Add (AddRequest) returns (AddReply) {} rpc Multiply (MultiplyRequest)
returns (MultiplyReply) {}
}
message AddRequest { double First = 1; double Second = 2;
}
message AddReply { double Sum = 1;
}
message MultiplyRequest { double First = 1; double Second = 2;
}
message MultiplyReply { double Result = 1;
}
二、将服务编译成存根(stub)
通过以下批处理命令generate_protos.bat
将服务定义生成多种语言和平台版本的客户端和服务端存根。
@rem 生成客户端和服务器端存根
setlocal
@rem 进入当前目录
cd /d %~dp0set TOOLS_PATH=C:\Users\Freeman\.nuget\packages\Grpc.Tools\1.0.0\tools\windows_x86 %TOOLS_PATH%\protoc.exe ^--proto_path protos ^--cpp_out=Interfaces/cpp ^--csharp_out=Interfaces/csharp ^--java_out=Interfaces/java ^--js_out=Interfaces/javascript ^--grpc_out=Interfaces/csharp ^--plugin=protoc-gen-grpc=%TOOLS_PATH%\grpc_csharp_plugin.exe ^protos/mathservice.proto endlocaltimeout 5
针对CSHARP语言,protoc.exe编译器生成了如下图几个类,其中左边4个类用于构造请求和响应对象,MathService类用于下一步构造服务和消费服务。
CSHARP STUBS
三、实现并运行服务
通过上一步的编译,自动生成了MathService类,下面通过该类构造并启动grpc服务。
通过继承基类实现服务接口
/// <summary>
/// 实现RPC服务端接口。
/// </summary>
public class MathServiceImpl :