1 / 35
文档名称:

Protobuf使用手册.doc

格式:doc   大小:199KB   页数:35页
下载后只包含 1 个 DOC 格式的文档,没有任何的图纸或源代码,查看文件列表

如果您已付费下载过本站文档,您可以点这里二次下载

分享

预览

Protobuf使用手册.doc

上传人:xunlai783 2019/5/25 文件大小:199 KB

下载得到文件列表

Protobuf使用手册.doc

相关文档

文档介绍

文档介绍:,定义我们程序中需要处理的结构化数据,在protobuf的术语中,结构化数据被称为Message。proto文件非常类似java或者C语言的数据定义,可以使用C或C++风格的注释。下面是一个proto文件的例子。packagetutorial;optionjava_package="";optionjava_outer_classname="AddressBookProtos";messagePerson{requiredstringname=1;requiredint32id=2;//=3;ype{MOBILE=0;HOME=1;WORK=2;}messagePhoneNumber{requiredstringnumber=1;ypetype=2[default=HOME];}repeatedPhoneNumberphone=4;}//{repeatedPersonperson=1;}一个proto文件主要包含package定义、message定义和属性定义三个部分,还有一些可选项。定义packagePackage在c++中对应namespace。对于Java,包声明符会变为java的一个包,。定义messageMessage在C++中对应class。Message中定义的全部属性在class中全部为private的。Message的嵌套使用可以嵌套定义,也可以采用先定义再使用的方式。Message的定义末尾可以采用java方式在不加“;”,也可以采用C++定义方式在末尾加上“;”,这两种方式都兼容,建议采用java定义方式。,可以使用C/C++/java风格的双斜杠(//) 语法格式。定义属性属性定义分为四部分:标注+类型+属性名+属性顺序号+[默认值],其示意如下所示。标注类型属性名属性顺序号[默认值]requiredstringname=1[default=””]; 其中属性名与C++和java语言类似,不再解释;下面分别对标注、类型和属性顺序号加以详细介绍。其中包名和消息名以及其中变量名均采用java的命名规则——驼峰式命名法,驼峰式命名法规则见附件1。标注标注包括“required”、“optional”、“repeated”三种,其中required表示该属性为必选属性,否则对应的message“未初始化”,debug模式下导致断言,release模式下解析失败;optional表示该属性为可选属性,不指定,使用默认值(int或者char数据类型默认为0,string默认为空,bool默认为false,嵌套message默认为构造,枚举则为第一个)repeated表示该属性为重复字段,可看作是动态数组,类似于C++中的vector。如果为optional属性,发送端没有包含该属性,则接收端在解析式采用默认值。对于默认值,如果已设置默认值,则采用默认值,如果未设置,则类型特定的默认值为使用,例如string的默认值为””。类型Protobuf的属性基本包含了c++需要的所有基本属性类型。protobuf属性C++属性java属性备注doubledoubledouble固定8个字节floatfloatfloat固定4个字节int32int32int32使用变长编码,对于负数编码效率较低,如果经常使用负数,建议使用sint32int64int64int64使用变长编码,对于负数编码效率较低,如果经常使用负数,建议使用sint64uint32uint32int使用变长编码uint64uint64long使用变长编码sint32int32int采用zigzag压缩,对负数编码效率比int32高sint64int64long采用zigzag压缩,对负数编码效率比int64高fixed32uint32int总是4字节,如果数据>2^28,编码效率高于unit32fixed64uint64long总是8字节,如果数据>2^56,编码效率高于unit32sfixed32int32int总是4字节sfixed64int64long总是8字节boolboolbooleanstringstringString一个字符串必须是utf-8编码或者7-bit的ascii编码的文本bytesstringByteString可能包含任意顺序的字节数据Union类型定义P

最近更新