Protocol Buffers的安装使用和C++/Python入门示例

本文主要是介绍Protocol Buffers的安装使用和C++/Python入门示例，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

1. 介绍

protoc buffers是google公司开发和开源的一款数据序列化和反序列化的工具。Protocol Buffers 是一种轻便高效的结构化数据存储格式，可以用于结构化数据串行化，或者说序列化。它很适合做数据存储或 RPC 数据交换格式。可用于通讯协议、数据存储等领域的语言无关、平台无关、可扩展的序列化结构数据格式。官方支持C++、java和pthon语言，并且有大量的第三方语言支持，如php，ruby等。

2. 编译安装

wget http://protobuf.googlecode.com/files/protobuf-2.3.0.tar.gz .
 
./configure --prefix=/home/admin/work/protobuf-2.3.0/proto
 
make
 
make check
 
make install

我这里是用 –prefix 选项指定安装在/home/admin/work/protobuf-2.3.0/proto目录下，如果不指定目录，将默认安装在/usr/local/下。

安装完成后在 /home/admin/work/protobuf-2.3.0/proto 下将生成三个文件夹bin，include和lib

将 /home/admin/work/protobuf-2.3.0/proto/bin 加到PATH里面，还有lib目录加在LD_LIBRARY_PATH里面方便点。

cat ~/.bashrc
 
 
 
export PROTO_BUF=/home/admin/work/protobuf-2.3.0/proto
 
export PATH=$PROTO_BUF/bin:$PATH
 
export LD_LIBRARY_PATH=$PROTO_BUF/lib:$LD_LIBRARY_PATH

3. 编写.proto接口文件

参考网上的例子，写一个示例程序。该程序由两部分组成。第一部分被称为 Writer，第二部分叫做 Reader。Writer 负责将一些结构化的数据写入一个磁盘文件，Reader 则负责从该磁盘文件中读取结构化数据并打印到屏幕上。准备用于演示的结构化数据是 HelloWorld，它包含两个基本数据：

ID，为一个整数类型的数据

Str，这是一个字符串

package lm;
 
message helloworld
 
{
 
   required int32     id = 1;  // ID
 
   required string    str = 2;  // str
 
   optional int32     opt = 3;  //optional field
 
}

其中，package 名字叫做 lm，定义了一个消息 helloworld，该消息有三个成员，类型为 int32 的 id，另一个为类型为 string 的成员 str。opt 是一个可选的成员，即消息中可以不包含该成员。

文件保存为 lm.helloworld.proto

4. 编译.proto文件

`1`	`protoc -I=. --cpp_out=. lm.helloworld.proto`

或者写完整路径：

  1 /home/admin/work/protobuf-2.3.0/proto/bin/protoc -I=/home/admin/work/pbtest --cpp_out=/home/admin/work/pbtest /home/admin/work/pbtest/lm.helloworld.proto
 

5. 编写writer和reader程序

writer.cpp 将把一个结构化数据写入磁盘

#include "lm.helloworld.pb.h"
 
#include <iostream>
 
#include <fstream>
 
 
 
using namespace std;
 
 
 
int main(int argc, char* argv[]){
 
    lm::helloworld msg1;
 
    msg1.set_id(101);
 
    msg1.set_str("hello");
 
 
 
    //write the new address book back to disk.
 
    fstream output("./log", ios::out|ios::trunc|ios::binary);
 
 
 
    if(!msg1.SerializeToOstream(&amp;output)){
 
        cerr << "Failed to write msg." << endl;
 
        return -1;
 
    }
 
 
 
    return 0;
 
}

reader.cpp 读取文件 log 中的序列化信息并打印到屏幕上

#include "lm.helloworld.pb.h"
 
#include <iostream>
 
#include <fstream>
 
 
 
using namespace std;
 
 
 
void ListMsg(lm::helloworld msg){
 
    cout << msg.id() << endl;
 
    cout << msg.str() << endl;
 
}
 
 
 
int main(int argc, char* argv[]){
 
    lm::helloworld msg1;
 
 
 
    fstream input("./log", ios::in|ios::binary);
 
 
 
    if(!msg1.ParseFromIstream(&amp;input)){
 
        cerr << "Failed to parse msg." << endl;
 
        return -1;
 
    }
 
 
 
    ListMsg(msg1);
 
 
 
    return 0;
 
}

编译c++程序，注意要链接protobuf和pthread库。protobuf库文件在编译生成的lib目录下，需要export到LD_LIBRARY_PATH中。

g++ -g -o writer writer.cpp lm.helloworld.pb.cc -I. -I/home/admin/work/protobuf-2.3.0/proto/include  -L/home/admin/work/protobuf-2.3.0/proto/lib -lprotobuf -pthread
 
g++ -g -o reader reader.cpp lm.helloworld.pb.cc -I. -I/home/admin/work/protobuf-2.3.0/proto/include  -L/home/admin/work/protobuf-2.3.0/proto/lib -lprotobuf -pthread

编译成功生成 writer和reader两个二进制文件，执行：

[admin@search11 pbtest]$ ./write
 
[admin@search11 pbtest]$ ./reader
 
101
 
hello

发现当前目录下多了个 log 文件，查看内容如下：

[admin@search11 pbtest]$ ll
 
total 764
 
-rw-rw-r--  1 baoniu baoniu  12362 Aug 18 23:49  lm.helloworld.pb.cc
 
-rw-rw-r--  1 baoniu baoniu   6775 Aug 18 23:49  lm.helloworld.pb.h
 
-rw-rw-r--  1 baoniu baoniu    173 Aug 18 23:49  lm.helloworld.proto
 
-rw-rw-r--  1 baoniu baoniu      9 Aug 19 00:02  log
 
-rwxrwxr-x  1 baoniu baoniu 366455 Aug 18 23:14  reader
 
-rw-rw-r--  1 baoniu baoniu    450 Aug 18 23:14  reader.cpp
 
-rwxrwxr-x  1 baoniu baoniu 364021 Aug 18 23:58  write
 
-rw-rw-r--  1 baoniu baoniu    444 Aug 18 23:14  writer.cpp
 
[admin@search11 pbtest]$ hexdump -c log
 
0000000  b   e 022 005   h   e   l   l   o                           
 
0000009