字段内容的定义
//文件名：addressbook.proto
syntax = "proto2";//proto版本
//.proto文件新增一个可选的package声明符，用来防止不同的消息类型有命名冲突。
//包的声明符会根据使用语言的不同影响生成的代码。对于C++，产生的类会被包装在C++的命名空间中。
package tutorial;package声明符
message Person {
required string name = 1;//姓名，= 1 二进制编码中使用的唯一 “标记”
required int32 id = 2;//ID
optional string email = 3;//email
enum PhoneType {//枚举消息类型
MOBILE = 0;//proto3版本中，首成员必须为0，成员不应有相同的值
HOME = 1;
WORK = 2;
}
//
message PhoneNumber {
required string number = 1;
optional PhoneType type = 2 [default = HOME];
}
repeated PhoneNumber phones = 4;//phones为数组
}
message AddressBook {
repeated Person people = 1;
}
修饰符
- required 必须提供该字段的值，否则消息会被认为是”未初始化的“
- optional
表示属性值为可选项，不指定使用默认值。int和char数据类型默认为0，string默认为空，bool默认为false,嵌套message默认为构造，枚举为第一个
- repeated 表示该属性为重复字段，可看走是动态数组，类似于c++中的vector
如果为optional属性，发送端没有包含该属性，则接收端在解析式采用默认值。对于默认值，如果已设置默认值，则采用默认值，如果未设置，则类型特定的默认值为使用，例如string的默认值为”“。
字段类型
- package
相当于namespace
- message
相当于clas
- name
相当于属性值
引用方式
- 类成员函数变量
package::message.方法()
- 标准meaasge方法
1.bool IsInitialized() const;: 检查是否已设置所有必填 required 字段
2.string DebugString() const;: 返回 message 的人类可读表达，对调试特别有用
3.void CopyFrom(const Person& from);用给定的 message 的值覆盖 message
4.void Clear();: 将所有元素清除回 empty 状态
不同字段的方法
1)optional修饰的基本类型：
- set_属性名(val) ：初始化修改属性值；
- 属性名()：获取属性值，只读模式，返回类型是::google::protobuf::int64；
2）optional修饰的对象类型：
- 属性名()：返回只读的属性类型对象的引用，属性类型是指pb中定义的对象；
- mutable_属性名()：返回可修改的属性类型对象的指针，属性类型是指pb中定义的对象；
- set_属性名():初始化设置字段值
3）repeated修饰的基本类型：
- add_属性名(val)：向属性集合中添加元素；
- 属性名_size()：获取集合大小；
- 属性名(i)：返回集合中某一个元素，返回类型::google::protobuf::int64；
- 属性名()：返回只读的整个集合的引用，返回的集合类型是const ::google::protobuf::RepeatedField< ::google::protobuf::int64 >&，可以使用iterator来迭代遍历，可用于修改；
- mutable_属性()：返回可修改的整个集合的指针，返回的集合类型::google::protobuf::RepeatedField< ::google::protobuf::int64 >*，可以使用iterator来迭代遍历，可用于修改；
- set_属性名(int,x):设置repeated中元素的值
4）repeated修饰的对象类型：
- add_属性名()：返回可修改的属性类型对象的指针（集合中的一个元素），属性类型是指pb中定义的对象；
- 属性名_size()：获取集合大小；
属性名(i)：返回集合中某一个元素，返回的是只读的属性类型对象的引用，属性类型是指pb中定义的对象；
- mutable_属性名(i)：返回集合中某一个元素，返回的是可修改的属性类型对象的指针，属性类型是指pb中定义的对象；
- 属性名()：返回只读的整个集合的引用，集合类型是const ::google::protobuf::RepeatedPtrField< pb定义的对象>& XXX const;，可以使用iterator来迭代遍历；
- mutable_属性名()：返回可修改的整个集合的指针，集合类型是::google::protobuf::RepeatedPtrField< pb定义的对象>*，可以使用iterator来迭代遍历；
序列化
- required字段需要初始化,可以通过IsInitialized来检查是否完成message对象的初始化
- SerializedAsString(),SerializedToString(std::string* output) 把meaage编码进output
- SerializedToArray(void*,int)把message编码进数组buff
- SerializedToOstream(ostream*)把message编码到输出流
- ByteSize()获取二进制字节序的大小，可用于初始化存放容器
反序列化
- ParseFromString(std::string& data) 把data解码到message
- ParseFromArray(char* buf,int size)把buf解码到message,效率比第一个快很多
- ParseFromIstream(istream*)从istream输入流解码到message
- has_xxx()用于检查相应字段是否存在数据
- xxx_size()用于确定repeated字段是否存在，0表示未序列化
总结
本篇文章就到这里了，希望能给你带来帮助，也希望您能够多多关注编程网的更多内容！
