一 基本说明
.proto文件使用基本说明
结构定义文件为.proto
,可以使用import
包含另一个.proto
文件,注释使用//
二 语法
1 字段限制
required
: 必须赋值的字符
optional
: 可有可无的字段,可以使用[default = xxx]配置默认值
repeated
: 可重复变长字段,类似数组
2 tag
每个字段都有独一无二的tag
tag 1-15是字节编码,16-2047使用2字节编码,所以1-15给频繁使用的字段
3 类型
系统默认值:
string默认为空字符串;
bool默认为false;
数值默认为0;
enum默认为第一个元素
4 解析与序列化
每个message都包含如下方法,用于解析和序列化,注意目标是字节形式,非文本。
bool SerializeToString(string* output) const
: 将message序列化成二进制保存在output中,注意保存的是二进制,不是文本;仅仅是string作为容器。
bool ParseFromString(const string& data)
: 从给定的二进制数值中解析成message
bool SerializeToOstream(ostream* output) const
: 序列化到ostream中
bool ParseFromIstream(istream* input)
: 从istream中解析出message
三 举例介绍
1 建立.proto文件
建立.proto
文件定义message
,如下addressbook.proto
:
syntax = "proto2"; // 定义语法类型,通常proto3好于proto2,proto2好于proto1
package tutorial; // 定义作用域
message Person { // 生成类class Person : public ::google::protobuf::Message
required string name = 1;
required int32 id = 2;
optional string email = 3;
enum PhoneType { // 定义枚举类型,生成Person_PhoneType类型
MOBILE = 0;
HOME = 1;
WORK = 2;
}
message PhoneNumber { // 生成Person_PhoneNumber类
required string number = 1;
optional PhoneType type = 2 [default = HOME]; // 值必须是枚举类型中的一个
}
repeated PhoneNumber phones = 4;
}
message AddressBook {
repeated Person people = 1;
}
2 生成源文件
protoc -I=$SRC_DIR --cpp_out=$DST_DIR $SRC_DIR/addressbook.proto
其中protoc工具地址:protoc
1) message Person{}
会生成源码如下:
class Person : public ::google::protobuf::Message {
Person(); // 默认构造函数
~Person(); // 默认析构函数
Person(const Person& other); // 拷贝构造函数
Person& operator=(const Person& other); // 赋值构造函数
void Swap(Person* other); // 内容交换
const UnknownFieldSet& unknown_fields() const;
UnknownFieldSet* mutable_unknown_fields();
static const Descriptor* descriptor();
static const Foo& default_instance();
};
2) required string name
生成源码如下:
bool has_name() const; // 返回true,如果name被设置
void clear_name(); // 清除name,has_name会返回false
const ::std::string& name() const; // 返回name字符串
void set_name(const ::std::string& value); // 设置name字符串
::std::string* mutable_name(); // 可以修改的字符串,has_name会返回true
3) required int32 id
生成源码如下:
bool has_id() const; // 返回true,如果id被设置
int32 id() const; // 返回id数值
void set_id(int32 value); // 设置id数值
void clear_id(); // 清除id,has_id会返回false
4) message Person { message PhoneNumber }
生成类Person_PhoneNumber
,并在Person
类内定义:
typedef Person_PhoneNumber PhoneNumber;
其他消息如果要使用PhoneNumber
,使用方法如下:
message OtherPerson {
optional Person.PhoneNumber number = 1;
}
3 定义prototxt文件
定义如下:
people{
name : "Lucy"
id : 120
email : "lucy@163.com"
phones{
number : "13540737210"
type : HOME
}
}
4 代码中解析prototxt文件
/*************************************************************************
> File Name: main.cpp
> Author: ma6174
> Mail: ma6174@163.com
> Created Time: Wed 09 Jan 2019 11:04:56 PM CST
************************************************************************/
#include<iostream>
#include "tutorial.AddressBook.pb.h"
using namespace std;
int main() {
tutorial::Person one;
string filename = "one.prototxt";
ReadProtoFromTextFileOrDie(filename, &one);
return 0;
}
编译命令:
g++ main.cpp *.cc -std=c++11 `pkg-config --cflags --libs protobuf`
这一步编译报错:
main.cpp:15:43: error: ‘ReadProtoFromTextFileOrDie’ was not declared in this scope
ReadProtoFromTextFileOrDie(filename, &one);
^
需要进一步学习...
参考
[1] 官方指南.Protocol Buffer Basics: C++
[2] 博客.序列化之protobuf