Protocol Buffer中文翻译.docx

Protocol Buffer中文翻译1简介41.1概览41.2什么是protocol buffer41.3他们如何工作41.4为什么不用XML51.5一点历史72语言指导72.1定义一个消息类型82.1.1指定字段类型82.1.2分配标识号82.1.3指定字段规则92.1.4添加更多消息类型92.1.5添加注释102.1.6从你的.proto文件生成了什么？102.2标量数值类型102.3可选的字段和默认值112.4枚举122.5使用其他消息类型122.5.1导入定义132.6嵌套类型142.6.1Groups152.7更新一个消息类型152.8扩展152.8.1嵌套的扩展162.8.2选择可扩展的标符号172.9包（Package）182.9.1包及名称的解析182.10定义服务(Service)182.11选项（Options）202.12自定义选项222.13生成访问类243编码风格253.1消息和字段名253.2枚举253.3服务264编码264.1一个简单的消息264.2Base 128 Varints264.3消息结构274.4更多的值类型284.4.1有符号整数284.4.2非varint数字294.4.3字符串294.5嵌套的消息304.6可选和重复元素304.6.1Packed Repeated字段304.7字段顺序315Protocol Buffer Basics: Java315.1定义proto文件315.2编译Protocol Buffers文件335.3Protocol Buffer API使用335.3.1枚举和嵌套类355.3.2Builders 对Messages355.3.3标准的Message方法355.3.4解析及序列化365.3.5写入消息365.3.6读取消息385.3.7对Protocol Buffer进行扩展395.4高级用法406Techniques40简介概览欢迎来到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 文件。?什么是protocol bufferProtocolBuffer是用于结构化数据串行化的灵活、高效、自动的方法，有如XML，不过它更小、更快、也更简单。你可以定义自己的数据结构，然后使用代码生成器生成的代码来读写这个数据结构。你甚至可以在无需重新部署程序的情况下更新数据结构。?他们如何工作你首先需要在一个 .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 文