gRPC之概念

最新推荐文章于 2024-08-19 21:44:00 发布

道格拉斯范朋克

最新推荐文章于 2024-08-19 21:44:00 发布

阅读量706

点赞数

分类专栏： gRPC 文章标签： gRPC

gRPC 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

本文档介绍了一些关键的gRPC概念，概述了gRPC的体系结构和RPC生命周期。

它假设您已阅读什么是gRPC 有关特定语言的详细信息，请参阅所选语言的快速入门，教程和参考文档（如果有）（完整的参考文档即将推出）。

概观

服务定义

与许多RPC系统一样，gRPC基于定义服务的思想，指定可以使用其参数和返回类型远程调用的方法。默认情况下，gRPC使用protocol buffs作为接口定义语言（IDL）来描述服务接口和有效负载消息的结构。如果需要，可以使用其他替代方案。

service HelloService { 
  rpc SayHello (HelloRequest) returns (HelloResponse); 
} 

message HelloRequest{ 
  string greeting = 1; 
} 

message HelloResponse {
  string reply = 1; 
}

gRPC允许您定义四种服务方法：

一元RPC，客户端向服务器发送单个请求并返回单个响应，就像正常的函数调用一样。

 rpc SayHello(HelloRequest) returns (HelloResponse){ }

服务器流式RPC，客户端向服务器发送请求并获取流以读取消息序列。客户端从返回的流中读取，直到没有更多消息。

 rpc LotsOfReplies(HelloRequest) returns (stream HelloResponse){ }

客户端流式RPC，客户端再次使用提供的流写入一系列消息并将其发送到服务器。一旦客户端写完消息，它就等待服务器读取它们并返回它的响应。

 rpc LotsOfGreetings(stream HelloRequest) returns (HelloResponse) { }

双向流式RPC，其中双方使用读写流发送一系列消息。这两个流独立运行，因此客户端和服务器可以按照他们喜欢的顺序进行读写：例如，服务器可以在写入响应之前等待接收所有客户端消息，或者它可以交替读取消息然后写入消息，或其他一些读写组合。保留每个流中的消息顺序。

 rpc BidiHello(stream HelloRequest) returns (stream HelloResponse){ }

我们将在下面的RPC生命周期部分中更详细地介绍不同类型的RPC。

使用API表面

从.proto文件中的服务定义开始，gRPC提供了生成客户端和服务器端代码的协议缓冲区编译器插件。 gRPC用户通常在客户端调用这些API，并在服务器端实现相应的API。

在服务器端，服务器实现服务声明的方法，并运行gRPC服务器来处理客户端调用。 gRPC基础结构解码传入请求，执行服务方法并对服务响应进行编码。
在客户端，客户端有一个称为存根的本地对象（对于某些语言，首选术语是客户端 ），它实现与服务相同的方法。然后，客户端可以在本地对象上调用这些方法，将调用的参数包装在适当的协议缓冲区消息类型中 - gRPC在将请求发送到服务器并返回服务器的协议缓冲区响应之后查看。

同步与异步

在响应从服务器到达之前阻塞的同步RPC调用最接近RPC所期望的过程调用的抽象。另一方面，网络本质上是异步的，在许多情况下，能够在不阻塞当前线程的情况下启动RPC是有用的。

大多数语言的gRPC编程表面都有同步和异步两种版本。您可以在每种语言的教程和参考文档中找到更多信息（完整的参考文档即将推出）。

RPC生命周期

现在让我们仔细看看当gRPC客户端调用gRPC服务器方法时会发生什么。我们不会查看实现细节，您可以在我们特定语言的页面中找到有关这些内容的更多信息。

一元RPC

首先让我们看一下最简单的RPC类型，客户端发送单个请求并返回单个响应。

客户端在存根/客户端对象上调用该方法后，将通知服务器已使用此调用的客户端元数据，方法名称和指定的截止时间（如果适用）调用RPC。
然后，服务器可以立即发送回自己的初始元数据（必须在任何响应之前发送），或者等待客户端的请求消息 - 首先发生的是特定于应用程序的消息。
一旦服务器具有客户端的请求消息，它就会执行创建和填充其响应所需的任何工作。然后将响应与状态详细信息（状态代码和可选状态消息）以及可选的尾随元数据一起返回（如果成功）到客户端。
如果状态为OK，则客户端获取响应，从而完成客户端的调用。