.NET World——gPRC概览

什么是grpc

的定义：

grpc is a modern open source high performance rpc framework that can run in any environment. it can efficiently connect services in and across data centers with pluggable support for load balancing, tracing, health checking and authentication. it is also applicable in last mile of distributed computing to connect devices, mobile applications and browsers to backend services.

grpc是一种现代化开源的高性能rpc框架，能够运行于任意环境之中。它可以高效地在服务和数据中心内部与其间建立连接，并且可支持负载均衡，追踪，健康检测与认证功能。同时它也可用于分布式计算的“最后一公里”，连接设备，移动应用和浏览器到后端服务。

维基的定义：

grpc (grpc remote procedure calls) is an open source remote procedure call (rpc) system initially developed at google. it uses http/2 for transport, protocol buffers as the interface description language, and provides features such as authentication, bidirectional streaming and flow control, blocking or nonblocking bindings, and cancellation and timeouts. it generates cross-platform client and server bindings for many languages. most common usage scenarios include connecting services in microservices style architecture and connect mobile devices, browser clients to backend services.

grpc(grpc远程过程调用)是一种开源的远程过程调用系统，最初由谷歌进行开发。它使用http/2作为传输协议。protocol buffer被用于接口描述语言，提供了诸如认证，双向流控制，阻塞或非阻塞绑定，取消与超时功能。它为多种语言生成跨平台的客户端与服务端绑定。最通用的使用场景包括在微服务样式架构中连接服务，以及连接移动设备，浏览器客户端到后端服务。

什么是rpc

从上面的解释里不难看出，要对grpc有更直观的理解，首先需要明白rpc的定义。

继续看下维基上的内容：

in distributed computing, a remote procedure call (rpc) is when a computer program causes a procedure (subroutine) to execute in a different address space (commonly on another computer on a shared network), which is coded as if it were a normal (local) procedure call, without the programmer explicitly coding the details for the remote interaction. that is, the programmer writes essentially the same code whether the subroutine is local to the executing program, or remote. this is a form of client–server interaction (caller is client, executor is server), typically implemented via a request–response message-passing system. in the object-oriented programming paradigm, rpc calls are represented by remote method invocation (rmi). the rpc model implies a level of location transparency, namely that calling procedures is largely the same whether it is local or remote, but usually they are not identical, so local calls can be distinguished from remote calls. remote calls are usually orders of magnitude slower and less reliable than local calls, so distinguishing them is important.

在分布式计算里，当计算机程序要运行一段代码，远程过程调用(rpc)会在不同的内存地址(一般是在网络里的不同计算机)上执行它。其无需程序员显示地对它的远程交互进行具体编码，编写代码的方式就如同一段普通的本地过程调用一般。即是，程序员所需写的代码是相同的，无论其调用的过程是在本地还是远程。这是一种客户端-服务端交互的形式(调用方是客户端，执行方是服务端)，典型的实现方式是通过一种请求-响应的传递消息系统。在面向对象程序范式里，rpc调用被表示为远程方式调用(rmi)。rpc模型意味着一定程度的本地透明性，本地或是远程的调用过程大致而言是等同的，但又不是完全一样。远程调用通常比本地调用慢上几个数量级，同时也更加不可靠。

remoting，web service，wcf

如果对rpc的概念还是理解不了的话，却曾使用过或者了解过诸如remoting，web service或者wcf等技术的话，那么其实在这方面已经入门了。

protocol buffers

protocol buffers是谷歌开发的一套无关开发语言，无关平台的用于序列化结构数据的可扩展机制。它的用途与xml，json相同，但比它们更小，更快，更简洁。

作为grpc中默认的接口定义语言，其既可以用于定义服务接口，也可以定义所必要的数据结构。

service helloservice {
  rpc sayhello (hellorequest) returns (helloresponse);
}

message hellorequest {
  string greeting = 1;
}

message helloresponse {
  string reply = 1;
}

protocol buffers的代码需要保存在扩展名为.proto的文件之中。

服务类型

grpc支持四种服务类型：

1. 一元式rpc
2. 服务端流式rpc
3. 客户端流式rpc
4. 双向流式rpc

一元式rpc，如同普通的方法调用一般，客户端的单一请求，至服务端后，返回唯一的响应。

rpc sayhello(hellorequest) returns (helloresponse){
}

服务端流式rpc，客户端发送一请求至服务端后，服务端返回一串消息数据流，客户端持续读取直到没有更多的消息。grpc会确保消息的传输顺序。

rpc lotsofreplies(hellorequest) returns (stream helloresponse){
}

客户端流式rpc，客户端对一数据流写入一串信息后发送到服务端，并等待服务端返回响应。grpc会确保消息的传输顺序。

rpc lotsofgreetings(stream hellorequest) returns (helloresponse) {
}

双向流式rpc，客户端与服务端使用两个数据流，其间互无影响，可以同时进行数据传递。

rpc bidihello(stream hellorequest) returns (stream helloresponse){
}

grpc api

光有proto文件，并不能直接使用，还需grpc中所提供的api将这些文件编译成不同程序语言的服务端与客户端代码。

在服务端，实现服务所定义的方法，并运行grpc服务程序以处理客户端调用。grpc架构负责解码传入的请求，执行服务的方法，最后对服务的响应进行编码。
在客户端，会有一个名为存根(stub)的本地对象，实现与服务端相同的方法。这样只需调用这个本地对象的方法，传入合适的protocol buffers消息类型的参数，grpc负责将请求发送至服务端，再返回相应的结果。

如果使用过诸如wcf这样的prc技术，对这一过程应该是十分熟悉了。

感到陌生的大概是grpc中将proto文件编译成代码的插件工具，例如grpc.tools。

所以还是举个具体的例子以便理解。

.net中的gprc

首先建立两个console工程。

dotnet new console -o grpcserver
dotnet new console -o grpcclient

接着，在此两个工程同级目录下新建一个名为protos的文件夹。

如此，目录下的文件夹应该有如下几个：

• grpcserver
• grpcclient
• protos

protos文件夹下新加一个greet.proto文件。

syntax = "proto3";

option csharp_namespace = "grpcgreeter";

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;
}

// the response message containing the greetings.
message helloreply {
  string message = 1;
}

然后，进入grpcserver文件夹，添加相关的类库包。

dotnet add package grpc
dotnet add package grpc.tools
dotnet add package google.protobuf

并在csproj文件中加入下列配置：

  <itemgroup>
    <protobuf include="../protos/*.proto" outputdir="protos" compileoutputs="false" grpcservices="service" />
  </itemgroup>   

运行dotnet build，可以看到在grpcserver工程下新生成一个protos文件夹，以及greet.cs与greetgrpc.cs文件。

在program类中加入greeter的实现类和相关接口方法，并创建服务端启动程序。

class program
{
    const int port = 51234;

    static void main(string[] args)
    {
        var server = new server
        {
            services = { greeter.bindservice(new greeterimpl()) },
            ports = { new serverport("localhost", port, servercredentials.insecure) }
        };
        server.start();

        console.writeline("greeter server listening on port " + port);
        console.writeline("press any key to stop the server...");
        console.readkey();

        server.shutdownasync().wait();
    }
}

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 });
    }
}

通过dotnet run命令启动此服务端。

之后再进入grpcclient文件夹，加入同样的类库包。

在csproj文件中加入类似的配置，注意grpcservices属性改为了client：

  <itemgroup>
    <protobuf include="../protos/*.proto" outputdir="protos" compileoutputs="false" grpcservices="client" />
  </itemgroup>   

运行dotnet build，同样生成protos文件夹及两个proto文件。

program类中加入客户端调用代码。

static void main(string[] args)
{
    var channel = new channel("127.0.0.1:51234", channelcredentials.insecure);

    var client = new greeter.greeterclient(channel);
    var reply = client.sayhello(new hellorequest { name = "ken" });
    console.writeline(reply.message);

    channel.shutdownasync().wait();
    console.readkey();
}

运行客户端后，应该就可以看到调用服务端方法后返回的结果。

.net core 3.0

在最新的.net core 3.0中，加入了对grpc更多的支持。当创建一个web项目时，选择asp.net core 3.0，可以发现新增了grpc service项目模板。

从建立的项目代码中可以看出其不再是普通的web应用，而是完全变成了grpc的服务端。

public void configureservices(iservicecollection services)
{
    services.addgrpc();
}

public void configure(iapplicationbuilder app, iwebhostenvironment env)
{
    if (env.isdevelopment())
    {
        app.usedeveloperexceptionpage();
    }

    app.userouting();

    app.useendpoints(endpoints =>
    {
        // communication with grpc endpoints must be made through a grpc client.
        // to learn how to create a client, visit: https://go.microsoft.com/fwlink/?linkid=2086909
        endpoints.mapgrpcservice<greeterservice>();
    });
}