protobuf 常用使用注意

`proto` 中，所有结构化的数据都为 `message`

message demo {
    required int32     id = 1;   //id 
    required string    str = 2;  //str 
    optional int32     opt = 3;  //optional field
}

syntax = "proto3";
...

范围 1 到 15 的字段编号需要一个字节进行编码，包括字段编号和字段类型。范围 16 ~ 2047 中的字段编号需要两个
字节。所以 1 ~ 15 作为非常频繁出现的消息元素。

message Test  {
    reserved 1, 2, 5 to 12;
    reserved "age", "addr";
}

各种语言标量类型对应

proto	C++	Java	Python	Go	C#	PHP
double	double	double	float	float64	double	float
float	float	float	floata	float32	float	float
int32	int32	int	int	int32	int	integer
int64	int64	long	int/long	int64	long	integer/string
uint32	uint32	int	int/long	uint32	uint	integer
uint64	uint64	long	int/long	uint64	ulong	integer/string
sint32	int32	int	int	int32	int	integer
sint64	int64	long	int/long	int64	long	integer/string
fixed32	uint32	int	int/long	uint32	uint	integer
fixed64	uint64	long	int/long	uint64	ulong	integer/string

sfixed32 | int32 | int | int | int32 | int | integer |

> php integer/string 注意，64位计算机用 integer，32位用 string

枚举为 0 的是作为零值，当不赋值的时候，就会是零值
为了和 proto2 兼容。在 proto2 中，零值必须是第一个值。

map<k_type, v_type> map_field = N;

example:
map<string, Demo> demos = 3;

proto3 支持 JSON 中的规范编码

message DemoReq {
    required string my_name = 1;
}

enum A {
    F_VAL = 0;
    S_VAL = 1;
}

持续更新

Author: josephzeng

Lastmod: <2021-03-20 Sat>