一、安装
sudo apt install libprotobuf-dev protobuf-compiler
二、编辑proto文件,生成代码文件
proto语法分为“proto2”和”proto3“两个版本,指定方法是在proto文件中第一行写入:syntax = "proto3"; ,这样指定使用proto3版本的语法,如果不指定,默认是使用proto2的语法。
两个语法的区别:
-
字段修饰符:在proto2中,需要指定字段修饰符为
optional(0个或者1个此字段)
、required(1个此字段)或
repeated(0个或多个此字段)
。而在proto3中,支持的字段修饰符为singular(0个或者1个此字段)、repeated(0个或多个此字段),不指定字段修饰符的话默认字段修饰符是singular,相当于proto2中optional。 -
默认值:在proto2中,字段可以有默认值,在定义后使用[default = xx]来指定。而在proto3中,不支持指定默认值,字符串默认空字符串,字节默认空字节,bool类型默认false,数字类型默认0等等。
-
oneof:在proto2中,可以使用
oneof
关键字来定义一组互斥的字段,只能有一个字段被设置。而在proto3中,oneof
功能保持不变,但默认情况下,一个oneof
字段将占用1个字节的空间。 -
Unknown Fields:在proto2中,未知字段(即消息中定义了但解析时不存在的字段)会被保留在
unknown_fields()
中,以便后续处理。而在proto3中,未知字段会被丢弃,但是在3.5版本及以后,好像又支持未知字段了。
使用注意事项:
-
字段的默认值:由于proto3中所有字段都没有默认值,因此在升级到proto3时需要特别注意字段的默认值,以确保正确地处理消息。
-
proto2和proto3混用:proto2和proto3是不兼容的,不能在同一个消息中混用这两种版本的字段。
使用protoc --cpp_out=<输出目录> <proto文件> ,就可以生成对应的代码文件。
三、常用接口方法
bool SerializeToString(string* output):将当前结构体对象序列化为string字符串,存储在output中。
bool ParseFromString(const string& data):把string类型的数据,转换到结构体。
bool SerializeToArray(void* data, int size):将当前结构体对象序列化为字节数组,存储在buffer中,存储size个字节。
bool ParseFromArray(const void * data, int size):从buffer中解析字节数组,并更新当前结构体对象的值。
void Clear():清除全部的字段,还原为各字段的默认值。用这个方法的好处是可以复用此结构,不用重新分配内存。
int64_t ByteSizeLong() 或 int ByteSize() :返回当前结构体对象序列化后的字节大小。ByteSize目前已经弃用,推荐使用ByteSizeLong()。
标签:protobuf,修饰符,字段,c++,proto2,proto3,使用,默认值,字节 From: https://www.cnblogs.com/zxq89/p/17600740.html