4.4 protobuf语法

protobuf 通常会把用户定义的结构体类型叫做一个消息，这里我们遵循惯例，统一称为消息。protobuf 消息的定义（或者称为描述）通常都写在一个以 .proto 结尾的文件中。

A) 一个简单的例子

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) 数据类型

更多详情请看：https://developers.google.com/protocol-buffers/docs/encoding

D) 默认缺省值

当一个消息被解析的时候，如果被编码的信息不包含一个特定的元素，被解析的对象锁对应的域被设置位一个默认值，对于不同类型指定如下：

• 对于strings，默认是一个空string

• 对于bytes，默认是一个空的bytes

• 对于bools，默认是false

• 对于数值类型，默认是0