4.Proto 3 语法详解
proto 3 语法详解https://i-blog.csdnimg.cn/direct/610f44d2e573478b9137fc4fc2b1a806.png
在语法详解部分, 依旧使用 项目推进 的方式完成讲授, 这个部分会对通讯录进行多次升级, 使用 2.x表示升级的版本, 最终版将会升级为如下内容:
[*]不再打印接洽人的序列化结果, 而是将通讯录序列化后并写入文件中.
[*]从文件中将通讯录解析出来, 并进行打印
[*]新增接洽人属性, 共包括: 姓名, 年事, 电话信息, 地点, 其他接洽方式, 备注.
字段规则
除了通例字段, 我们能否还可以给字段设置其他规则, 好比我想要一个数组范例的字段.
[*]singular: 消息中可以包罗该字段零次或一次, proto3语法中, 字段默认使用该规则
[*]repeated: 消息中可以包罗该字段任意多次(包括0次), 此中重复值的顺序会被保存. 可以明白为界说了一个数组.
更新contacts.proto, PeopleInfo消息中新增phone字段, 表示一个接洽人有多个号码, 可将其设置为repeated, 写法如下:
https://i-blog.csdnimg.cn/direct/4bba61d9ac424550acbb782acb3e29cd.png
消息范例的界说与使用
1.在单个.proto文件中可以界说多个消息体, 且支持界说嵌套范例的消息(任意多层), 每个消息体中的字段编号可以重复
2.消息范例可作为字段范例使用
https://i-blog.csdnimg.cn/direct/1f8001aedec14dd0bd0fd7ba87048e1a.png
https://i-blog.csdnimg.cn/direct/9399b81e70e8456b9496a09545910b6c.png
3.可导入其他.proto文件的消息并使用
https://i-blog.csdnimg.cn/direct/b15724e05a2b479585e0f4cc561d7884.png
https://i-blog.csdnimg.cn/direct/3d500f5410004932abf34338cc6021fc.png
创建通讯录2.0版本
下面我们来实现通讯录2.0版本, 向文件中写入通讯录列表
https://i-blog.csdnimg.cn/direct/e6ca620d9a154aa48e7eced4e4c00b73.png
进行编译生成
https://i-blog.csdnimg.cn/direct/7e506698f59e4629b1edf9d8aab89e6a.png
再次查看生成的.h文件
https://i-blog.csdnimg.cn/direct/ad8c57c5e0894c37b9786a289aec2c0f.png
https://i-blog.csdnimg.cn/direct/24bd54f921e74a4da92fae29940d79e3.png
https://i-blog.csdnimg.cn/direct/327dd36631874d1291c51d651fd68309.png
https://i-blog.csdnimg.cn/direct/748b03aad35e413b9c58d53eebb95df3.png
https://i-blog.csdnimg.cn/direct/63ef984b0039454da32bce00d81c7175.png
write.cc通讯录2.0的写入实现
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void AddPeopleInfo(contacts2::PeopleInfo* people){
cout << "------------------新增联系人----------------" << endl;
cout << "请输入联系人姓名: ";
string name;
getline(cin, name);
people->set_name(name);
cout << "请输入联系人年龄: ";
int age;
cin >> age;
people->set_age(age);
cin.ignore(256, '\n');
for (int i = 0;; i++){
cout << "请输入联系人电话" << i + 1 << "(只输入回车完成电话新增):";
string number;
getline(cin, number);
if (number.empty()) {
break;
}
contacts2::PeopleInfo_Phone* phone = people->add_phone();
phone->set_number(number);
}
cout << "-----------添加联系人成功-----------------" << endl;
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!input.is_open()) {
cout << "contacts.bin not find, create new file!" << endl;
} else if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 向通讯录中添加一个联系人
AddPeopleInfo(contacts.add_contacts());
// 将通讯录写入本地文件中
fstream output("contacts.bin", ios::out | ios::trunc | ios::binary);
if (!contacts.SerializeToOstream(&output)) {
cerr << "write error!" << endl;
input.close();
output.close();
return -1;
}
cout << "write success!" << endl;
input.close();
output.close();
return 0;
}
运行:
https://i-blog.csdnimg.cn/direct/163c78522bdf45d08456eaf7597859cb.png
先容在Linux查看二进制文件的工具: hexdump: 可以将二进制文件进行转换, 转换为对应的ASCII值, 以及八进制, 十进制, 十六进制的格式.
https://i-blog.csdnimg.cn/direct/4693b66639ba4501a8e2e2e28f49fedf.png
read.cc通讯录2.0的读取实现
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void PrintContacts(contacts2::Contacts& contacts) {
for (int i = 0; i < contacts.contacts_size(); ++i) {
cout << "------------------联系人" << i + 1 << "----------------------" << endl;
const contacts2::PeopleInfo& people = contacts.contacts(i);
cout << "联系人姓名: " << people.name() << endl;
cout << "联系人年龄: " << people.age() << endl;
for (int j = 0; j < people.phone_size(); ++j) {
const contacts2::PeopleInfo_Phone& phone = people.phone(j);
cout << "联系人电话" << j + 1 << ":" << phone.number() << endl;
}
}
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 打印通讯录列表
PrintContacts(contacts);
return 0;
}
运行:
https://i-blog.csdnimg.cn/direct/418957628b6b46f9870fedb75a2cb98b.png
我们也可以从标准输入中读取给定范例的二进制消息, 可以将其内容以文本的格式输出到标准输出上.
https://i-blog.csdnimg.cn/direct/b8db4478e3dd4e9e810f5f2a5fadcc09.png
有什么用呢? 我们之前存的contacts.bin存的是二进制序列, 想要看的话就需要写一个read.cc, 再通过打印的方式来查看内容是什么. 我们如今可以使用–decode命令, 使用一行命令就可以进行二进制消息的打印.
enum范例
proto3语法还支持我们界说罗列范例的字段, 在.proto文件中罗列范例的誊写规范为:
罗列范例名称: 使用驼峰定名法, 首字母大写. 例如: MyEnum
常量值名称: 全大写字母, 多个字母之间用 _ 毗连. 例如: ENUM_CONST = 0;
我们可以界说一个PhoneType的罗列范例, 界说如下:
https://i-blog.csdnimg.cn/direct/52a21fea69934fa782d3d1eef9966300.png
要注意罗列的界说有以下几种规则:
1.0值常量必须存在, 且要作为第一个元素. 这是为了与proto2的语义兼容: 第一个元素作为默认值, 且值为0.
2.罗列范例可以在消息外界说, 也可以在消息体内界说(嵌套).
3.罗列的常量值在32位整数的范围内. 但因负值无效因而不建议使用(与编码规则有关).
4.同级的罗列范例, 如果有相同的常量名称, 是会报错的.
https://i-blog.csdnimg.cn/direct/c5c752be5f3142898c30b3eeed40685d.png
https://i-blog.csdnimg.cn/direct/4d6cee95f28d42cca6f3f8edd6ec7992.png
什么是同级(同层)的罗列范例?
单个.proto文件下, 最外层罗列范例和嵌套罗列范例, 不算同级.
https://i-blog.csdnimg.cn/direct/5cfd30b5252b443687c29f6baed6e4b7.png
不会编译报错
https://i-blog.csdnimg.cn/direct/e1c44c42ed5244139100a5585c91393f.png
多个.proto文件下, 若一个文件引入了其他文件, 且每个文件都未声明package, 每个proto文件中的罗列范例都在最外层, 算同级
https://i-blog.csdnimg.cn/direct/7ec519a7df584fc8bea85fd78a6b4aec.png
https://i-blog.csdnimg.cn/direct/c2dd32d885344eb1a4bec61519ab3825.png
https://i-blog.csdnimg.cn/direct/90d73e375ca44111822ced11e0eb9870.png
多个.proto文件下, 若一个文件引入了其他文件, 且每个文件都声明了package, 不算同级.
https://i-blog.csdnimg.cn/direct/489417dc69574c2186e173914b88f7b1.png
https://i-blog.csdnimg.cn/direct/7f74b465034241afade39e7000ae9a32.png
此时就可以正常生成了
https://i-blog.csdnimg.cn/direct/0cdfac887c0b4e569bd45e6d1db77434.png
升级通讯录至2.1版本
更新contacts.proto, 新增罗列字段并使用, 更新内容如下:
https://i-blog.csdnimg.cn/direct/4040e9dd275a4540a7bbbdaab02518eb.png
进行编译
https://i-blog.csdnimg.cn/direct/0026bdac54e6428aa2fbe3f554c4bea4.png
查看对应.h文件
https://i-blog.csdnimg.cn/direct/83e6e9a3934c4b4cbc2b6373019d035e.png
https://i-blog.csdnimg.cn/direct/b2ce1e7f9bac46d8a7bc6080c3522b72.png
更新write.cc(通讯录2.1)
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void AddPeopleInfo(contacts2::PeopleInfo* people){
cout << "------------------新增联系人----------------" << endl;
cout << "请输入联系人姓名: ";
string name;
getline(cin, name);
people->set_name(name);
cout << "请输入联系人年龄: ";
int age;
cin >> age;
people->set_age(age);
cin.ignore(256, '\n');
for (int i = 0;; i++){
cout << "请输入联系人电话" << i + 1 << "(只输入回车完成电话新增):";
string number;
getline(cin, number);
if (number.empty()) {
break;
}
contacts2::PeopleInfo_Phone* phone = people->add_phone();
phone->set_number(number);
cout << "请输入该电话类型(1. 移动电话 2.固定电话): ";
int type;
cin >> type;
cin.ignore(256, '\n');
switch(type) {
case 1:
phone->set_type(contacts2::PeopleInfo_Phone_PhoneType::PeopleInfo_Phone_PhoneType_MP);
break;
case 2:
phone->set_type(contacts2::PeopleInfo_Phone_PhoneType::PeopleInfo_Phone_PhoneType_TEL);
break;
default:
cout << "选择有误! " << endl;
break;
}
}
cout << "-----------添加联系人成功-----------------" << endl;
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!input.is_open()) {
cout << "contacts.bin not find, create new file!" << endl;
} else if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 向通讯录中添加一个联系人
AddPeopleInfo(contacts.add_contacts());
// 将通讯录写入本地文件中
fstream output("contacts.bin", ios::out | ios::trunc | ios::binary);
if (!contacts.SerializeToOstream(&output)) {
cerr << "write error!" << endl;
input.close();
output.close();
return -1;
}
cout << "write success!" << endl;
input.close();
output.close();
return 0;
}
更新read.cc(通讯录2.1)
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void PrintContacts(contacts2::Contacts& contacts) {
for (int i = 0; i < contacts.contacts_size(); ++i) {
cout << "------------------联系人" << i + 1 << "----------------------" << endl;
const contacts2::PeopleInfo& people = contacts.contacts(i);
cout << "联系人姓名: " << people.name() << endl;
cout << "联系人年龄: " << people.age() << endl;
for (int j = 0; j < people.phone_size(); ++j) {
const contacts2::PeopleInfo_Phone& phone = people.phone(j);
cout << "联系人电话" << j + 1 << ":" << phone.number();
cout << " (" << phone.PhoneType_Name(phone.type()) << ")" << endl;
}
}
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 打印通讯录列表
PrintContacts(contacts);
return 0;
}
运行结果:
https://i-blog.csdnimg.cn/direct/275b39479d7148f6b058b55c74c3e1f2.png
Any范例
proto3语法还支持我们界说Any的字段, 可以明白为泛型范例, 使用时可以在Any中存储任意消息范例. Any范例的字段也可以用repeated来修饰.
Any范例是google已经帮我们界说好的范例, 在安装Protobuf时, 此中的include目次下已经界说好了.proto文件.
进行cat查看该文件
https://i-blog.csdnimg.cn/direct/a6862fdccf044b11aa686500657fb411.png
https://i-blog.csdnimg.cn/direct/163f6e65115340e2b0433c8f6e3d7dc5.png
https://i-blog.csdnimg.cn/direct/d50eb8dc072241f6b00e969ba8b3aec9.png
都是我们熟悉的语法, 阐明我们要学的Any就是一个message消息体
升级通讯录至2.2版本
通讯录2.2版本会新增接洽人的地点信息, 我们可以使用any范例的字段来存储地点信息.
更新contacts.proto(通讯录2.2), 更新内容如下:
https://i-blog.csdnimg.cn/direct/6ea22626b0a74af4a2604315344f238a.png
进行编译
https://i-blog.csdnimg.cn/direct/88121e49b18f482f9310fa848e57e4b7.png
查看生成的.h文件
https://i-blog.csdnimg.cn/direct/1555778a54fd42b190a176ea17f98eec.png
https://i-blog.csdnimg.cn/direct/78a977dbe80e427c93c0adf0a5632827.png
怎样将我们的any范例去存放通讯录的地点信息?
打开any.proto文件编译后的Any.h文件
https://i-blog.csdnimg.cn/direct/f7de99598cb24e658b310ef6838d0afc.png
https://i-blog.csdnimg.cn/direct/44de0598f99743c0a6ff7d7002e08e3d.png
更新write.cc(通讯录2.2)
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void AddPeopleInfo(contacts2::PeopleInfo* people){
cout << "------------------新增联系人----------------" << endl;
cout << "请输入联系人姓名: ";
string name;
getline(cin, name);
people->set_name(name);
cout << "请输入联系人年龄: ";
int age;
cin >> age;
people->set_age(age);
cin.ignore(256, '\n');
for (int i = 0;; i++){
cout << "请输入联系人电话" << i + 1 << "(只输入回车完成电话新增):";
string number;
getline(cin, number);
if (number.empty()) {
break;
}
contacts2::PeopleInfo_Phone* phone = people->add_phone();
phone->set_number(number);
cout << "请输入该电话类型(1. 移动电话 2.固定电话): ";
int type;
cin >> type;
cin.ignore(256, '\n');
switch(type) {
case 1:
phone->set_type(contacts2::PeopleInfo_Phone_PhoneType::PeopleInfo_Phone_PhoneType_MP);
break;
case 2:
phone->set_type(contacts2::PeopleInfo_Phone_PhoneType::PeopleInfo_Phone_PhoneType_TEL);
break;
default:
cout << "选择有误! " << endl;
break;
}
}
contacts2::Address address;
cout << "请输入联系人家庭地址: ";
string home_address;
getline(cin, home_address);
address.set_home_address(home_address);
cout << "请输入联系人单位地址: ";
string unit_address;
getline(cin, unit_address);
address.set_unit_address(unit_address);
people->mutable_data()->PackFrom(address);
cout << "-----------添加联系人成功-----------------" << endl;
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!input.is_open()) {
cout << "contacts.bin not find, create new file!" << endl;
} else if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 向通讯录中添加一个联系人
AddPeopleInfo(contacts.add_contacts());
// 将通讯录写入本地文件中
fstream output("contacts.bin", ios::out | ios::trunc | ios::binary);
if (!contacts.SerializeToOstream(&output)) {
cerr << "write error!" << endl;
input.close();
output.close();
return -1;
}
cout << "write success!" << endl;
input.close();
output.close();
return 0;
}
更新read.cc(通讯录2.2)
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void PrintContacts(contacts2::Contacts& contacts) {
for (int i = 0; i < contacts.contacts_size(); ++i) {
cout << "------------------联系人" << i + 1 << "----------------------" << endl;
const contacts2::PeopleInfo& people = contacts.contacts(i);
cout << "联系人姓名: " << people.name() << endl;
cout << "联系人年龄: " << people.age() << endl;
for (int j = 0; j < people.phone_size(); ++j) {
const contacts2::PeopleInfo_Phone& phone = people.phone(j);
cout << "联系人电话" << j + 1 << ":" << phone.number();
cout << " (" << phone.PhoneType_Name(phone.type()) << ")" << endl;
}
if (people.has_data() && people.data().Is<contacts2::Address>()) {
contacts2::Address address;
people.data().UnpackTo(&address);
if (!address.home_address().empty()) {
cout << "联系人家庭地址: " << address.home_address() << endl;
}
if (!address.unit_address().empty()) {
cout << "联系人单位地址: " << address.unit_address() << endl;
}
}
}
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 打印通讯录列表
PrintContacts(contacts);
return 0;
}
编译运行:
https://i-blog.csdnimg.cn/direct/baf210bb27184e73ae58dc7d1822d596.png
为什么用Any范例, 而不用void* 范例代替呢? 如果大家经历过, 记忆应该能更深刻一点.
不知道你们有没有调试过瓦解过的程序, 调试出来了就是因为使用了范例转换错误的, 所以没有范例查抄, 是很不安全的事. 当然原因不止这一点, 尚有一些原因(可以AI搜一下), 但我讲的这一点是比力重要的原因.
https://i-blog.csdnimg.cn/direct/8d362ba1399c46dfa0693a2da5f79df0.png
oneof范例
如果消息中有很多可选字段, 而且未来同时只有一个字段会被设置, 那么就可以使用oneof加强这个行为, 也能有节约内存的结果.
升级通讯录至2.3版本
通讯录2.3版本想新增接洽人的其他接洽方式, 好比qq或者微信号二选一, 我们就可以使用oneof字段来加强多选一这个行为.
更新contacts.proto, 更新内容如下:
https://i-blog.csdnimg.cn/direct/3f63d4235335443aa259615937dcc0e3.png
注意:
1.可选字段中的字段编号, 不能与非可选字段的编号冲突.
2.不能在oneof中使用repeated字段.
3.未来在设置oneof字段的时间, 如果你set了多个字段, 那么只会保存最后一次set的成员.
进行编译后查看.h文件
https://i-blog.csdnimg.cn/direct/d391407fecd24f6abb533c94fdf4b233.png
https://i-blog.csdnimg.cn/direct/599ff0ad2baf42288c4da63d5be98bbe.png
https://i-blog.csdnimg.cn/direct/e5ff706994184197a32771fcc52989b7.png
https://i-blog.csdnimg.cn/direct/9265ea75401e469ab9803f7e21f1bb1b.png
更新write.cc, 更内容如下:
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void AddPeopleInfo(contacts2::PeopleInfo* people){
cout << "------------------新增联系人----------------" << endl;
cout << "请输入联系人姓名: ";
string name;
getline(cin, name);
people->set_name(name);
cout << "请输入联系人年龄: ";
int age;
cin >> age;
people->set_age(age);
cin.ignore(256, '\n');
for (int i = 0;; i++){
cout << "请输入联系人电话" << i + 1 << "(只输入回车完成电话新增):";
string number;
getline(cin, number);
if (number.empty()) {
break;
}
contacts2::PeopleInfo_Phone* phone = people->add_phone();
phone->set_number(number);
cout << "请输入该电话类型(1. 移动电话 2.固定电话): ";
int type;
cin >> type;
cin.ignore(256, '\n');
switch(type) {
case 1:
phone->set_type(contacts2::PeopleInfo_Phone_PhoneType::PeopleInfo_Phone_PhoneType_MP);
break;
case 2:
phone->set_type(contacts2::PeopleInfo_Phone_PhoneType::PeopleInfo_Phone_PhoneType_TEL);
break;
default:
cout << "选择有误! " << endl;
break;
}
}
contacts2::Address address;
cout << "请输入联系人家庭地址: ";
string home_address;
getline(cin, home_address);
address.set_home_address(home_address);
cout << "请输入联系人单位地址: ";
string unit_address;
getline(cin, unit_address);
address.set_unit_address(unit_address);
people->mutable_data()->PackFrom(address);
cout << "请选择要添加的其他联系方式(1. qq 2. 微信号):";
int other_contact;
cin >> other_contact;
cin.ignore(256, '\n');
if (1 == other_contact) {
cout << "请输入联系人qq号: ";
string qq;
getline(cin, qq);
people->set_qq(qq);
} else if (2 == other_contact) {
cout << "请输入联系人微信号: ";
string wechat;
getline(cin, wechat);
people->set_wechat(wechat);
} else {
cout << "选择有误, 未成功设置其他联系方式! " << endl;
}
cout << "-----------添加联系人成功-----------------" << endl;
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!input.is_open()) {
cout << "contacts.bin not find, create new file!" << endl;
} else if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 向通讯录中添加一个联系人
AddPeopleInfo(contacts.add_contacts());
// 将通讯录写入本地文件中
fstream output("contacts.bin", ios::out | ios::trunc | ios::binary);
if (!contacts.SerializeToOstream(&output)) {
cerr << "write error!" << endl;
input.close();
output.close();
return -1;
}
cout << "write success!" << endl;
input.close();
output.close();
return 0;
}
更新read.cc, 更内容如下:
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void PrintContacts(contacts2::Contacts& contacts) {
for (int i = 0; i < contacts.contacts_size(); ++i) {
cout << "------------------联系人" << i + 1 << "----------------------" << endl;
const contacts2::PeopleInfo& people = contacts.contacts(i);
cout << "联系人姓名: " << people.name() << endl;
cout << "联系人年龄: " << people.age() << endl;
for (int j = 0; j < people.phone_size(); ++j) {
const contacts2::PeopleInfo_Phone& phone = people.phone(j);
cout << "联系人电话" << j + 1 << ":" << phone.number();
cout << " (" << phone.PhoneType_Name(phone.type()) << ")" << endl;
}
if (people.has_data() && people.data().Is<contacts2::Address>()) {
contacts2::Address address;
people.data().UnpackTo(&address);
if (!address.home_address().empty()) {
cout << "联系人家庭地址: " << address.home_address() << endl;
}
if (!address.unit_address().empty()) {
cout << "联系人单位地址: " << address.unit_address() << endl;
}
}
switch(people.other_contact_case()) {
case contacts2::PeopleInfo::OtherContactCase::kQq:
cout << "联系人qq: " << people.qq() << endl;
break;
case contacts2::PeopleInfo::OtherContactCase::kWechat:
cout << "联系人微信号: " << people.wechat() << endl;
break;
default:
break;
}
}
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 打印通讯录列表
PrintContacts(contacts);
return 0;
}
编译运行结果:
https://i-blog.csdnimg.cn/direct/0349e193e2bd4aa1a6297ac1dc5e217e.png
map范例
语法支持创建一个关联映射字段, 也就是可以使用map范例去声明字段范例
要注意的是:
1.key_type是除了float和bytes范例以外的任意标量范例, value_type可以是任意范例.
2.map字段不可以用repeated修饰
3.map中存入的元素是无序的
升级通讯录至2.4版本
通讯录2.4版本想新增接洽人的备注信息, 我们可以使用map范例字段来存储备注信息
更新contacts.proto, 更新内容如下:
https://i-blog.csdnimg.cn/direct/6a3117d3c2f24f29b267b458dc6b47b5.png
进行编译后查看.h文件
https://i-blog.csdnimg.cn/direct/22673d2330bc43679158ff90aa52de90.png
https://i-blog.csdnimg.cn/direct/1bdce87e41be4fe6bcc369d782da52e1.png
更新write.cc, 更新内容如下:
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void AddPeopleInfo(contacts2::PeopleInfo* people){
cout << "------------------新增联系人----------------" << endl;
cout << "请输入联系人姓名: ";
string name;
getline(cin, name);
people->set_name(name);
cout << "请输入联系人年龄: ";
int age;
cin >> age;
people->set_age(age);
cin.ignore(256, '\n');
for (int i = 0;; i++){
cout << "请输入联系人电话" << i + 1 << "(只输入回车完成电话新增):";
string number;
getline(cin, number);
if (number.empty()) {
break;
}
contacts2::PeopleInfo_Phone* phone = people->add_phone();
phone->set_number(number);
cout << "请输入该电话类型(1. 移动电话 2.固定电话): ";
int type;
cin >> type;
cin.ignore(256, '\n');
switch(type) {
case 1:
phone->set_type(contacts2::PeopleInfo_Phone_PhoneType::PeopleInfo_Phone_PhoneType_MP);
break;
case 2:
phone->set_type(contacts2::PeopleInfo_Phone_PhoneType::PeopleInfo_Phone_PhoneType_TEL);
break;
default:
cout << "选择有误! " << endl;
break;
}
}
contacts2::Address address;
cout << "请输入联系人家庭地址: ";
string home_address;
getline(cin, home_address);
address.set_home_address(home_address);
cout << "请输入联系人单位地址: ";
string unit_address;
getline(cin, unit_address);
address.set_unit_address(unit_address);
people->mutable_data()->PackFrom(address);
cout << "请选择要添加的其他联系方式(1. qq 2. 微信号):";
int other_contact;
cin >> other_contact;
cin.ignore(256, '\n');
if (1 == other_contact) {
cout << "请输入联系人qq号: ";
string qq;
getline(cin, qq);
people->set_qq(qq);
} else if (2 == other_contact) {
cout << "请输入联系人微信号: ";
string wechat;
getline(cin, wechat);
people->set_wechat(wechat);
} else {
cout << "选择有误, 未成功设置其他联系方式! " << endl;
}
for (int i = 0;; i++) {
cout << "请输入备注" << i + 1 << "标题(只输入回车完成备注新增):";
string remark_key;
getline(cin, remark_key);
if (remark_key.empty()) {
break;
}
cout << "请输入备注" << i + 1 << "内容: ";
string remark_value;
getline(cin, remark_value);
people->mutable_remark()->insert({remark_key, remark_value});
}
cout << "-----------添加联系人成功-----------------" << endl;
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!input.is_open()) {
cout << "contacts.bin not find, create new file!" << endl;
} else if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 向通讯录中添加一个联系人
AddPeopleInfo(contacts.add_contacts());
// 将通讯录写入本地文件中
fstream output("contacts.bin", ios::out | ios::trunc | ios::binary);
if (!contacts.SerializeToOstream(&output)) {
cerr << "write error!" << endl;
input.close();
output.close();
return -1;
}
cout << "write success!" << endl;
input.close();
output.close();
return 0;
}
更新read.cc, 更新内容如下:
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
void PrintContacts(contacts2::Contacts& contacts) {
for (int i = 0; i < contacts.contacts_size(); ++i) {
cout << "------------------联系人" << i + 1 << "----------------------" << endl;
const contacts2::PeopleInfo& people = contacts.contacts(i);
cout << "联系人姓名: " << people.name() << endl;
cout << "联系人年龄: " << people.age() << endl;
for (int j = 0; j < people.phone_size(); ++j) {
const contacts2::PeopleInfo_Phone& phone = people.phone(j);
cout << "联系人电话" << j + 1 << ":" << phone.number();
cout << " (" << phone.PhoneType_Name(phone.type()) << ")" << endl;
}
if (people.has_data() && people.data().Is<contacts2::Address>()) {
contacts2::Address address;
people.data().UnpackTo(&address);
if (!address.home_address().empty()) {
cout << "联系人家庭地址: " << address.home_address() << endl;
}
if (!address.unit_address().empty()) {
cout << "联系人单位地址: " << address.unit_address() << endl;
}
}
switch(people.other_contact_case()) {
case contacts2::PeopleInfo::OtherContactCase::kQq:
cout << "联系人qq: " << people.qq() << endl;
break;
case contacts2::PeopleInfo::OtherContactCase::kWechat:
cout << "联系人微信号: " << people.wechat() << endl;
break;
default:
break;
}
if (people.remark_size()) {
cout << "备注信息: " << endl;
}
for (auto it = people.remark().cbegin(); it != people.remark().cend(); it++){
cout << " " << it->first << ": " << it->second << endl;
}
}
}
int main()
{
contacts2::Contacts contacts;
// 读取本地已存在的通讯录文件
fstream input("contacts.bin", ios::in | ios::binary);
if (!contacts.ParseFromIstream(&input)) {
cerr << "parse error!" << endl;
input.close();
return -1;
}
// 打印通讯录列表
PrintContacts(contacts);
return 0;
}
编译运行结果:
https://i-blog.csdnimg.cn/direct/0996c7021cf14f0991ab65386e14293c.png
至此, 我们2.4版本就正式完成了全部的需求.
默认值
反序列化消息时, 如果被反序列化的二进制序列中不包罗某个字段, 反序列化对象中相应字段时, 就会设置为该字段的默认值. 不同的范例对应的默认值不同:
[*]对于字符串, 默认值为空字符串
[*]对于字节, 默认值为空字节
[*]对于布尔值, 默认值为false
[*]对于数值范例, 默认值为0
[*]对于罗列, 默认值是第一个界说的罗列值, 必须为0
[*]对于消息字段, 如果未设置该字段, 它的取值是依赖于语言
[*]对于设置了repeated的字段的默认值是空的(通常是相应语言的一个空列表)
[*]对于消息字段, oneof字段和any字段, C++和java语言中都有hash_方法来检测当前字段是否被设置.
更新消息
反序列化消息时, 如果现有的消息范例已经不再满足我们的需求, 例如需要扩展一个字段, 在不破坏任何现有代码的环境下更新消息范例非常简单. 遵循如下规则即可:
[*]精致修改任何已有字段的字段编号.
[*]如果移除老字段, 要包管不再使用移除字段的字段编号. 正确的做法是保存字段编号(reserved), 以确保该编号将不能被重复使用. 不建议直接删除或注释掉字段.
[*]int32, uint32, int64, uint64和bool是完全兼容的, 可以从这些范例中的一个改为另一个, 而不破坏前后兼容性. 若解析出来的数值与相应的范例不匹配, 会采用与C++同等的处理方案(例如, 若将64位整数当做32位进行读取, 它将被截断为32位)
[*]sint32和sint64相互兼容但不与其他的整型兼容.
[*]string和bytes在正当UTF-8字节条件下也是兼容的.
[*]bytes包罗消息编码版本的环境下, 嵌套消息与bytes也是兼容的.
[*]fixed32与sfixed32兼容, fixed64与sfixed64兼容.
[*]enum与int32, uint32, int64和uint64兼容(注意若值不匹配会被截断), 要注意当反序
列化消息时会根据语言采用不同的处理方案：例如，未识别的proto3罗列范例会被保存在消息
中，但是当消息反序列化时怎样表示是依赖于编程语言的。整型字段总是会保持其的值。
[*]oneof:
[*]一个单独的值更改为新oneof范例成员之一是安全和二进制兼容的。
[*]若确定没有代码一次性设置多个值那么将多个字段移入一个新oneof范例也是可行的。
[*]将任何字段移入已存在的oneof范例是不安全的。
保存字段reserved
如果通过 删除 或 注释掉 字段来更新消息范例, 未来的用户在添加新字段时, 有可能会使用以前已经存在, 但已经被删除或注释掉的字段编号, 未来使用该.proto的旧版本时的程序会引发很多问题: 数据损坏, 隐私错误等等.
确保不会发生这种环境的一种方法是: 使用reserved将指定字段的编号或名称设置为保存项. 当我们再使用这些编号或名称时, protobuffer的编译器将会警告这些编号或名称不可用. 举个例子:
message Message {
// 设置保留项
reserved 100, 101, 200 to 299;
reserved "field3", "field4";
// 注意：不要在⼀⾏ reserved 声明中同时声明字段编号和名称。
// reserved 102, "field5";
// 设置保留项之后，下⾯代码会告警
int32 field1 = 100; //告警：Field 'field1' uses reserved number 100
int32 field2 = 101; //告警：Field 'field2' uses reserved number 101
int32 field3 = 102; //告警：Field name 'field3' is reserved
int32 field4 = 103; //告警：Field name 'field4' is reserved
}
创建通讯录3.0版本
验证 错误字段 造成的数据损坏
现模拟有两个服务, 他们各自使用一份通讯录.proto文件, 内容约定好了是千篇同等的. 唯一不同的是package的定名上
服务1: service 负责序列化通讯录对象, 并写入文件中.
服务2: client: 负责读取文件中的数据, 解析并打印出来.
一段时间后, service更新了自己的.proto文件, 更新了某个字段, 并新增了一个字段, 新增的字段使用了被删除字段的字段编号, 并将新的序列化对象写进了文件, 但Client并没有更新自己的.proto文件. 根据结论, 可能会出现数据损坏的征象, 接下来就让我们来验证下这个结论.
新增两个目次: service, client. 分别存放两个服务代码.
https://i-blog.csdnimg.cn/direct/c0ce1f2d843c4c32b30cfbf9b535db71.png
service目次下新增contacts.proto
syntax ="proto3";
package s_contacts;
//联系人
message PeopleInfo {
string name = 1; //姓名
int32 age = 2; //年龄
message Phone{
string number = 1; //电话号码
}
repeated Phone phone=3; //电话
}
//通讯录
message Contacts{
repeated PeopleInfo contacts = 1;
}
client目次下新增contacts.proto
syntax ="proto3";
package c_contacts;
//联系人
message PeopleInfo {
string name = 1; //姓名
int32 age = 2; //年龄
message Phone{
string number = 1; //电话号码
}
repeated Phone phone=3; //电话
}
//通讯录
message Contacts{
repeated PeopleInfo contacts = 1;
}
继承对service目次下新增service.cc, 复杂想文件中写通讯录消息, 内容如下:
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
using namespace s_contacts;
/**
* 新增联系⼈
*/
void AddPeopleInfo(PeopleInfo *people_info_ptr)
{
cout << "-------------新增联系⼈-------------" << endl;
cout << "请输⼊联系⼈姓名: ";
string name;
getline(cin, name);
people_info_ptr->set_name(name);
cout << "请输⼊联系⼈年龄: ";
int age;
cin >> age;
people_info_ptr->set_age(age);
cin.ignore(256, '\n');
for(int i = 1; ; i++) {
cout << "请输⼊联系⼈电话" << i << "(只输⼊回⻋完成电话新增): ";
string number;
getline(cin, number);
if (number.empty()) {
break;
}
PeopleInfo_Phone* phone = people_info_ptr->add_phone();
phone->set_number(number);
}
cout << "-----------添加联系⼈成功-----------" << endl;
}
int main(int argc, char *argv[])
{
GOOGLE_PROTOBUF_VERIFY_VERSION;//: 验证没有意外链接到与编译的头⽂件不兼容的库版
//本。如果检测到版本不匹配，程序将中⽌。注意，每个 .pb.cc ⽂件在启动时都会⾃动调⽤此宏。在使
//⽤ C++ Protocol Buffer 库之前执⾏此宏是⼀种很好的做法，但不是绝对必要的。
if (argc != 2)
{
cerr << "Usage: " << argv << " CONTACTS_FILE" << endl;
return -1;
}
Contacts contacts;
// 先读取已存在的 contacts
fstream input(argv, ios::in | ios::binary);
if (!input) {
cout << argv << ": File not found. Creating a new file." << endl;
}
else if (!contacts.ParseFromIstream(&input)) {
cerr << "Failed to parse contacts." << endl;
input.close();
return -1;
}
// 新增⼀个联系⼈
AddPeopleInfo(contacts.add_contacts());
// 向磁盘⽂件写⼊新的 contacts
fstream output(argv, ios::out | ios::trunc | ios::binary);
if (!contacts.SerializeToOstream(&output))
{
cerr << "Failed to write contacts." << endl;
input.close();
output.close();
return -1;
}
input.close();
output.close();
google::protobuf::ShutdownProtobufLibrary();
return 0;
}
service ⽬录下新增 makefile
service:service.cc contacts.pb.cc
g++ -o $@ $^ -std=c++11 -lprotobuf
.PHONY:clean
clean:
rm -f service
client ⽬录下新增 client.cc，负责向读出⽂件中的通讯录消息，内容如下
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
using namespace c_contacts;
/**
* 打印联系⼈列表
*/
void PrintfContacts(const Contacts& contacts) {
for (int i = 0; i < contacts.contacts_size(); ++i) {
const PeopleInfo& people = contacts.contacts(i);
cout << "------------联系⼈" << i+1 << "------------" << endl;
cout << "姓名：" << people.name() << endl;
cout << "年龄：" << people.age() << endl;
int j = 1;
for (const PeopleInfo_Phone& phone : people.phone()) {
cout << "电话" << j++ << ": " << phone.number() << endl;
}
}
}
int main(int argc, char* argv[]) {
GOOGLE_PROTOBUF_VERIFY_VERSION;//: 验证没有意外链接到与编译的头⽂件不兼容的库版
//本。如果检测到版本不匹配，程序将中⽌。注意，每个 .pb.cc ⽂件在启动时都会⾃动调⽤此宏。在使
//⽤ C++ Protocol Buffer 库之前执⾏此宏是⼀种很好的做法，但不是绝对必要的。
if (argc != 2) {
cerr << "Usage: " << argv << "CONTACTS_FILE" << endl;
return -1;
}
// 以⼆进制⽅式读取 contacts
Contacts contacts;
fstream input(argv, ios::in | ios::binary);
if (!contacts.ParseFromIstream(&input)) {
cerr << "Failed to parse contacts." << endl;
input.close();
return -1;
}
// 打印 contacts
PrintfContacts(contacts);
input.close();
google::protobuf::ShutdownProtobufLibrary();
return 0;
}
client ⽬录下新增 makefile
client:client.cc contacts.pb.cc
g++ -o $@ $^ -std=c++11 -lprotobuf
.PHONY:clean
clean:
rm -f client
编译运行结果:
https://i-blog.csdnimg.cn/direct/12db683846b24e868943bc1174270537.png
https://i-blog.csdnimg.cn/direct/e65c29247197406793f90d9fa8ad9072.png
接下来对service目次下的contacts.proto文件进行更新: 删除age字段, 新增birthday字段, 新增的字段使用被删除字段的字段编号.
更新后的contacts.proto内容如下:
syntax ="proto3";
package s_contacts;
//联系人
message PeopleInfo {
string name = 1; //姓名
// 删除年龄字段
// int32 age = 2; //年龄
int32 birthday = 2; //生日
message Phone{
string number = 1; //电话号码
}
repeated Phone phone = 3; //电话
}
//通讯录
message Contacts {
repeated PeopleInfo contacts = 1;
}
编译文件.proto后, 还需要更新一下对应的service.cc
#include <iostream>
#include <fstream>
#include "contacts.pb.h"
using namespace std;
using namespace s_contacts;
/**
* 新增联系⼈
*/
void AddPeopleInfo(PeopleInfo *people_info_ptr)
{
cout << "-------------新增联系⼈-------------" << endl;
cout << "请输⼊联系⼈姓名: ";
string name;
getline(cin, name);
people_info_ptr->set_name(name);
// cout << "请输⼊联系⼈年龄: ";
// int age;
// cin >> age;
// people_info_ptr->set_age(age);
// cin.ignore(256, '\n');
cout << "请输入联系人生日: ";
int birthday;
cin >> birthday;
people_info_ptr->set_birthday(birthday);
cin.ignore(256, '\n');
for(int i = 1; ; i++) {
cout << "请输⼊联系⼈电话" << i << "(只输⼊回⻋完成电话新增): ";
string number;
getline(cin, number);
if (number.empty()) {
break;
}
PeopleInfo_Phone* phone = people_info_ptr->add_phone();
phone->set_number(number);
}
cout << "-----------添加联系⼈成功-----------" << endl;
}
int main(int argc, char *argv[])
{
GOOGLE_PROTOBUF_VERIFY_VERSION;//: 验证没有意外链接到与编译的头⽂件不兼容的库版
//本。如果检测到版本不匹配，程序将中⽌。注意，每个 .pb.cc ⽂件在启动时都会⾃动调⽤此宏。在使
//⽤ C++ Protocol Buffer 库之前执⾏此宏是⼀种很好的做法，但不是绝对必要的。
if (argc != 2)
{
cerr << "Usage: " << argv << " CONTACTS_FILE" << endl;
return -1;
}
Contacts contacts;
// 先读取已存在的 contacts
fstream input(argv, ios::in | ios::binary);
if (!input) {
cout << argv << ": File not found. Creating a new file." << endl;
}
else if (!contacts.ParseFromIstream(&input)) {
cerr << "Failed to parse contacts." << endl;
input.close();
return -1;
}
// 新增⼀个联系⼈
AddPeopleInfo(contacts.add_contacts());
// 向磁盘⽂件写⼊新的 contacts
fstream output(argv, ios::out | ios::trunc | ios::binary);
if (!contacts.SerializeToOstream(&output))
{
cerr << "Failed to write contacts." << endl;
input.close();
output.close();
return -1;
}
input.close();
output.close();
google::protobuf::ShutdownProtobufLibrary();
return 0;
}
编译运行:
https://i-blog.csdnimg.cn/direct/27aca7a11b754bd383d586c346009ff1.png
https://i-blog.csdnimg.cn/direct/22635f25ce06454eaa55c2bfc2d017f1.png
这时问题便出现了, 我们发现输入的生日, 在反序列化时, 被设置到了使用了相同字段编号的年事上, 所以得出结论: 如果移除老字段, 要包管不再使用移除字段的字段编号, 不建议直接删除或注释掉字段, 如果直接删除或注释掉, 则会导致背面的开发职员不知道这个字段是否被删除, 那么正确的做法是保存字段编号(reserved), 以确保该编号将不能被重复使用
正确service目次下的contacts.proto写法如下:
syntax ="proto3";
package s_contacts;
//联系人
message PeopleInfo {
reserved 2;
string name = 1; //姓名
// 删除年龄字段
// int32 age = 2; //年龄
int32 birthday = 4; //生日
message Phone{
string number = 1; //电话号码
}
repeated Phone phone = 3; //电话
}
//通讯录
message Contacts {
repeated PeopleInfo contacts = 1;
}
不要忘记更新完contacts.proto要进行编译并重新编译程序, 运行结果:
https://i-blog.csdnimg.cn/direct/0f300a0381af4d57ac5a1c58c81accb7.png
https://i-blog.csdnimg.cn/direct/f73f2618c00f42ffbd5a6c81f13865a1.png
发现tianqi的年事为0, 这是由于新增时未设置年事, 通过client程序反序列化时, 给年事字段设置了默认值0.
根据以上例子, 有的同砚可能尚有一个疑问: 如果使用了reserved 2了, 那么service给tianqi设置的生日1210, client就没法读到了吗? 答案是可以的, 继承学习下面的位置字段即可发表答案.
未知字段
在通讯录3.0版本中, 我们想service目次下的contacts.proto新增了’生日’字段, 但对于client的代码并没有任何改动, 新增的’生日’字段在旧程序(client)中其实并没有丢失, 而是会作为旧程序的未知字段
原来, proto3在解析消息时总是会抛弃未知字段, 但在3.5版本中重新引入了对未知字段的保存机制. 所以在3.5或更高版本中, 未知字段在反序列化时会被保存, 同时也会包罗在序列化的结果中.
未知字段和自界说字段之间的关系图:
https://i-blog.csdnimg.cn/direct/0b068e8e7a584ae1aa7d3fb31a0afe6d.png
升级通讯录3.1版本
验证未知字段
https://i-blog.csdnimg.cn/direct/802b35bc220146d8889b59fa8e0e3558.png
更新client.cc, 在这个版本中, 需要打印出未知字段的内容. 更新的代码如下:
#include <iostream>
#include <fstream>
#include <google/protobuf/unknown_field_set.h>
#include "contacts.pb.h"
using namespace std;
using namespace c_contacts;
using namespace google::protobuf;
/**
* 打印联系⼈列表
*/
void PrintfContacts(const Contacts& contacts) {
for (int i = 0; i < contacts.contacts_size(); ++i) {
const PeopleInfo& people = contacts.contacts(i);
cout << "------------联系⼈" << i+1 << "------------" << endl;
cout << "姓名：" << people.name() << endl;
cout << "年龄：" << people.age() << endl;
int j = 1;
for (const PeopleInfo_Phone& phone : people.phone()) {
cout << "电话" << j++ << ": " << phone.number() << endl;
}
// 打印未知字段
const Reflection* reflection = PeopleInfo::GetReflection();
const UnknownFieldSet& unknowSet = reflection->GetUnknownFields(people);
for (int j = 0; j < unknowSet.field_count(); ++j) {
const UnknownField& unknow_field = unknowSet.field(j);
cout << "未知字段" << j + 1 << ":"
<< " 字段编号: " << unknow_field.number()
<< " 类型:" << unknow_field.type();
switch (unknow_field.type()) {
case UnknownField::Type::TYPE_VARINT:
cout << " 值: " << unknow_field.varint() << endl;
break;
case UnknownField::Type::TYPE_LENGTH_DELIMITED:
cout << " 值: " << unknow_field.length_delimited() << endl;
break;
}
}
}
}
int main(int argc, char* argv[]) {
GOOGLE_PROTOBUF_VERIFY_VERSION;//: 验证没有意外链接到与编译的头⽂件不兼容的库版
//本。如果检测到版本不匹配，程序将中⽌。注意，每个 .pb.cc ⽂件在启动时都会⾃动调⽤此宏。在使
//⽤ C++ Protocol Buffer 库之前执⾏此宏是⼀种很好的做法，但不是绝对必要的。
if (argc != 2) {
cerr << "Usage: " << argv << "CONTACTS_FILE" << endl;
return -1;
}
// 以⼆进制⽅式读取 contacts
Contacts contacts;
fstream input(argv, ios::in | ios::binary);
if (!contacts.ParseFromIstream(&input)) {
cerr << "Failed to parse contacts." << endl;
input.close();
return -1;
}
// 打印 contacts
PrintfContacts(contacts);
input.close();
google::protobuf::ShutdownProtobufLibrary();
return 0;
}
编译运行结果:
https://i-blog.csdnimg.cn/direct/91706e73c460444287221cc89918eae4.png
前后兼容性
根据上述的例子可以得出, pb是具有向前兼容的, 为了叙述方便, 把新增了 “生日” 属性的service称为 “新模块”; 未做变更的client称为 “老模块”
[*]向前兼容: 老模块可以或许正确识别新模块生成或发出的协议. 这时, 新增加的 “生日” 属性会被当做位置字段(pb 3.5版本及之后).
[*]向后兼容: 新模块也可以或许正确识别老模块生成或发出的协议.
前后兼容的作用: 当我们维护一个很巨大的分布式系统时, 由于你无法同时升级全部模块, 为了包管在升级过程中, 整个系统可以或许尽可能不受影响, 就需要包管通讯协议的 “向前兼容” 或 “向后兼容”
选项option
.proto文件中可以声明许多选项, 使用 option标注. 选项能影响proto编译器的某些处理方式
举个例子:
https://i-blog.csdnimg.cn/direct/af1e7e2a18914c1cbabe7a6c6bf91403.png
进行编译
https://i-blog.csdnimg.cn/direct/d89f670f3c314dfdb6e256f5ce63ca72.png
查看.h文件
https://i-blog.csdnimg.cn/direct/768815efcb234ab689d340b36a36ae1d.png
自界说范例继承的Message
我们加上这个option选项
https://i-blog.csdnimg.cn/direct/b3e92801760e4272a5d8d1f3b74b61e4.png
进行编译, 查看.h文件
https://i-blog.csdnimg.cn/direct/d1148e1340e5484286ec70b2f9bd67a4.png
自界说范例继承的MessageLite, 这是什么意思呢? 请继承看背面
option分为文件级, 消息级, 字段级 等等, 但并没有一种选项能作用于全部的范例
常用选项列举
optimize_for: 该选项为文件选项, 可以设置protoc编译器的优化级别, 分别为SPEED, CODE_SIZE, LITE_RUNTIME, 受该选项的影响, 设置不同的优化级别, 编译.proto文件后生成的代码内容不同
[*]SPEED: protoc编译器将生成的代码是高度优化的, 代码运行效率高, 但是由此生成的代码编译后会占用更多的空间, SPEED是默认选项, 所以我们之前写的代码都是SPEED级别的
[*]CODE_SIZE: proto编译器将生成最少的类, 会占用更少的空间, 但和SPEED恰恰相反, 它的代码运行效率较低, 这种方式适用在包罗大量的.proto文件, 但并不盲目追求速度的应用中.
[*]LITE_RUNTIME: 生成的代码执行效率高, 同时生成代码编译后的所占用空间也是非常少, 这是以牺牲protobuf提供的反射功能为代价的(之前的图片可以看到, 自界说类是先继承message类, 再继承messagelite类. 所以这就没有message类所提供的能力, 好比说reflection, description), 仅仅提供encoding + 序列化功能, 所以我们在毗连BP库时仅需链接libprotobuf-lite, 而非libprotobuf, 这种模式通常用于资源有限的平台, 例如移动手机平台中
allow_alias: 允许将相同的常量值分配给不同的罗列常量, 用来界说别名, 该选项为罗列选项.
举个例子:
https://i-blog.csdnimg.cn/direct/5aa9c9036dc942cf97fc291336691a52.png
ProtoBuf允许自界说选项并使用, 该功能大部分场景用不到, 在这里不扩展讲解.
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]