protocol buffer相关

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