protocol buffer简介
protocol buffer全称Google Protocol Buffers,是google开发的一套用于数据存储,网络通信的协议编解码的工具库,与XML或者JSON相差不多,即把某种数据结构的信息,以某种格式(XML,JSON)保存起来,但是protobuf与XML和JSON不同在于,protobuf是基于二进制的。与XML和JSON的性能相别则是不言而喻的。 关于相关的性能对比可以看这里。
protocol buffer版本比较
Protobuf目前为止有两个版本,proto2和proto3,proto3与proto2相比支持更多语言,更加简介,去掉了一些复杂的语法与特性,,更强调约定而弱化语法。
- 在第一行非空白非注释行写入syntax = "proto3";则表明此protobuf文件为proto3版本,如果不写入,或者写入syntax="proto2";则表示此protobuf文件为proto2版本;
- 字段规则移除了"required",并把"optional"改名为 "singular",
在 proto2 中required是不推荐使用的,proto3则直接从语法层面上移除了required规则; - 移除了default选项,在proto2中,可用default选项为某一字段指定默认值,而在proto3中,字段的默认值只能根据字段类型由系统决定;
- 移除了对扩展的支持,新增了 Any 类型;
Proto2语法格式
如下proto文件
syntax = "proto2";
package
msg;
message
CS_PlayerLogin{
required
string
account=1;
required
string
pwd=2;
}
message
SC_PlayerLogin{
//0成功 1账号错误 2密码错误
required
sint32
result=1;
required
uint64
playerId=2;
- syntax = "proto2";对应的proto版本;
- package msg;对应的包名;
- message:定义消息类型;消息中的每个字段可有三个选项(required,optional,repeated)
- required:必填字段;
- optional:选填字段,不填就会使用默认值,默认数值类型的默认值为0,string类型为空字符串,枚举类型为第一个枚举值;
- repeated:数组类型,可以放入多个类型实例。
之后再跟上数据类型,数据类型之后为字段名字,最后再跟上"=N",此处N是标志位,每个字段都有标志位,各个标志位不能重复且为正整数,其最大值为 2^29 - 1,同时protobuf内部预留了19000到19999不能被用户使用,官方建议将常用的字段放在前面,由于这个字段的大小随着数值大小增加,如1-16只占用一个字节(推荐消息字段个数不多余16个)。最后可以跟上自定义的默认值。
- 在一个proto文件中可以存放多个message,message内部也可以定义message,外部如需调用需要指明对应的层级关系。同时可以使用import引入外部的proto文件:
import
"person.proto";//引入外部proto文件,并让引入了该文件的proto文件也能访问被引入类型。
import
public
"person.proto";
protocol buffer基本数据类型
protocol buffer的常用基础数据类型:
数据类型 |
描述 |
字节个数 |
C#语言映射 |
bool |
布尔类型 |
1 |
bool |
double |
64位浮点数 |
N |
double |
float |
32为浮点数 |
N |
float |
int32 |
32位整数 |
N |
int |
uin32 |
无符号32位整数 |
N |
uint |
int64 |
64位整数 |
N |
long |
uint64 |
64为无符号整 |
N |
ulong |
sint32 |
32位整数,处理负数效率更高 |
N |
int |
sing64 |
64位整数 处理负数效率更高 |
N |
long |
fixed32 |
32位无符号整数 |
4 |
uint |
fixed64 |
64位无符号整数 |
8 |
ulong |
sfixed32 |
32位整数、能以更高的效率处理负数 |
4 |
uint |
sfixed64 |
64为整数 |
8 |
ulong |
string |
只能处理 ASCII字符 |
N |
string |
bytes |
用于处理多字节的语言字符、如中文 |
N |
string |
enum |
可以包含一个用户自定义的枚举类型uint32 |
N(uint32) |
enum |
message |
可以包含一个用户自定义的消息类型 |
N |
object of class |
map |
键值对,键可使用string或数值类型 |
N |
Dictionary |
- N表示打包的字节个数并不固定,取决于数据的大小;
原文地址:https://www.cnblogs.com/Yellow0-0River/p/8387729.html