跳转到内容

导入 gRPC(.proto 或 reflection)

有两条路径可以在 Restorm 中得到一棵 gRPC 树。

文件 ▸ 导入Ctrl+I),然后选择 .proto 文件。粘贴内容同样可被识别(存在 syntax = "proto…",或存在包含 rpcservice)。

元素Restorm 如何处理
每个 service一个文件夹
每个 rpc一个 gRPC 请求
流式标识调用类型(unaryserver-streamclient-streambidirectional-stream
输入消息一条预填的示例消息,按该消息的结构构建
描述与类型API 文档与枚举

在 gRPC 导入模态框中填入运行中服务器的 host:port 地址。Restorm 会查询它的 reflection 服务,并构建出与从 .proto 导入相同的树。

“gRPC 服务器(reflection)”模态框:host 地址输入框、“使用 TLS”选项,以及可选的身份验证元数据表格

有两个显著的好处:

  1. 之后离线也能用。 获取到的描述符集会存储在每个所创建的请求上:即使 reflection 服务器不再可达,调用依然可用。
  2. 可以重新同步。 重新连接到同一个地址会被识别为对现有树的更新,而不是一次新的 导入。请求标签页上也有一个从 reflection 刷新按钮。

如果服务器没有实现 reflection,Restorm 会明确提示:此时请导入 .proto 文件。

gRPC 属于可重新同步的格式,两种方式都支持。参见 从源更新