关于Widows环境下protobuf初步学习指南.docVIP

关于protobuf初步学习指南 撰写人：马宇昌 时间：2011-12-28 本文档设置了文档结构，如果不方便阅读，选择视图-文档结构图进行辅助阅读。 前言 关于protobuf资料与源码可在官方网站以及下面站点寻找 HYPERLINK /p/protobuf/ /p/protobuf/ HYPERLINK /p/protobuf/downloads/list /p/protobuf/downloads/list HYPERLINK /intl/zh-CN/apis/protocolbuffers/docs/overview.html /intl/zh-CN/apis/protocolbuffers/docs/overview.html 1．protobuf简介（引用网络上的内容，目的是对protobuf有简洁的了解） protobuf是google提供的一个开源序列化框架，类似于XML，JSON这样的数据表示语言，其最大的特点是基于二进制，因此比传统的XML表示高效短小得多。虽然是二进制数据格式，但并没有因此变得复杂，开发人员通过按照一定的语法定义结构化的消息格式，然后送给命令行工具，工具将自动生成相关的类，可以支持java、c++、python等语言环境。通过将这些类包含在项目中，可以很轻松的调用相关方法来完成业务消息的序列化与反序列化工作。 protobuf在google中是一个比较核心的基础库，作为分布式运算涉及到大量的不同业务消息的传递，如何高效简洁的表示、操作这些业务消息在google这样的大规模应用中是至关重要的。而protobuf这样的库正好是在效率、数据大小、易用性之间取得了很好的平衡。 2．下载protobuf，我下载的是2.4.1版本 从 HYPERLINK /p/protobuf/downloads/list /p/protobuf/downloads/list网站下载需要的版本，目前最新的是2.4.1版本。下载protobuf-2.4.1.zip到H盘，解压后（最好选择右击压缩文件，解压到protobuf-2.4.1），找到vsprojects文件夹，阅读readme文件，里面介绍在windows下protobuf的使用方法。 3．安装编译protobuf （1）打开libprotobuf工程 vsprojects文件夹中有很多项目工程，它们属于同一个解决方案。使用VS2008打开libprotobuf工程，这里可能会遇到版本转换的问题，因为vsprojects中的protobuf是2005版本的。只要正常转换就可以了，不需要备份旧有的版本。转换后的protobuf解决方案如图1所示 图1 protobuf解决方案 （2）编译解决方案 右击解决方案protobuf-生成解决方案，或者选择生成-生成解决方案，或者分别编译各个项目，右击各个项目，选择右击后菜单中的生成即可。编译过程一般不会有错。 （3）编译后生成需要的文件 编译完成后在vsprojects下的Debug文件夹下会生成我们需要的东西。 如图2，生成的exe文件 图2 生成的exe文件 如图3，生成的lib文件 图3 生成的lib文件 至此，我们完成了protobuf的安装与编译工作。如果要使用该protobuf，需要使用VS2008编译出来的libprotoc和libprotobuf两个类库。 4．protobuf的使用 （1）编译.proto文件方法 通用格式protoc -I=$SRC_DIR --cpp_out=$DST_DIR $SRC_DIR/*.proto A．定义to文件在H:\protobuf-2.4.1\protobuf-2.4.1\examples目录下。 to文件内容如下： package Im; message helloworld { required int32 id=1; required string str=2; optional int32 opt=3; } B．命令行进入protoc文件存在的目录，H:\protobuf-2.4.1\protobuf-2.4.1\vsprojects\Debug。 C．运行命令protoc -I=H:\protobuf-2.4.1\protobuf-2.4.1\examples --cpp_ out=H:\protobuf-2.4.1\protobuf-2.4.1\examples H:\protobuf-2.4.1\protobuf-2.4.1\e xamples\to。注意空格。 这样在examples文件夹下会生成两个文件person.pb.h和person.ph.cc文件。 （2）测试使用示例 在VS2008下创建一个工程ProtoBuf，