GoogleProtoBuf开发者指南.docVIP

ProtoBuf开发指南 - 非官方不完整版 概览 欢迎来到protocol buffer的开发者指南文档，一种语言无关、平台无关、扩展性好的用于通信协议、数据存储的结构化数据串行化方法。 本文档面向希望使用protocol buffer的Java、C++或Python开发者。这个概览介绍了protocol buffer，并告诉你如何开始，你随后可以跟随编程指导( /apis/protocolbuffers/docs/tutorials.html )深入了解protocol buffer编码方式( /apis/protocolbuffers/docs/encoding.html )。API参考文档( /apis/protocolbuffers/docs/reference/overview.html )同样也是提供了这三种编程语言的版本，不够协议语言( /apis/protocolbuffers/docs/proto.html )和样式( /apis/protocolbuffers/docs/style.html )指导都是编写 .proto 文件。 1.1???什么是protocol buffer ProtocolBuffer是用于结构化数据串行化的灵活、高效、自动的方法，有如XML，不过它更小、更快、也更简单。你可以定义自己的数据结构，然后使用代码生成器生成的代码来读写这个数据结构。你甚至可以在无需重新部署程序的情况下更新数据结构。 1.2???他们如何工作 你首先需要在一个 .proto 文件中定义你需要做串行化的数据结构信息。每个ProtocolBuffer信息是一小段逻辑记录，包含一系列的键值对。这里有个非常简单的 .proto 文件定义了个人信息: message Person { required string name=1; required int32 id=2; 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 PhoneNumber phone=4; } 有如你所见，消息格式很简单，每个消息类型拥有一个或多个特定的数字字段，每个字段拥有一个名字和一个值类型。值类型可以是数字(整数或浮点)、布 尔型、字符串、原始字节或者其他ProtocolBuffer类型，还允许数据结构的分级。你可以指定可选字段，必选字段和重复字段。你可以在( /apis/protocolbuffers/docs/proto.html )找到更多关于如何编写 .proto 文件的信息。 一旦你定义了自己的报文格式(message)，你就可以运行ProtocolBuffer编译器，将你的 .proto 文件编译成特定语言的类。这些类提供了简单的方法访问每个字段(像是 query() 和 set_query() )，像是访问类的方法一样将结构串行化或反串行化。例如你可以选择C++语言，运行编译如上的协议文件生成类叫做 Person 。随后你就可以在应用中使用这个类来串行化的读取报文信息。你可以这么写代码: Person person; person.set_name(John Doe); person.set_id(1234); person.set_email(jdoe@); fstream.output(myfile,ios::out | ios::binary); person.SerializeToOstream(output); 然后，你可以读取报文中的数据: fstream input(myfile,ios::in | ios:binary); Person person; person.ParseFromIstream(input); cout Name: () endl; cout E-mail: person.email() endl; 你可以在不影响向后兼容的情况下随意给数据结构增加字段，旧有的数据会忽略新的字段。所以如果使用ProtocolBuffer作为通信协议，你可以无须担心破坏现有代码的情况下扩展协议。 你可以在API参考( /apis/protocolbuffers/docs/reference/overview.html )中找到完整的参考，而关于ProtocolBu