proto3

消息中可以包含该字段任意多次包括零次其中重复值的顺序会被保留。

可以理解为定义了⼀个数组。

syntax

⽂件中可以定义多个消息体且⽀持定义嵌套类型的消息任意多层。

每个消息体中的字段编号可以重复。

嵌套写法:

-------------新增联系⼈-------------

endl;cout

name);people_info_ptr-set_name(name);cout

请输⼊联系⼈年龄:

age;people_info_ptr-set_age(age);cin.ignore(256,

(int

(number.empty()){break;}PeopleInfo_Phone

*phone

people_info_ptr-add_phone();phone-set_number(number);}cout

endl;

库之前执⾏此宏是⼀种很好的做法但不是绝对必要的。

GOOGLE_PROTOBUF_VERIFY_VERSION;if

(argc

(!contacts.ParseFromIstream(input)){cerr

Failed

新增⼀个联系⼈AddPeopleInfo(contacts.add_contacts());//

contactsfstream

(!contacts.SerializeToOstream(output)){cerr

Failed

endl;input.close();output.close();return

-1;}input.close();output.close();google::protobuf::ShutdownProtobufLibrary();return

查看⼆进制⽂件

{GOOGLE_PROTOBUF_VERIFY_VERSION;if

(argc

(!contacts.ParseFromIstream(input)){cerr

Failed

contactsPrintfContacts(contacts);input.close();google::protobuf::ShutdownProtobufLibrary();return

}验证

表⽰从标准输⼊中读取给定类型的⼆进制消息并将其以⽂本格式写⼊标准输出。

消息类型必须在

语法⽀持我们定义枚举类型并使⽤。

在.proto⽂件中枚举类型的书写规范为

ENUM_CONST

0。

枚举类型可以在消息外定义也可以在消息体内定义嵌套。

枚举的常量值在

4.2

::PROTOBUF_NAMESPACE_ID::Message

public:using

::PROTOBUF_NAMESPACE_ID::Message::CopyFrom;void

CopyFrom(const

::PROTOBUF_NAMESPACE_ID::Message::MergeFrom;void

MergeFrom(

mutable_home_address();PROTOBUF_NODISCARD

std::string*

set_allocated_home_address(std::string*

home_address);//

mutable_unit_address();PROTOBUF_NODISCARD

std::string*

set_allocated_unit_address(std::string*

unit_address);

::PROTOBUF_NAMESPACE_ID::Message

public://

release_data();::PROTOBUF_NAMESPACE_ID::Any*

mutable_data();void

set_allocated_data(::PROTOBUF_NAMESPACE_ID::Any*

data);

类型字段设置和获取获取⽅法的⽅法名称与⼩写字段名称完全相同。

设置⽅法可以使⽤

mutable_

⽅法返回值为Any类型的指针这类⽅法会为我们开辟好空间可以直接对这块空间的内容进⾏修改。

Any

::PROTOBUF_NAMESPACE_ID::Message

{bool

::PROTOBUF_NAMESPACE_ID::Message

message)

UnpackTo(::PROTOBUF_NAMESPACE_ID::Message*

message)

::PROTOBUF_NAMESPACE_ID::Message

{enum

mutable_qq();PROTOBUF_NODISCARD

std::string*

mutable_weixin();PROTOBUF_NODISCARD

std::string*

set_allocated_weixin(std::string*

weixin);void

clear_o***r_contact();O***rContactCase

o***r_contact_case()

内的字段进⾏常规的设置和获取即可但要注意只能设置⼀个。

如果设置多个那么只会保留最后⼀次设置的成员。

清空

oneof

::PROTOBUF_NAMESPACE_ID::Message

{//

const;::PROTOBUF_NAMESPACE_ID::Map

std::string,

⽅法。

设置和获取获取⽅法的⽅法名称与⼩写字段名称完全相同。

设置⽅法为

mutable_

⽅法返回值为Map类型的指针这类⽅法会为我们开辟好空间可以直接对这块空间的内容进⾏修改。

默认值

反序列化消息时如果被反序列化的⼆进制序列中不包含某个字段反序列化对象中相应字段时就会设置为该字段的默认值。

不同的类型对应的默认值不同

对于字符串默认值为空字符串。

对于字节默认值为空字节。

对于布尔值默认值为

必须为

0。

对于消息字段未设置该字段。

它的取值是依赖于语⾔。

对于设置了

repeated

如果现有的消息类型已经不再满⾜我们的需求例如需要扩展⼀个字段在不破坏任何现有代码的情况下更新消息类型⾮常简单。

遵循如下规则即可

禁⽌修改任何已有字段的字段编号。

若是移除⽼字段要保证不再使⽤移除字段的字段编号。

正确的做法是保留字段编号reserved以确保该编号将不能被重复使⽤。

不建议直接删除或注释掉字段。

int32

uint32

是完全兼容的。

可以从这些类型中的⼀个改为另⼀个⽽不破坏前后兼容性。

若解析出来的数值与相应的类型不匹配会采⽤与

位整数当做

兼容注意若值不匹配会被截断。

但要注意当反序列化消息时会根据语⾔采⽤不同的处理⽅案例如未识别的

proto3

枚举类型会被保存在消息中但是当消息反序列化时如何表⽰是依赖于编程语⾔的。

整型字段总是会保持其的值。

oneof

oneof

字段来更新消息类型未来的⽤⼾在添加新字段时有可能会使⽤以前已经存在但已经被删除或注释掉的字段编号。

将来使⽤该

.proto

已序列化数据中的未识别字段的表⽰⽅式。

例如当旧程序解析带有新字段的数据时这些新字段就会成为旧程序的未知字段。

本来proto3

或更⾼版本中未知字段在反序列化时会被保留同时也会包含在序列化的结果中。

9.4

向前兼容⽼模块能够正确识别新模块⽣成或发出的协议。

向后兼容新模块也能够正确识别⽼模块⽣成或发出的协议。

前后兼容的作⽤当我们维护⼀个很庞⼤的分布式系统时由于你⽆法同时

升级所有

模块为了保证在升级过程中整个系统能够尽可能不受影响就需要尽量保证通讯协议的“向后兼容”或“向前兼容”。

option

编译器将⽣成的代码是⾼度优化的代码运⾏效率⾼但是由此⽣成的代码编译后会占⽤更多的空间。

SPEED

编译器将⽣成最少的类会占⽤更少的空间是依赖基于反射的代码来实现序列化、反序列化和各种其他操作。

但和

SPEED

恰恰相反它的代码运⾏效率较低。

这种⽅式适合⽤在包含⼤量的.proto⽂件但并不盲⽬追求速度的应⽤中。

LITE_RUNTIME

⽣成的代码执⾏效率⾼同时⽣成代码编译后的所占⽤的空间也是⾮常少。

这是以牺牲Protocol

encoding序列化

库时仅需链接libprotobuf-lite⽽⾮libprotobuf。

这种模式通常⽤于资源有限的平台例如移动⼿机平台中。

option

允许将相同的常量值分配给不同的枚举常量⽤来定义别名。

该选项为枚举选项。

举个例⼦