protobuf

编译安装

        http://www.cnblogs.com/javaee6/p/4849051.html

使用

其实用法非常简单(暂时没有涉及到tcp的封包等问题):

1 proto文件的语法

主要的模板如下:

package tutorial; 这个包名会成为一个名字空间

message Person {
    required string name = 1;
    required int32 id = 2;
    optional string email = 3;

    enum PhoneType { // 嵌套定义的枚举类
        MOBILE = 0;
        HOME = 1;
        WORK = 2;
    }

    message PhoneNumber { // 嵌套定义的内部类
        required string number = 1;
        optional PhoneType type = 2 [default = HOME];
    }
    
    repeated PhoneNumber phone = 4;
}

message AddressBook {
    repeated Person person = 1;
}

以上的proto文件用protoc命令生成一个.h文件和一个.cc文件,这两个文件就是生成的类的定义。

注意:

required 规定必须提供字段,否则message就是没有初始化的。

optional 可以设置,也可以不设置字段。不设置字段时会使用默认值,可以指定可选字段的默认值。

     如果没有指定默认值,则对于数值类型,0是默认值;

     对于字符串,空字符串是默认值;

     对于bool类型,false是默认值;

     对于嵌入的message类型,默认值是此message的默认实例或者元类型,其中每个字段都没有设置。

     对于没有显示设定值的可选或者必选字段,调用访问器总是返回字段的默认值。

repeated 定义字段可以重复多次(包括0次)。各个重复的值的次序会保留,可以把重复字段看作是动态数组。

protoc -I=./ --cpp_out=./ XXXXXXXXXXXX.proto
其中-I指定的是proto文件所在的路径,--cpp_out是指定生成的c++类定义文件的路径,最后那个.proto指定的是具体的编写的proto文件的名称。

2 生成的类的定义与接口详解

每个mesage的生成的类定义会有如下的特性:

2.1 访问器方法(geter和seter):

1 访问器方法:
get方法就是字段的名称
set方法是set_后面加上字段的名称
如:
set方法:
inline void set_email(const std::string& value);
inline void set_email(const char* value);
get方法:
inline const ::std::string& email() const;

2 has_方法: 用来判断是否为(可选或者必选)字段设置过值
如:
inline bool has_email() const;

3 clear_方法: 清除字段值,使之成为空状态
如:
inline void clear_email();

4 字符串:多了mutable_方法,可以取得字段值的间接指针;还多了一个set_方法,是用char指针作为参数。
5 repeated字段,会有如下的方法:
A _size方法:判断有多少个元素
如:
inline int phone_size() const;

B 没有has_方法

C 通过索引取得或者更新元素
如:
inline const ::tutorial::Person_PhoneNumber& phone(int index) const;

D add_方法:加入新的元素
如:
inline ::tutorial::Person_PhoneNumber* add_phone();

2.2 枚举和嵌套类型

生成的代码含有枚举类型Person::PhoneType,其值可以是Person::MOBILE、Person::HOME、Person::WORK
生成的代码含有嵌套类Person::PhoneNumber,但是实际的名称是Person_PhoneNumber,如果需要前向声明,则需要使用名字Person_PhoneNumber。

2.3 标准消息方法

bool IsInitialized() const:是否所有必需的字段都已经设置
string DebugString() const:返回表示消息的人类可读的字符串,对于调试特别有用
void CopyFrom(const Person& from):复制
 void Clear():清除所有字段

2.4 解析和序列化

A bool SerializeToString(string* output) const;
序列化message,存储到string中。注意其中的字节是二进制的,而不是文本。也就是说序列化之后,如写入文件等,你仍然看不懂,因为是二进制的。

B bool ParseFromString(const string& data);
从字符串中解析出message,这就是反序列化。

C bool SerializeToOstream(ostream* output) const;
将消息写入到C++ ostream中。

D bool ParseFromIstream(istream* input);
从C++ istream中解析出消息。

以上也就是说,protocol buffer总共有那么两种类型的交互方式:一种就是直接跟string进行交互;还有一种就是跟istrem或者ostream进行交互。

3 可扩展性设计原则

应用发布之后,将来很可能需要改进protocol buffer定义。为保证新的格式向后兼容,旧的格式向前兼容,对于新版本的定义:
· 不得修改任何已有字段的序号
· 不得增加或者删除required字段
· 可以删除optional或者repeated字段
· 可以添加新的optional或者repeated字段,但是必须使用新的序号
   只要遵循上述规则,则旧的程序可以很好地处理新的消息(简单地忽略新的字段)。
· 对于旧的程序:被删除的optional字段具有默认值;被删除的repeated字段是空的。新的程序也可以透明地处理旧的消息。
· 但是:新的optional字段不会出现在旧的消息中,所以(新的程序)要么显式地调用has_方法进行检查,要么在.proto文件中字段序号后面用[default=value]定义默认值。
· 而且:新的repeated字段不会出现在旧的消息中,(新的程序)没法判断是(新的程序)把它设置成空了,还是(旧的程序)根本就没有设置这个字段,因为没有has_方法!

猜你喜欢

转载自my.oschina.net/u/1024767/blog/857136