Google Protobuf Guide

首先，这只是一篇Protobuf的Guide，没有任何高级内容。

ProtoBuf是什么？

我只能说，你写过代码就会明白。它和序列化对象关联很紧密，类似功能的工具很多。如xml Json等都是用来序列化对象的。至于序列化对象是什么？还是那句话，你写过代码就会明白。我的语文不好，不能给大家描述清楚。我个人理解就是把对象存储在文件里。举个简单的例子，我们有一个Person类，表示一个人。如下：

class Person{
    public:
        void setName(const string & na);
        string getName();
    private:
        string name;
        int age;
        string sex;
}

有一个很明显的问题。程序运行结束，对象就消失了。相应地，对象的数据也消失了。序列化对象就是解决这个问题的（我说的可能不准确，大家酌情参考），把对象的字段存储到一个长期存在的文件里。例如Json XML等。这样，下次运行程序我们就可以从文件里读取对象信息了。肯定地，我们需要实现读取的方法。也就是反序列化

简介

什么是 Google Protocol Buffer？ 假如您在网上搜索，应该会得到类似这样的文字介绍： Google Protocol
Buffer( 简称 Protobuf) 是 Google 公司内部的混合语言数据标准，目前已经正在使用的有超过 48,162
种报文格式定义和超过 12,183 个 .proto 文件。他们用于 RPC 系统和持续数据存储系统。 Protocol Buffers
是一种轻便高效的结构化数据存储格式，可以用于结构化数据串行化，或者说序列化。它很适合做数据存储或 RPC
数据交换格式。可用于通讯协议、数据存储等领域的语言无关、平台无关、可扩展的序列化结构数据格式。目前提供了 C++、Java、Python
三种语言的 API。 或许您和我一样，在第一次看完这些介绍后还是不明白 Protobuf
究竟是什么，那么我想一个简单的例子应该比较有助于理解它。

传送门

下载，安装

下载：传送门

安装：

1. 找到 protobuf-2.6.1.tar.gz
2. 解压
3. ./configure
4. make
5. make check
6. make install

其实INSTALL.txt中已经告诉你怎么安装了，不过现在人比较急躁肯定没兴趣看。如果你想自己指定安装路径，可以在第三步./configure 的时候加上--prefix=PATH 前缀。可参考：

By default, make install’ will install the package’s files in
/usr/local/bin/usr/local/man’, etc. You can specify an
installation prefix other than /usr/local' by givingconfigure’ the
option `–prefix=PATH’.

到这里算是安装成功了

使用

Protobuf文件的后缀名是.proto，我们在这里写一个info.liangsc.proto文件，如下：

package Info;

message Liangsc{
    required string name=1;
    required int32  age = 21;
    required string email = 2;
}

一个好的命名习惯是 ：

packageName.MessageName.proto

遵循这样的风格，上面的liangsc message有三个字段string类型的name int32的age string类型的email
现在我们编译这个文件：

protoc --cpp_out=./ ./info.liangsc.proto 

如果没有意外的话，会在当前目录下生成这两个文件：

info.liangsc.pb.h info.liangsc.pb.cc

OK，我们一个Writer和Reader类来操作一下。Writer负责修改对象的值，并把对象存储在一个二进制文件中。Reader负责从二进制文件中读取消息并打印到shell上

Writer.cc

#include "info.liangsc.pb.h"
#include <iostream>
#include <ios>
#include <fstream>
using std::cout;
using std::cin;
int main(int argc,char **argv){
    info::liangsc msg;
    msg.set_name("mark liang");
    msg.set_age(41);
    msg.set_email("[email protected]");
    //write the new info to disk
    std::fstream output("./info",std::ios::out | std::ios::trunc | std::ios::binary);

    if(!msg.SerializeToOstream(&output)){
        std::cerr<<"Serialize object failure"<<std::endl;
        return -1;
    }
    return 0;
}

Reader.cc

#include "info.liangsc.pb.h"
#include <google/protobuf/message.h>
#include <fstream>
#include <ios>
#include <iostream>
using std::cout;
using std::cin;
using std::ios;
void ListMsg(const info::liangsc &guy){
    cout<<guy.name()<<std::endl;
    cout<<guy.age()<<std::endl;
    cout<<guy.email()<<std::endl;
}
int main(int argc,char **argv){
    info::liangsc sc;
    {
        std::fstream input("./info",ios::in | ios::binary);
        if(!sc.ParseFromIstream(&input)){
            std::cerr<<"Faild to parse data"<<std::endl;
            return -1;
        }
    }
    ListMsg(sc);
}

编译这两个文件

++ -Wall -g ./info.liangsc.pb.cc  ./Writer.cc -o Writer -I. -I/usr/local/google/protobuf -L/usr/local/lib -lprotobuf -pthread

运行Writer会把信息写进info文件里，可用hexdump查看info的内容

hexdump -C -n 1000 -s skip info

内容如下：

00000000  0a 0a 6d 61 72 6b 20 6c  69 61 6e 67 12 1b 6c 69  |..mark liang..li|
00000010  61 6e 67 73 68 61 6f 63  6f 6e 67 31 39 39 34 40  |angshaocong1994@|
00000020  67 6d 61 69 6c 2e 63 6f  6d a8 01 29              |gmail.com..)|
0000002c

运行Reader

mark liang
41
liangshaocong1994@gmail.com

参考链接：
cnblog
ibm-mix