Protobuf数据类型映射

作者：术哥
发布时间：2022-04-20
821 次瀏覽
暫無評論
4390字数
分類：小技巧

数据类型映射

Protobuf数据类型	描述	打包	C++语言映射	GO语言映射
bool	布尔类型	1字节	bool	bool
double	64位浮点数	N	double	float64
float	32为浮点数	N	float	float32
int32	32位整数	N	int	int32
uin32	无符号32位整数	N	unsignedint	uint32
int64	64位整数	N	__int64	int64
uint64	64为无符号整	N	unsigned__int64	uint64
sint32	32位整数，处理负数效率更高	N	int32	int32
sing64	64位整数处理负数效率更高	N	__int64	int64
fixed32	32位无符号整数	4	unsignedint32	uint32
fixed64	64位无符号整数	8	unsigned__int64	uint64
sfixed32	32位整数、能以更高的效率处理负数	4	unsignedint32	int32
sfixed64	64为整数	8	unsigned__int64	int64
string	只能处理ASCII字符	N	std::string	string
bytes	用于处理多字节的语言字符、如中文	N	std::string	[]byte
enum	可以包含一个用户自定义的枚举类型uint32	N(uint32)	enum	结构体:struct/数据:int32
message	可以包含一个用户自定义的消息类型	N	objectofclass	struct

Tips

N 表示打包的字节并不是固定。而是根据数据的大小或者长度。
例如int32，如果数值比较小，在0~127时，使用一个字节打包。
关于枚举的打包方式和uint32相同，GO情况下不同。
关于message，类似于C语言中的结构包含另外一个结构作为数据成员一样。
关于 fixed32 和int32的区别。fixed32的打包效率比int32的效率高，但是使用的空间一般比int32多。因此一个属于时间效率高，一个属于空间效率高。根据项目的实际情况，一般选择fixed32，如果遇到对传输数据量要求比较苛刻的环境，可以选择int32。

映射到 JSON

对于前端数据交换还是用JSON会更加多一些，因此映射JSON后的结构体。

Proto3	JSON	JSON example
message	object	{"fooBar": v, "g": null, …}
enum	string	"FOO\_BAR"
map	object	{"k": v, …}
repeated V	array	[v, ...]
bool	true,false	true, false
string	string	"hello"
bytes	base64 string	"YWJjMTIzIT8kKiYoKSctPUB+"
int32, fixed32, uint32	number	1, -10, 0
int64, fixed64, uint64	string	"1", "-10"
float, double	number	1.1, -10.0, 0, "NaN", "Infinity"
Any	object	{"@type": "url", "f": v, … }
Timestamp	string	"1972-01-01T10:00:20.021Z"
Duration	string	"1.000340012s", "1s"
Struct	object	{...}
Wrapper types	various types	2, "2", "foo", true, "true", null, 0, …
FieldMask	string	"f.fooBar,h"
ListValue	array	[foo, bar, …]
Value	Value
NullValue	null
Empty	object	{}

最后修改：2022-04-20

© 允許規範轉載

如果觉得我的文章有意思，欢迎赞赏，我会努力创造更好的文章！

發表評論取消回复
填写正确的邮箱地址，可以收到本站评论回复通知（仅博主）本站将会使用Cookie保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

評論 *

私密評論

名稱 *

🎲

郵箱 *

地址

Protobuf数据类型映射

术哥 • 2022 年 04 月 20 日

<h1>数据类型映射</h1><table><thead><tr><th>Protobuf数据类型</th><th>描述</th><th>打包</th><th>C++语言映射</th><th>GO语言映射</th></tr></thead><tbody><tr><td>bool</td><td>布尔类型</td><td>1字节</td><td>bool</td><td>bool</td></tr><tr><td>double</td><td>64位浮点数</td><td>N</td><td>double</td><td>float64</td></tr><tr><td>float</td><td>32为浮点数</td><td>N</td><td>float</td><td>float32</td></tr><tr><td>int32</td><td>32位整数</td><td>N</td><td>int</td><td>int32</td></tr><tr><td>uin32</td><td>无符号32位整数</td><td>N</td><td>unsignedint</td><td>uint32</td></tr><tr><td>int64</td><td>64位整数</td><td>N</td><td>__int64</td><td>int64</td></tr><tr><td>uint64</td><td>64为无符号整</td><td>N</td><td>unsigned__int64</td><td>uint64</td></tr><tr><td>sint32</td><td>32位整数，处理负数效率更高</td><td>N</td><td>int32</td><td>int32</td></tr><tr><td>sing64</td><td>64位整数处理负数效率更高</td><td>N</td><td>__int64</td><td>int64</td></tr><tr><td>fixed32</td><td>32位无符号整数</td><td>4</td><td>unsignedint32</td><td>uint32</td></tr><tr><td>fixed64</td><td>64位无符号整数</td><td>8</td><td>unsigned__int64</td><td>uint64</td></tr><tr><td>sfixed32</td><td>32位整数、能以更高的效率处理负数</td><td>4</td><td>unsignedint32</td><td>int32</td></tr><tr><td>sfixed64</td><td>64为整数</td><td>8</td><td>unsigned__int64</td><td>int64</td></tr><tr><td>string</td><td>只能处理ASCII字符</td><td>N</td><td>std::string</td><td>string</td></tr><tr><td>bytes</td><td>用于处理多字节的语言字符、如中文</td><td>N</td><td>std::string</td><td>[]byte</td></tr><tr><td>enum</td><td>可以包含一个用户自定义的枚举类型uint32</td><td>N(uint32)</td><td>enum</td><td>结构体:struct/数据:int32</td></tr><tr><td>message</td><td>可以包含一个用户自定义的消息类型</td><td>N</td><td>objectofclass</td><td>struct</td></tr></tbody></table><h2>Tips</h2><ul><li>N 表示打包的字节并不是固定。而是根据数据的大小或者长度。</li><li>例如int32，如果数值比较小，在0~127时，使用一个字节打包。</li><li>关于枚举的打包方式和uint32相同，GO情况下不同。</li><li>关于message，类似于C语言中的结构包含另外一个结构作为数据成员一样。</li><li>关于 fixed32 和int32的区别。fixed32的打包效率比int32的效率高，但是使用的空间一般比int32多。因此一个属于时间效率高，一个属于空间效率高。根据项目的实际情况，一般选择fixed32，如果遇到对传输数据量要求比较苛刻的环境，可以选择int32。</li></ul><h1>映射到 JSON</h1><p>对于前端数据交换还是用JSON会更加多一些，因此映射JSON后的结构体。</p><table><thead><tr><th>Proto3</th><th>JSON</th><th>JSON example</th></tr></thead><tbody><tr><td>message</td><td>object</td><td>{"fooBar": v, "g": null, …}</td></tr><tr><td>enum</td><td>string</td><td>"FOO\_BAR"</td></tr><tr><td>map</td><td>object</td><td>{"k": v, …}</td></tr><tr><td>repeated V</td><td>array</td><td>[v, ...]</td></tr><tr><td>bool</td><td>true,false</td><td>true, false</td></tr><tr><td>string</td><td>string</td><td>"hello"</td></tr><tr><td>bytes</td><td>base64 string</td><td>"YWJjMTIzIT8kKiYoKSctPUB+"</td></tr><tr><td>int32, fixed32, uint32</td><td>number</td><td>1, -10, 0</td></tr><tr><td>int64, fixed64, uint64</td><td>string</td><td>"1", "-10"</td></tr><tr><td>float, double</td><td>number</td><td>1.1, -10.0, 0, "NaN", "Infinity"</td></tr><tr><td>Any</td><td>object</td><td>{"@type": "url", "f": v, … }</td></tr><tr><td>Timestamp</td><td>string</td><td>"1972-01-01T10:00:20.021Z"</td></tr><tr><td>Duration</td><td>string</td><td>"1.000340012s", "1s"</td></tr><tr><td>Struct</td><td>object</td><td>{...}</td></tr><tr><td>Wrapper types</td><td>various types</td><td>2, "2", "foo", true, "true", null, 0, …</td></tr><tr><td>FieldMask</td><td>string</td><td>"f.fooBar,h"</td></tr><tr><td>ListValue</td><td>array</td><td>[foo, bar, …]</td></tr><tr><td>Value</td><td>Value</td><td> </td></tr><tr><td>NullValue</td><td>null</td><td> </td></tr><tr><td>Empty</td><td>object</td><td>{}</td></tr></tbody></table>