一、简介

protocolbuffer(以下简称PB)是google 的一种数据交换的格式,它独立于语言,独立于平台。google 提供了三种语言的实现:javac++ 和 python,每一种实现都包含了相应语言的编译器以及库文件。由于它是一种二进制的格式,比使用 xml 进行数据交换快许多。可以把它用于分布式应用之间的数据通信或者异构环境下的数据交换。作为一种效率和兼容性都很优秀的二进制数据传输格式,可以用于诸如网络传输、配置文件、数据存储等诸多领域。

二、版本下载

目前的最新版是protoc-2.5.0,各个版本的下载列表的网址:http://code.google.com/p/protobuf/downloads/list

linux版本是protoc-2.5.0.tar.gz; windows版本是protoc-2.5.0.zip

三、安装

下面以linux为例 :

安装:$ tar -xzvf protoc-2.5.0.tar.gz 会解压出protobuf-2.5.0目录

$ cdprotobuf-2.5.0

$ ./configure --prefix=/usr/local/protobuf-2.5.0

$ make

$ make check

$ su 切换到root用户

# make install

配置:查看编译生成的目录

$ cd /usr/local/protobuf-2.4.1

$ ls

bin  include  lib

其中,bin中的protoc是.proto文件的处理器,可用这个工具生成cpp,java,python文件.

由于系统常用这个工具,可以将其ln或者直接拷贝到系统环境bin下

ln -s /usr/local/protobuf-2.4.1/bin/protoc /usr/bin/protoc

同样,可以将头文件ln或者直接拷贝到系统环境

ln -s /usr/local/protobuf-2.4.1/include/google /usr/include/google

将lib文件ln或者直接拷贝到系统环境

略,方法同上.

此时,protobuf的开发环境已经搭建了。

四 、proto buffer 的用法

  1. 数据结构体:
  2. message message_name{message_body;}
  3. message_body格式:
  4. 例如required int32 query = 1[defaut=10];
  5. 形式为:rule type name = value[other_rule];
  6. 规则:
  7. required表示必须具有该值域;
  8. optional表示可选的值域;
  9. repeated表示可重复的值域(即>=0);
  10. 其中requered/optional是常用rule,而repeated则不常用同时因为是历史遗留现使用repeated int32 samples=4[packed=true];形式;
  11. value值:
  12. value值最小为1,是底层编码时使用其中1-15占一位,>15则会占多位;
  13. 不同的message中的value值互不干扰,常以1开始计数。
  14. 数据类型之基本类型:
  15. .proto Type             C++ Type            Java Type
  16. double                  double              double
  17. float                   float               float
  18. int32                   int32               int
  19. int64                   int64               long
  20. uint32                  uint32              int
  21. uint64                  uint64              long
  22. sint32                  int32               int
  23. sint64                  int64               long
  24. fixed32                 uint32              int
  25. fixed64                 uint64              long
  26. sfixed32                int32               int
  27. sfixed64                int64               long
  28. bool                    bool                boolean
  29. string                  string              String
  30. bytes                   string              ByteString
  31. 数据类型之复杂类型:
  32. 复杂类型主要包括:枚举,其他message,groups等。
  33. 枚举定义例如:enum Corpus{WEB=0;LOCAL=1}
  34. 枚举定义在message中。
  35. 可以使用其他message作为类型来定义成员。
  36. groups我的理解有些像C++中的union结构。
  37. 嵌套定义:
  38. 可以嵌套定义message结构,而嵌套定义的message被其他message作为成员类型时需要形式为outmessage.inmessage形式。
  39. 包结构:
  40. 定义形式:package foo.bar;
  41. 对应C++中则生成两个命名空间foo和bar,且bar定义在foo中;
  42. 可以通过import "myproject/other_protos.proto";来引入.proto文件;
  43. 引用其他package中message时需要完整的package路径;
  44. Services:
  45. 主要用于RPC系统中,在.proto中定义接口;
  46. 定义形式如例子:
  47. service SearchService {
  48. rpc Search(SearchRequest) return (SearchResponse);
  49. }
  50. .proto文件编译:
  51. 格式:
  52. protoc -–proto_path=(.proto文件路径) -–cpp_out=(.cc .java生成文件路径) (.proto文件路径)/?.proto
  53. -–proto_path  简化为:  --I
  54. 其中可根据需要更改:cpp_out选项为java_out/python_out。
  55. 例子:
  56. protoc -I=./ --cpp_out=./ model.proto

五、简单实例

proto buf的后缀名是.proto

编写hello.proto,代码如下:

	 1 package hello;

	message Hello{
required int32 id = 1; //user id
required string name = 2; //user name
optional string email = 3; //user email
}

接着,要用protoc生成一个对应的类,我把它生成在./out目录里:

$ protoc hello.proto --cpp_out=./out

接下来,在out目录下,会生成两个文件:

$ ls

hello.pb.cc hello.pb.h

接下来,编写测试用的c++代码,hello.cc,代码如下:

#include <stdio.h>
#include <string.h>
#include "out/hello.pb.h"
usingnamespace std;
usingnamespace hello; int main()
{
Hello a;
a.set_id(0818);
a.set_name("liangzhijun"); string tmp;
bool ret = a.SerializeToString(&tmp);
if (ret)
{
printf("encode success!\n");
}else{
printf("encode faild!\n");
} Hello b; ret = b.ParseFromString(tmp);
if (ret)
{
printf("decode success!\n id= %d \n name = %s\n", b.id(), b.name().c_str());
}else{
printf("decode faild!\n");
} return0;
}

接着,编译一下这个代码,由于使用了protobuf的库,所以编译的时候,要把这些库也链接进来:

g++ hello.cc ./out/hello.pb.cc -o hello -I./out -I/usr/local/protobuf/include -L/usr/local/lib -lprotobuf

这样,就生成了测试程序。

运行一下:

$ ./hello 
encode success!
decode success!
id= 0818 
name = liangzhijun

六、参考

1.http://blog.csdn.net/eclipser1987/article/details/8525383

google protocol buffer 简介 版本 安装 使用 实例的更多相关文章

  1. Google Protocol Buffer安装编译及使用

    近期玩了玩谷歌的Protocol Buffer.以下就简介下 Google Protocol Buffer( 简称 Protobuf) 是 Google 公司内部的混合语言数据标准.眼下已经正在使用的 ...

  2. Google Protocol Buffer的安装与.proto文件的定义

    什么是protocol Buffer呢? Google Protocol Buffer( 简称 Protobuf) 是 Google 公司内部的混合语言数据标准. 我理解的就是:它是一种轻便高效的结构 ...

  3. Google Protocol Buffer的安装与.proto文件的定义(转)

    转自(https://www.cnblogs.com/yinheyi/p/6080244.html) 什么是protocol Buffer呢? Google Protocol Buffer( 简称 P ...

  4. Google Protocol Buffer 的使用和原理[转]

    本文转自: http://www.ibm.com/developerworks/cn/linux/l-cn-gpb/ Protocol Buffers 是一种轻便高效的结构化数据存储格式,可以用于结构 ...

  5. Google Protocol Buffer 的使用和原理

    Google Protocol Buffer 的使用和原理 Protocol Buffers 是一种轻便高效的结构化数据存储格式,可以用于结构化数据串行化,很适合做数据存储或 RPC 数据交换格式.它 ...

  6. 【Google Protocol Buffer】Google Protocol Buffer

    http://www.ibm.com/developerworks/cn/linux/l-cn-gpb/ Google Protocol Buffer 的使用和原理 Protocol Buffers ...

  7. 转Google Protocol Buffer 的使用和原理

    Google Protocol Buffer 的使用和原理 Protocol Buffers 是一种轻便高效的结构化数据存储格式,可以用于结构化数据串行化,很适合做数据存储或 RPC 数据交换格式.它 ...

  8. Google Protocol Buffer 的使用和原理(无论对存储还是数据交换,都是个挺有用的东西,有9张图做说明,十分清楚)

    感觉Google Protocol Buffer无论对存储还是数据交换,都是个挺有用的东西,这里记录下,以后应该用得着.下文转自: http://www.ibm.com/developerworks/ ...

  9. Google Protocol Buffer入门

    简介 Google Protocol Buffer( 简称 Protobuf) 是 Google 公司内部的混合语言数据标准,目前已经正在使用的有超过 48,162 种报文格式定义和超过 12,183 ...

随机推荐

  1. lufylegend基础知识1

    这是官方的介绍: lufylegend是一个HTML5开源引擎,它实现了利用仿ActionScript3.0的语法进行HTML5的开发, 包含了LSprite,LBitmapData,LBitmap, ...

  2. ormlite 在android中 排序 条件查询

    ormlite 在android中 排序 条件查询 all = dao.queryBuilder().orderBy("Id", true).where().eq("Ty ...

  3. React中的的JSX

    什么是JSX? JSX是JavaScript XML的缩写,其本质是js,表现形式类似于XML,与js区别在于可直接在里面编写html标签. 怎么使用JSX? 语法规则: JSX 的基本语法规则:HT ...

  4. 罪恶黑名单第四季/全集The Blacklist迅雷下载

    英文全名The Blacklist,第1季(2016)NBC.本季看点:<罪恶黑名单>我们知道:剧情紧接第三季结尾,每个人——Liz,Red以及特别行动组的其他人——似乎都有许多故事可说: ...

  5. python 批量重命名

    import osll=os.listdir(".")c=0for f in ll: c=c+1 os.rename(f,str(c)+".jpg")

  6. 监听home键+模拟home键

    一.监听home键首先定义一个广播接受者 HomeKeyReceiver package com.kale.floattest; import com.kale.floattest.service.D ...

  7. serializeArray()与 serialize()

    serialize()序列表表格内容为字符串,用于 Ajax 请求. serializeArray()序列化表格元素 (类似 '.serialize()' 方法) 返回 JSON 数据结构数据. .s ...

  8. PHP 5.4.17 发布!

    PHP 5.4.17发布.2013-07-04 经过1个RC 上个版本是2013-06-07的5.4.16.修正了大约20个Bug以及几个安全漏洞.尽管5.5.0正式版已经发布.但5.4还未停止更新. ...

  9. var this.value 可在任意地方 声明 类成员变量。如果可以利用在C++ 那该有多好啊

    var this.value 可在任意地方 声明 类成员变量.如果可以利用在C++ 那该有多好啊

  10. sql server 复制,镜像,日志传输及故障转移集群区别

    一, 数据库复制 SQL Server 2008数据库复制是通过发布/订阅的机制进行多台服务器之间的数据同步,我们把它用于数据库的同步备份.这里的同步备份指的是备份服务器与主服务器进行 实时数据同步, ...