syntax="proto2" #语法格式
package tutorial; #包
#option:可赋值非必须赋值 java_package:java包名
option java_package = "com.example.tutorial";
#java类名,生成com.example.tutorial.AddressBookProtos java类
option java_outer_classname = "AddressBookProtos";
option csharp_namespace = "Google.ProtocolBuffers.Examples.AddressBook";
#message定义所需要序列化的数据的格式。每一个Message都是一个小的信息逻辑单元,
#包含了一些列的name-value对。
message Person {
required string name = 1; #required必须赋值,是永久性的
required int32 id = 2; // Unique ID number for this person.
optional string email = 3;
enum PhoneType { #枚举
MOBILE = 0;
HOME = 1;
WORK = 2;
}
message PhoneNumber {
required string number = 1;
optional PhoneType type = 2 [default = HOME];
}
#repeated类似数组或集合(java里是list)
repeated PhoneNumber phone = 4;
}
// Our address book file is just one of these.
message AddressBook {
repeated Person person = 1;
}
protobuf序列化结构化数据,比起XML的优点:
- 更简单
- 比XML小3~10倍
- 比XML快20~100倍
- 语义定义明确
- 自动生成数据存取类,更容易使用
缺点:
- XML能更直观多标签的描述。
- XML是子描述的,可以随机且交错读取读取文本节点。
- XML是自描述的,而protobuf不是,protobuf必须要有格式定义文件(.proto 文件)。