Protocol Buffers十分钟上手:入门示例

时间:2022-06-06
本文章向大家介绍Protocol Buffers十分钟上手:入门示例,主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

1.简介

Protocol Buffers是Google出品并开源的语言和平台均中立的数据序列化和反序列化工具,官方支持C++/Java和Python三大语言,另外有大量的第三方实现支持PHP、D语言和C#等众多语言,这些都可以从Google Protocol Buffers的官方网站上找到链接。

2.安装Protocol Buffers工具

从http://code.google.com/p/protobuf/downloads/list上下载protobuf安装包,使用的是automake安装方式。安装成功后,将它的bin和lib目录分别加入到PATH和LD_LIBRARY_PATH环境变量,以方便直接调用。

3.编写接口文件

Protocol Buffers的接口文件以.proto为文件名的后缀,作用和语法都类似于Corba和MS COM的IDL,如果有这方面的基础,理解和使用起来会容易许多。x.proto文件的内容如下:

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

4.编译接口文件

调用protoc编译器进行编译:protoc x.proto --cpp_out=./oo,请注意需要指出输出文件,C++语言使用--cpp_out指出,其它语言可以查看帮助protoc --help,输出目录oo是必须事先创建好的,否则会报输出目录下存在。

编译成功后,将在oo目录下生成供应用调用的文件x.pb.h和x.pb.cc,编译自己代码的时候应当将x.pb.cc包含进去。

5.编写测试程序

测试程序x.cpp的内容如下:

#include "oo/x.pb.h"

int main()
{
        using namespace x;
        Person p;
        p.set_name("tom");
        p.set_id(88);
        p.set_email("xx@xx.com");

        std::string str;
        p.SerializeToString(&str); // 将对象序列化到字符串,除此外还可以序列化到fstream等

        printf("%sn", str.c_str());
  
        Person x;
        x.ParseFromString(str); // 从字符串反序列化
        printf("x.name=%sn", x.name().c_str()); // 这里的输出将是tom,说明反序列化正确
        return 0;
}

6.编译测试程序

g++ -g -o x x.cpp ./oo/x.pb.cc -I. -I/usr/local/protobuf/include -L/usr/local/protobuf/lib -lprotobuf -pthread

7.运行测试程序

./x
tomX    xx@xx.com

更多讨论请上: http://bbs.hadoopor.com/thread-1837-1-1.html