导入 gRPC(.proto 或 reflection)
有两条路径可以在 Restorm 中得到一棵 gRPC 树。
从 .proto 文件
Section titled “从 .proto 文件”文件 ▸ 导入(Ctrl+I),然后选择 .proto 文件。粘贴内容同样可被识别(存在
syntax = "proto…",或存在包含 rpc 的 service)。
| 元素 | Restorm 如何处理 |
|---|---|
每个 service | 一个文件夹 |
每个 rpc | 一个 gRPC 请求 |
| 流式标识 | 调用类型(unary、server-stream、client-stream、bidirectional-stream) |
| 输入消息 | 一条预填的示例消息,按该消息的结构构建 |
| 描述与类型 | API 文档与枚举 |
通过服务端 reflection
Section titled “通过服务端 reflection”在 gRPC 导入模态框中填入运行中服务器的 host:port 地址。Restorm 会查询它的
reflection 服务,并构建出与从 .proto 导入相同的树。

有两个显著的好处:
- 之后离线也能用。 获取到的描述符集会存储在每个所创建的请求上:即使 reflection 服务器不再可达,调用依然可用。
- 可以重新同步。 重新连接到同一个地址会被识别为对现有树的更新,而不是一次新的 导入。请求标签页上也有一个从 reflection 刷新按钮。
如果服务器没有实现 reflection,Restorm 会明确提示:此时请导入 .proto 文件。
gRPC 属于可重新同步的格式,两种方式都支持。参见 从源更新。