企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
### 4.4 protobuf语法 protobuf 通常会把用户定义的结构体类型叫做一个消息,这里我们遵循惯例,统一称为消息。protobuf 消息的定义(或者称为描述)通常都写在一个以 .proto 结尾的文件中。 ##### A\) 一个简单的例子 ```protobuf syntax = "proto3"; //指定版本信息,不指定会报错 package pb; //后期生成go文件的包名 //message为关键字,作用为定义一种消息类型 message Person { string name = 1; //姓名 int32 age = 2; //年龄 repeated string emails = 3; //电子邮件(repeated表示字段允许重复) repeated PhoneNumber phones = 4; //手机号 } //enum为关键字,作用为定义一种枚举类型 enum PhoneType { MOBILE = 0; HOME = 1; WORK = 2; } //message为关键字,作用为定义一种消息类型可以被另外的消息类型嵌套使用 message PhoneNumber { string number = 1; PhoneType type = 2; } ``` ##### B\) 消息格式说明 消息由字段组成,每个消息的字段格式为: (字段修饰符 +)数据类型 + 字段名称 + 唯一的编号标签值; * 字段名称:蛇形或者驼峰 * 唯一的编号标签:代表每个字段的一个唯一的编号标签,在同一个消息里不可以重复。这些编号标签用与在消息二进制格式中标识你的字段,并且消息一旦定义就不能更改。需要说明的是标签在1到15范围的采用一个字节进行编码,所以通常将标签1到15用于频繁发生的消息字段。编号标签大小的范围是1到229 * 注释格式:向.proto文件添加注释,可以使用C/C++/java/Go风格的双斜杠(//) 语法格式 ##### C\) 数据类型 | **.proto Type** | **Go Type** | **Notes** | | :--- | :--- | :--- | | double | float64 | 64位浮点数 | | float | float32 | 32位浮点数 | | int32 | int32 | 使用变长编码,对于负值的效率很低,如果你的域有可能有负值,请使用sint64替代 | | uint32 | uint32 | 使用变长编码 | | uint64 | uint64 | 使用变长编码 | | sint32 | int32 | 使用变长编码,这些编码在负值时比int32高效的多 | | sint64 | int64 | 使用变长编码,有符号的整型值。编码时比通常的int64高效。 | | fixed32 | uint32 | 总是4个字节,如果数值总是比总是比228大的话,这个类型会比uint32高效。 | | fixed64 | uint64 | 总是8个字节,如果数值总是比总是比256大的话,这个类型会比uint64高效。 | | sfixed32 | int32 | 总是4个字节 | | sfixed32 | int32 | 总是4个字节 | | sfixed64 | int64 | 总是8个字节 | | bool | bool | | | string | string | 一个字符串必须是UTF-8编码或者7-bit ASCII编码的文本。 | | bytes | \[\]byte | 可能包含任意顺序的字节数据。 | 更多详情请看:[https://developers.google.com/protocol-buffers/docs/encoding](https://developers.google.com/protocol-buffers/docs/encoding) ##### D\) 默认缺省值 当一个消息被解析的时候,如果被编码的信息不包含一个特定的元素,被解析的对象锁对应的域被设置位一个默认值,对于不同类型指定如下: * 对于strings,默认是一个空string * 对于bytes,默认是一个空的bytes * 对于bools,默认是false * 对于数值类型,默认是0