了解 gRPC 类型
当发送或接收 gRPC 请求或响应时,来回发送的消息以称为 protobuf(协议缓冲区) 的格式传输。与其他基于文本的数据格式(例如 JSON 或 XML)不同,protobuf 使用二进制格式。二进制格式不适合人类阅读,因此 Postman 提供了一个JSON 接口,使你可以在使用 gRPC 时读写数据。
JSON 接口
Protobuf 类型 | JSON 类型 | JSON 示例 | 笔记 |
---|---|---|---|
信息 | 目的 | { "field": 123 } | null 是所有字段类型的可接受值,并被视为相应字段类型的默认值。 |
枚举 | 字符串或数字 | "FOO_BAR" | 枚举名称和整数值都被接受。 |
重复 V | 大批 | [v, ...] | |
地图<K, V> | 目的 | { "k": v } | 所有键都转换为字符串。 |
布尔值 | 布尔值 | true ,false | |
细绳 | 细绳 | "Hello World!" | |
字节 | base64 字符串或字节数组(数字 [0, 255]) | "SGVsbG8gZ1JQQw==" | |
int32、sint32、uint32、固定 32、sfixed32 | 数字 | 1 , -10 ,0 | |
int64, sint64, uint64, fixed64, sfixed64 | 数字或字符串 | "-1152921504606847254" | 十进制字符串用于提高与缺少 64 位整数的语言的兼容性。 |
浮动,双 | 号码或 "NaN" 或 "Infinity" 或 "-Infinity" | 1.1 , -10.0 , 0 ,"NaN" |
检查字段和类型
在为 gRPC 请求编写消息时,你将数据作为 JSON 输入。在内部,该 JSON 表示 Protocol Buffers 数据。例如,你可以输入一个 base64 JSON 字符串以bytes
在 Protocol Buffers 中表示。
Postman 使用 你选择的服务定义 在你撰写邮件时提供丰富的类型信息。当你将鼠标悬停在各种 JSON 字段或值上时,工具提示将解释该 JSON 字段或值的底层 Protocol Buffers 类型。这可以帮助你记住如何输入某些类型的数据,或了解内部发生的情况。