Protobuf与Interface对比

本文对比了Protobuf和Interface这2种IDL的差异，帮助Dubbo协议开发者了解Protobuf，为后续转到Triple协议和Grpc协议做铺垫。

Protobuf与Interface这2种IDL的差异

1. 数据类型

1.1. 基本类型

[注]在Java中，无符号的32位和64位整数使用它们的有符号对数来表示，顶部位只存储在符号位中。

1.2. 复合类型

1.2.1. 枚举

• 原始pb代码

enum TrafficLightColor {
    TRAFFIC_LIGHT_COLOR_INVALID = 0;
    TRAFFIC_LIGHT_COLOR_UNSET = 1;
    TRAFFIC_LIGHT_COLOR_GREEN = 2;
    TRAFFIC_LIGHT_COLOR_YELLOW = 3;
    TRAFFIC_LIGHT_COLOR_RED = 4;
}

• 生成的java代码

枚举是常量，因此采用大写

1.2.2. 数组

• 原始pb代码

message VipIDToRidReq {
    repeated uint32 vipID = 1;
}

• 生成的java代码

底层实际上是1个ArrayList

2.2.3. 集合

PB不支持无序、不重复的集合，只能 借用数组实现，需要 自行去重。

2.2.4. 字典

• 原始pb代码

message BatchOnlineRes {
    map<uint32, uint32> onlineMap = 1;//在线状态
}

• 生成的java代码

2.2.5. 嵌套

• 原始pb代码

message BatchAnchorInfoRes {
    map<uint32, AnchorInfo> list = 1; //用户信息map列表
}
/*
* 对应接口的功能: 批量或单个获取用户信息
*/
message AnchorInfo {
    uint32 ownerUid = 1 [json_name="uid"]; //用户id
    string nickName = 2 [json_name="nn"]; //用户昵称
    string smallAvatar = 3 [json_name="savt"]; //用户头像全路径-小
    string middleAvatar = 4 [json_name="mavt"]; //用户头像全路径-中
    string bigAvatar = 5 [json_name="bavt"]; //用户头像全路径-大
    string avatar = 6 [json_name="avt"]; //用户头像
}

• 生成的java代码

3. 字段默认值

• 对于字符串，默认值为空字符串。
• 对于字节，默认值为空字节。
• 对于bools，默认值为false。
• 对于数字类型，默认值为零。
• 对于枚举，默认值为第一个定义的枚举值，它必须为0。
• 对于消息字段，未设置字段。 它的确切值是语言相关的。 有关详细信息，请参阅生成的代码指南。

4. 整体结构

5. 社区资料

• 社区主页地址：https://developers.google.cn/protocol-buffers/
• 社区开源地址：https://github.com/google/protobuf
• 相关jar的maven：http://mvnrepository.com/artifact/com.google.protobuf

最后修改 September 21, 2021: Bug fix miss mialbox (#953) (57cf51b)