【protobuf】ProtoBuf——proto3语法详解、oneof类型、map类型、默认值、通讯录添加联系方式和备注的功能实现
文章目录
- ProtoBuf
-
- 5. proto3语法详解
-
- 5.5 oneof类型
- 5.6 map类型
- 5.7 默认值
ProtoBuf
5. proto3语法详解
5.5 oneof类型
如果消息中有很多可选字段，但是将来只会有一个字段被设置，那么就可以利用oneof类型加强这一行为，也能有节约内存的效果。
我们定义了一个名为 other_contact 的 oneof 字段，其中包含两个可选字段：qq 和 weixin。这两个字段只能有一个会被设置。
oneof other_contact
{
// 其他联系⽅式：多选⼀
string qq = 1;
string weixin = 2;
}
同时也要注意：
可选字段的编号不可与非可选字段编号相同，以防冲突。
oneof 中不能使用 repeated 字段。
未来设置 oneof 字段值时，若设置多个，仅保留最后一次设置的成员，之前设置的会自动清除。
我们向我们的通讯录中添加oneof类型作为一种联系方式选择：
syntax = "proto3";
package contacts;
import "google/protobuf/any.proto"; // 引⼊ any.proto ⽂件
// 地址
message Address
{
string home_address = 1; // 家庭地址
string unit_address = 2; // 单位地址
}
// 联系⼈
message PeopleInfo
{
string name = 1; // 姓名
int32 age = 2; // 年龄
message Phone
{
string number = 1; // 电话号码
enum PhoneType
{
MP = 0; // 移动电话
TEL = 1; // 固定电话
}
PhoneType type = 2; // 类型
}
repeated Phone phone = 3; // 电话
google.protobuf.Any data = 4;
oneof other_contact
{
// 其他联系⽅式：多选⼀
string qq = 5;
string weixin = 6;
}
}
// 通讯录
message Contacts
{
repeated PeopleInfo contacts = 1;
}
protoc编译文件：
protoc --cpp_out=. contacts.proto
查看contacts.pb.h文件，这就是自动生成的有关oneo的函数：
判断类：
_internal_has_qq：判断是否设置了 qq 字段。
has_qq：通过调用 _internal_has_qq 获取是否设置了 qq 字段的信息。
设置类：
set_has_qq：设置 _oneof_case _ [0] 为 kQq 。
set_qq：在未设置 qq 时进行清理和初始化操作，然后设置 qq 的值。
_internal_set_qq：设置 qq 的值。
set_allocated_qq：根据传入的 qq 指针进行相应的设置和清理操作。
清除类：
clear_qq：在 _internal_has_qq 为真时，销毁 qq 字段并清除相关设置。
获取类：
qq：获取 qq 字段的值。
mutable_qq：获取可修改的 qq 字段。
_internal_qq：在设置了 qq 时获取其值，否则返回空字符串。
_internal_mutable_qq：在未设置 qq 时进行清理和初始化，然后返回可修改的 qq 字段。
release_qq：在设置了 qq 时释放并清除相关设置，未设置时返回空指针。
更新 write.cc ：
#include