消息体定义

• 文件内定义

message Phone
{string number = 1;
}message PeopleInfo
{string name = 1;int32 age = 2;Phone phone = 3;
}

• 内嵌定义

message PeopleInfo
{string name = 1;int32 age = 2;message Phone{string number = 1;}Phone phone = 3;
}

• 文件外定义

// 文件 Phone.proto
syntax = "proto3";
package phone;message Phone
{string number = 1;
}

import "Phone.proto";
message PeopleInfo
{string name = 1;int32 age = 2;// 引⼊的⽂件声明了package，使⽤消息时，需要⽤ ‘命名空间.消息类型’ 格式phone.Phone phone = 3;
}

字段规则

消息的字段可以用下面几种规则来修饰：

• singular ：消息中可以包含该字段零次或⼀次（不超过⼀次）。proto3 语法中，字段默认使⽤该
  规则。
• repeated ：消息中可以包含该字段任意多次（包括零次），其中重复值的顺序会被保留。可以理解为定义了⼀个数组。

续回上篇，继续完善contacts.proto文件的内容

syntax = "proto3";
package contacts;message PeopleInfo
{string name = 1;int32 age = 2;// 采用内嵌式message Phone{string number = 1;}// repeated 修饰词 修饰的变量相当于数组repeated Phone phone = 3;
}// 通讯录
message Contacts
{repeated PeopleInfo contacts = 1;
}

编译选项

补充上篇：

• -h : protoc -h 表示帮助
  
  上图是所有内容，下面重点讲解一下 - decode
• decode
  大概意思是：从标准输入读取给定类型的二进制消息，并以文本格式将其写入标准输出。消息类型必须在PROTO FILES或其导入中定义。

先看用法

protoc -decode=contacts.Contacts contacts.proto < contacts.bin

执行指令后，结果如下

这个编译条件可以快速查看序列化后二进制文件的内容，是一个很便捷的操作

查看二进制内容的工具还有hexdump

hexdump：是Linux下的一个二进制文件查看工具，它可以将二进制文件转换为ASCII、八进制、十进制、十六进制格式进行查看。
-C: 表示每个字节显示为16进制和相应的ASCII字符

hexdump -C 二进制文件名
eg:hexdump -C contact.bin

实战：编写一个通讯录文件

上面完善编写了contacts.proto文件，现在完成写文件write.cpp和读文件read.cpp，write.cpp文件主要用于将通讯录信息通过protobuf的序列化，然后写入contact.bin文件内，read.cpp文件主要用于通过protobuf的反序列化，对contact.bin文件内容的读取。

write.cpp的编写

#include<iostream>
#include<fstream>
#include"contacts.pb.h"
using namespace std;void AddPeopleInfo(contact2::PeopleInfo *people)
{cout << "--------------新增联系⼈--------------" << endl;cout << "请输⼊联系⼈姓名: ";string name;getline(cin, name);people->set_name(name);cout << "请输⼊联系⼈年龄: ";int age;cin >> age;cin.ignore(256, '\n');  // 清除缓冲区的内容，大于256或遇到'\n'停止people->set_age(age);for(int i = 1; ;++i){cout <<  "请输⼊联系⼈电话" << i << "(只输⼊回⻋完成电话新增): ";string number;getline(cin, number);if(number.empty()) break;people->add_phone()->set_number(number);}cout << "-------------添加联系⼈成功-------------" << endl;
}int main()
{contacts::Contacts con;fstream in("contact.bin", ios::in | ios::binary);if(!in)cout << "contact.bin not exist, it is being created now" << endl;// ParseFromIstream方法的作用: 读取in里的内容并将其反序列化保存起来else if(!con.ParseFromIstream(&in)){cerr << "Fail to parse" << endl;in.close();return -1;}in.close();// 写入通讯录信息// 前文有提到，repeated修饰的变量相当于数组，所以// con.add_contacts()就相当新分配了一个contacts变量AddPeopleInfo(con.add_contacts());fstream out("contact.bin", ios::out | ios::trunc | ios::binary);// SerializeToOstream方法的作用: 读取out里的内容并将其序列化保存起来if(!con.SerializeToStream(&out)){cerr << "Fail to serialize" << endl;out.close();return -1;}cout << "write success" << endl;out.close();return 0;
}

执行效果如下：

read.cpp的编写

#include <iostream>
#include <fstream>
#include "contacts.pb.h"using namespace std;void PrintfContacts(contact2::Contacts &con)
{cout << "------------- 通讯录  -------------" << endl;for(int i = 0; i < con.contacts_size(); ++i){cout << "========= 联系人 " << i+1 << " =========" << endl;const contact2::PeopleInfo people = con.contacts(i);cout << "姓名：" << people.name() << endl;cout << "年龄：" << people.age() << endl;for(int j = 0; j < people.phone_size(); ++j){auto phone = people.phone(j);cout << "号码" << j+1 << ":" << phone.number() << endl;}}cout << "-------------------------------" << endl;
}int main()
{contact2::Contacts con;fstream in("contact.bin", ios::in | ios::binary);if(!in)cout << "contact.bin not exist, it is being created now" << endl;else if(!con.ParseFromIstream(&in)){in.close();return -1;}PrintfContacts(con);in.close();return 0;
}

执行效果如下：

补充：主要函数的使用

• bool ParseFromIstream(std::istream* input);
  Parse 系列的函数有很多，因为前面用了文件流提取内容，所以这里使用 Parse 系列的Istream()。
  作用：读取 input 里的内容并将其反序列化保存起来

• add_contacts()
  因为 Contacts 里的 contacts 字段被 repeat 修饰，所以相当于数组，这个函数是专门新增一个 contacts 变量的。（ps：因为有contacts所以才是 add_contacts() ，如果是 其他 那么就会对应生成 add_其他()）

• bool SerializeToOstream(std::ostream* output) const;
  作用: 读取 output 里的内容并将其序列化保存起来

• contacts_size();
  求变量个数（可以认为数组大小），注意 size 前面的名称是变量名称。

• set_变量名();
  代码里有出现，set_age(age)，set_name(name)，set_number(number) 没错，这些都是设置值的函数

以上函数均包含在 文件.pb.h 里，必要是时可以跳转进去里面学习函数使用，上面仅讲解了使用到的函数