proto文件格式

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的优点：

1. 更简单
2. 比XML小3~10倍
3. 比XML快20~100倍
4. 语义定义明确
5. 自动生成数据存取类，更容易使用

缺点：

1. XML能更直观多标签的描述。
2. XML是子描述的，可以随机且交错读取读取文本节点。
3. XML是自描述的，而protobuf不是，protobuf必须要有格式定义文件(.proto 文件)。