已阅读5页,还剩4页未读, 继续免费阅读
版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
最近领导分配了一个任务,这个工程挺高端的,主要以前从没有搞过,其中里面有protobuf,以前从来没有听说过这个东西,最近在网上看了一些高人的帖子,才知道protobuf是什么云云了,我的理解是,例如我们要用C+写个什么工程,C+是面向对象的,我们要写很多类,估计都得写上上百行,上千行的代码,但是现在用这个protobuf,就可以省很多是,我们只需要写消息包,然后编译,protobuf就会根据这个消息包自动生成两个文件.cc和.h,.h这两个文件中就有很多类,供我们调用。现在说明怎样在Ubuntu下安装protobuf。网上有人说,他用了很多版本的protobuf都没有成功,最终用的2.5.0版本才成功,于是我就直接安装了这个版本,至于其他版本成不成功,我就不知道了。首先下载protobuf源码包在Ubuntu的终端里输入:$ wget/files/protobuf-2.5.0.tar.gz这是在官网下载,但是我等了很长时间都没有下载下来,最后我在CSDN上下载下来了下载之后解压: $ tar xvzf protobuf-2.5.0.tar.gz进入到解压后的目录: $ cd protobuf-2.5.0进行执行 : $ ./configure 在执行./configure这个命令之前最好把vim ,g+,make安装好,不然在执行./configure的时候可能会出现错误,上面三个安装的命令:$sudo apt-get install vim $sudo apt-get install g+ $sudo apt-get install make ./configure成功之后,接下来是如下几步:$make$make check$make install /在执行这一步的时候,我出现了错误,错误的意思是执行的权限不够,如果是这样的话,$make install 这条命名就换成$sudo make install下面我们要修改一下配置文件:$ vim /.profile在打开的文件中,在文件末尾添加如下代码:export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib 然后保存退出,接下来执行: $ source /.profile使刚才修改的配置文件生效,接下来执行: $protoc -version如果上面的步骤一切顺利的话,那么就会在终端显示protobuf的版本号,如下下面我们来测试一下,在测试之前我们最好先建立一个文件夹,例如上面的proto,接下的操作都在这个文件夹下进行。我们先用vim创建并编辑.proto文件,例如: $ vim to内容如下:然后执行下面的命令: $ protoc -I=. -cpp_out=. to执行这条命名之后,在当前目录下就会生成如下的两个文件:这两个文件就是根据上面的那个to文件生成了,里面有类的声明和类的实现,我们可以进入这两个文件。研究一下,这里就不在说明了。然后我们就可以调用类和里面的函数实现自己的功能了,下面是两个简单的测试文件:我们先创建: $ vim write.cc内容如下:然后编译write.cc,命名如下:$ g+ msg.pb.cc write.cc -o write pkg-config -cflags -libs protobuf -lpthread执行生成的write文件,命令为:$ ./write可看到生成的msg.pb文件,这个文件是由fstream output(“./msg.pb”,ios:out|ios:trunc|ios:binary)函数生成的下面在创建一个文件:$ vim reader.cc内容如下:编译reader.cc文件:命令为:$ g+ msg.pb.cc reader.cc -o reader pkg-config -cflags -libs protobuf -lpthread然后执行生成的reader文件。命令如下:./reader在终端就会打印出:101Hello上面在生成可执行文件的过程,都是我们一条一条命令的输入,我们可以写Makefile,然后执行一条make命令,就可以自动生成可执行文件,编写Makefile文件: $ vim Makefile内容如下:编写完之后,执行:$make就会自动生成可执行文件write和readerProtobuffer语言详解:Defined A Message Typemessage SearchRequestrequired string query = 1;oprional int32 page_number = 2;optional int32 result_per_page = 3;上面 SearchRequest消息定义了三个fileds,每一个fileds都包含着该filed的name和type。 Message里面的每一个field都有一个unique numbered tag(也就是那些1 2 3 4)。这些tags用来在message binary format用来标识filed序号,如果这个message一旦被使用,建议必要轻易更改。需要注意的是,如果标记是1-15,那么当标记编码成二进制流的时候他们仅占一个字节,如果标记处于16-2047,标记将会占据两个字节,所以这里建议,对于那些需要频繁传输的数据尽量把他们放在前15位,这时编码key的时候就会尽量减少key的数据的大小,那么我们也应该留一些15因内的标记,以便将来可能会添加更频繁使用的filed。最小的标记是1,最大的是229-1,但是从19000到19999这些被protobuf 实现保留。Specifying Field Rules你必须声明你所声明的filed是如下一种:required:在你使用该消息时必须存在这种类型的filedoptional:在你使用该消息时该中filed可以不存在,但如果存在的只能存在一种repeated:该中类型的filed可以被重复使用任意从(包括0次),而且protobuf会保存设置的次序。Adding more message types在一个.proto文件中可以定义多个message。例如你想定义多个相关联的message,如下例在一个proto文件中有一个reques message和一个reponse messagemessage SearchRequestrequired string query = 1;optional int32 page_number = 2;optional int32 result_per_page = 3;message SearchResponse我们可以直接使用/在.proto文件中添加注释message SearchRequestrequired string query = 1;optional int32 page_number = 2; /which page number do we want?optional int32 result_per_page = 3;Whats Generated From Yto?当我们使用protocol buffer compiler编译一个.proto文件,编译器会生成与你所选语言(由编译选项决定-Java_Out 或者-Cpp_Out)相对应的代码。例如会生成所有字段的getter/setter,向输出流序列化你的messages以及从一个输入流中解析messagesForC+,编译器会生成一个.h和.cc文件, proto文件里每一个message都会对应生成一个class.ForJava,编译器会生成一个java文件.在该java文件中会有N个由messages对应生成的内部类,以及一个Builder内部类.Builder用来创建其他messages生成的类的实例Optional Fields And Default Values如果一个optional field已经被手动地设置过默认值,那么在解析该messages时,发现该field没有被使用,那么该field会被设置成默认值.如下例optional int32 result_per_page = 3 default = 10;那么如果没有手动地被设置过默认值那么就会采用系统默认值:string-, bool-false, numeric-0 ,enums -enums第一个value的默认值Enumerations在message中,可以使用枚举。Protobuf中的枚举以name/value形式出现。例如下例:VNIVERSAL = 0可以看出其value不是field_number你可以对一个枚举类型的filed指定默认值,但是如果你指定的的值不在枚举列表中,那么解析器会认为这个字段为不可识别的字段。message SearchRequest required string query = 1; optional int32 page_number = 2; optional int32 result_per_page = 3 default = 10; enum Corpus UNIVERSAL = 0; WEB = 1; IMAGES = 2; LOCAL = 3; NEWS = 4; PRODUCTS = 5; VIDEO = 6; optional Corpus corpus = 4 default = UNIVERSAL;Using Other Message Types我们可以采用其他的message作为我们的field类型.例如在下例中我们在同一.proto文件中定义了俩个messages,然后SearchResponse中使用Result作为field的类型.message SearchResponse repeated Result result = 1;message Result required string url = 1; optional string title = 2; repeated string snippets = 3;Importing Definitions在上例中Result和SearchResponse都定义在同一个.proto文件,那么如果俩个messages不在同一个.proto文件中怎么办呢?我们采用在文件顶部import其他.proto文件来访问其他proto文件中的messages.import myproject/other_to;你可以在messageA里定义一个新的messageB,然后在messageA里使用messageB.例如下例:message SearchResponse message Result required string url = 1; optional string title = 2; repeated string snippets = 3; repeated Result result = 1;当message不再满足你的需求,例如你想要添加一个字段,但是你仍想使用原来生成的代码,不想破坏现存的代码,只要记住如下规则,你就可以实现这个需求了不要改变原有fields的标记(序号).新添加的fields要设置成optionalorrepeated. 这意味着你的新代码可以解析由原有的message序列化而成的messages,而且不会丢失那些required元素.你应该对新的fields设置上明显的default values以便新的代码可以和由旧代码生成的message交互.标准方法:boolIsInitialized()const: 确认required字段是否被设置stringDebugString()const: 返回消息的可读表示,用于调试voidCopyFrom(constPerson&from): 使用给定消息值copyvoidClear(): 清除所有元素为空状态解析和序列化:boolSerializeToString(string*output)const: 序列化消息,将存储字节的以string方式输出。注意字节是二进制,而非文本;boolParseFromString(conststring&data): 解析给定的string boolSerializeToOstream(ostream*output)const: 写消息给定的c+ostream中boolParseFromIstream(istream*input): 从给定的c+istream中解析出消息当两个进程在进行远程通信时,彼此可以发送各种类型的数据。无论是何种类型的数据,都会以二进制序列的形式在网络上传送。发送方需要把这个对象转换为字节序列,才能在网络上传送;接收方则需要把字节序列在恢复为对象。把对象转换为字节序列的过程称为对象的序列化。把字节序列恢复为对象的过程称为对象的反序列化。Message PhoneNumberrequired string number = 1;optional PhoneTyep type = 2 default HOME; /是默认值Repeated PhoneNumber phone = 4; /repeated是重复的意思Protobuf消息的定义:消息由至少一个字段组合而成,类似于C语言中的结构体,每个字段都有一定的格式。字段格式: 限定修饰符1 数据类型2 字段名称3 = 字段编码值4 字段默认值51限定修饰符包括requiredoptionalrepeatedRequired:表示一个必须的字段,必须相当于发送方,在发送消息之前必须设置该字段的值,对于接收方,必须能够识别该字段的意思。发送之前的没有设置required字段或者无法识别required字段都会引起编码异常,导致消息被丢弃。 就好比你(发送方)去面试的时候,填写个人信息表,一个人必须要有身份证号,那么在表中身份证号这一栏必须的填。如果你不填那么HR(接收方)就会说,不行,你这张表无效,因为你的身份证号没有填写。Optional: 表示一个可选字段,可选对于发送方,在发送消息时,可以有选择性的设置或不设置该字段的值。对于接收方,如果能够识别可选字段则进行相应的处理,如果无法识别,则忽略该字段,消息中的其他字段正常处理。-因为optional字段的特征,很多接口在升级版本中都把后来添加的字段够统一的设置为optional,这样老的版本无需升级程序也可以正常的域新的软件进行通信,只不过新的字段无法识别而已,因为并不是每个节点都需要新的功能,因此可以做到按需升级和平滑过渡。 就好比个人信息表中家庭成员一栏,你(发送方)可以填,也可以不填,如果你填的话,HR(接收方)就把栏信息登记一下,你不填的话,HR就不登记了,不影响HR登记其他的信息。Repeated: 表示该字段可以包含0-n个元素,其特性和optional一样,但是一次可以包含多个值,可以看做是在传递一个数组的值。就好比你的教育经历,你可以只填你的大学经历这一项,也可以填大学和高中的经历,这两项,还可以填写大学、高中和初中,这三项经历。也就是桌教育经历可以填一个经历,也可以填多个经历。2.数据类型: protobuf定义了一套基本数据类型,几乎都可以映射到C+/Java等语言的基础数据类型:N表示打包的字节并不是固定的。而是根据数据的大小或者长度例如Int32 ,你在发送消息的时候,设置的值比较小,在0127之间,那么就使用一个字节打包。关于枚举的打包方式和uint32相同。关于message,类似于C语言中结构体包含另一个结构体作为数据成员一样。关于 fixed32 和int32的区别。fixed32的打包效率比int32的效率高,但是使用的空间一般比int32多。因此一个属于时间效率高,一个属于空间效率高。根据项目的实际情况,一般选择fixed32,如果遇到对传输数据量要求比较苛刻的环境,可以选择int323.字段名称: 字段名称的命名和C。C+灯语言的变量命名方式几乎是相同的。4.字段编码值有了该值,通信双方才能互相识别对方的字段。当然相同的编码值,其限定修饰符和数据类型必须相同。编码值的取值
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 2027年寒假开学摸底考试二年级科学基础卷及答案
- 2027年内蒙古中考政治试卷电子版
- 网络安全维护工程师网络维护绩效评估表
- 房地产销售顾问成交率与客户转化率绩效衡量表
- 项目进度缓慢催办确认函4篇范本
- 建筑设备维修项目经理工作评估表
- 医疗行业医生手术室工作绩效指标表
- 销售数据报表报送要求函7篇范文
- 陶瓷材料制备工艺流程规范手册
- 敏捷项目管理角色与职责指导手册
- 5M1E变更管理指导手册
- 2026年江苏省高考地理试卷真题(含答案及解析)
- 中国急性中毒救治指南(2026版)
- 2026年食品安全管理制度目录清单
- 治未病概念课件
- 滴滴出行网约车平台合同协议
- 3.1 走进桂林山水 课件+视频 2025-2026学年高中地理鲁教版必修一
- 《短视频编辑与制作实例教程(AIGC+全彩慕课版)》-课程标准
- 复杂肛瘘手术中括约肌功能的保护策略与临床实践
- 天龙功放AVR-X2000中文说明书
- GJB573B-2020引信及引信零部件环境与性能试验方法
评论
0/150
提交评论