最新要闻

广告

手机

iphone11大小尺寸是多少?苹果iPhone11和iPhone13的区别是什么?

iphone11大小尺寸是多少?苹果iPhone11和iPhone13的区别是什么?

警方通报辅警执法直播中被撞飞:犯罪嫌疑人已投案

警方通报辅警执法直播中被撞飞:犯罪嫌疑人已投案

家电

GRPC核心概念、架构和生命周期

来源:博客园


(资料图片)

GRPC核心概念、架构和生命周期

标签(空格分隔): go,grpc

官网地址:https://grpc.io/docs/what-is-grpc/core-concepts/

概述

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

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

  • 一元 RPC其中客户端向服务器发送单个请求并返回单个响应,就像普通函数调用一样rpc SayHello(HelloRequest) returns (HelloResponse);
  • 服务器流式处理 RPC其中客户端向服务器发送请求并获取流以读回消息序列。客户端从返回的流中读取,直到没有更多消息。gRPC 保证单个 RPC 调用中的消息排序rpc LotsOfReplies(HelloRequest) returns (stream HelloResponse);
  • 客户端流式处理 RPC其中客户端写入一系列消息并将其发送到服务器,再次使用提供的流。客户端完成消息写入后,它将等待服务器读取消息并返回其响应。同样,gRPC 保证单个 RPC 调用中的消息排序rpc LotsOfGreetings(stream HelloRequest) returns (HelloResponse);
  • 双向流式处理 RPC其中双方使用读写流发送一系列消息。这两个流独立运行,因此客户端和服务器可以按照它们喜欢的任何顺序进行读取和写入:例如,服务器可以等待接收所有客户端消息,然后再写入响应,或者它可以交替读取消息然后写入消息,或者读取和写入的某种其他组合。保留每个流中消息的顺序rpc BidiHello(stream HelloRequest) returns (stream HelloResponse);

使用接口

从 .proto 文件中的服务定义开始,gRPC 提供了生成客户端和服务器端代码的协议缓冲区编译器插件。gRPC 用户通常在客户端调用这些 API,并在服务器端实现相应的 API - 在服务器端,服务器实现服务声明的方法,并运行 gRPC 服务器来处理客户端调用。gRPC   基础结构解码传入请求、执行服务方法并对服务响应进行编码 - 在客户端,客户端有一个称为存根的本地对象(对于某些语言,首选术语是客户端),它实现与服务相同的方法。然后,客户端可以在本地对象上调用这些方法,这些方法将调用的参数包装在适当的协议缓冲区消息类型中,将请求发送到服务器,并返回服务器的协议缓冲区响应

RPC 生命周期

在本部分中,你将详细了解当 gRPC 客户端调用 gRPC 服务器方法时会发生什么情况。有关完整的实现详细信息,请参阅特定于语言的页面

Unary RPC【一元RPC】

首先考虑最简单的 RPC 类型,其中客户端发送单个请求并返回单个响应
  • 客户端调用存根方法后,将通知服务器已使用此调用的客户端元数据、方法名称和指定的截止时间(如果适用)调用了 RPC
  • 然后,服务器可以立即发回自己的初始元数据(必须在任何响应之前发送),也可以等待客户端的请求消息。首先发生,是特定于应用程序的
  • 一旦服务器获得客户端的请求消息,它就会执行创建和填充响应所需的任何工作。然后,响应(如果成功)连同状态详细信息(状态代码和可选状态消息)和可选的尾随元数据一起返回给客户端
  • 如果响应状态为“正常”,则客户端将获得响应,从而在客户端完成调用

Server streaming RPC【服务器流RPC】

服务器流式处理 RPC 类似于一元 RPC,不同之处在于服务器返回消息流以响应客户端的请求。发送所有消息后,服务器的状态详细信息(状态代码和可选状态消息)和可选的尾随元数据将发送到客户端。这样就完成了服务器端的处理。客户端在拥有服务器的所有消息后完成

Client streaming RPC【客户端流RPC】

客户端流式处理 RPC 类似于一元 RPC,不同之处在于客户端向服务器发送消息流而不是单个消息。服务器使用单个消息(以及其状态详细信息和可选的尾随元数据)进行响应,通常但不一定要在收到所有客户端的消息之后

Bidirectional streaming RPC【双向流RPC】

在双向流式处理 RPC 中,调用由调用该方法的客户端和接收客户端元数据、方法名称和截止时间的服务器发起。服务器可以选择发回其初始元数据或等待客户端开始流式传输消息    客户端和服务器端流处理是特定于应用程序的。由于这两个流是独立的,因此客户端和服务器可以按任意顺序读取和写入消息。例如,服务器可以等到它收到客户端的所有消息后再写入其消息,或者服务器和客户端可以玩“乒乓球”——服务器收到请求,然后发回响应,然后客户端根据响应发送另一个请求,依此类推

截止时间/超时

gRPC 允许客户端指定在 RPC因DEADLINE_EXCEEDED错误终止之前,他们愿意等待 RPC 完成的时间。在服务器端,服务器可以查询特定 RPC 是否已超时, 或者还剩下多少

时间来完成 RPC

RPC 终止

在 gRPC 中,客户端和服务器都对调用是否成功做出独立的本地确定,它们的结论可能不匹配。这意味着,例如,您可能有一个在服务器端成功完成的 RPC(“我已经发送了我所有的响应!”),但在客户端失败(“响应在我的截止日期之后到达!”)。服务器也可以在客户端发送所有请求之前决定完成

取消 RPC

客户端或服务器可以随时取消 RPC。取消会立即终止 RPC,以便不再执行任何进

一步的工作

关键词: