（4.3.2.12）Android和Java的轻巧Wire协议缓冲器
https://github.com/square/wire
ire协议缓冲器 一个人必须有一个代码！ -奥马尔小 由于我们的团队和项目增长，数据的种类和数量也随之增加。 成功将您简单的数据模型转换为复杂的！ 无论您的应用程序将数据存储到磁盘或网络传送信号，该数据的结构和解释应该是清楚的。 消费者最好的工作，
Wire协议缓冲器
“一个人必须有一个代码！” -奥马尔小
由于我们的团队和项目增长，数据的种类和数量也随之增加。成功将您简单的数据模型转换为复杂的！无论您的应用程序将数据存储到磁盘或网络传送信号，该数据的结构和解释应该是清楚的。消费者最好的工作，他们了解的数据！
架构描述和文档数据模型。如果你有数据，你应该有一个架构。
协议缓冲器
谷歌的协议缓冲器都围绕一个伟大的模式语言：
-
它的跨平台和语言无关。无论您使用的编程语言，你就可以使用原架构与应用程序。
-
原始模式是向后兼容的，面向未来的。作为您的应用程序失去旧的功能和获得新的可以发展你的架构。
-
它的重点。原架构描述你的数据模型。而已。
下面是一个示例消息定义：
syntax = "proto2";
package squareup.dinosaurs; option java_package = "com.squareup.dinosaurs"; import "squareup/geology/period.proto"; message Dinosaur { // Common name of this dinosaur, like "Stegosaurus". optional string name = 1; // URLs with images of this dinosaur. repeated string picture_urls = 2; optional squareup.geology.Period period = 5; }
这里是一个枚举定义：
syntax = "proto2";
package squareup.geology; option java_package = "com.squareup.geology"; enum Period { // 145.5 million years ago — 66.0 million years ago. CRETACEOUS = 1; // 201.3 million years ago — 145.0 million years ago. JURASSIC = 2; // 252.17 million years ago — 201.3 million years ago. TRIASSIC = 3; }
这种模式语言是Protocol Buffers的'最大的特点。你甚至可以用它纯粹是为了文档的目的，如描述一个JSON API。
协议缓冲器还定义了符合模式的消息的紧凑二进制编码。这种编码快速编码，快速解码，小到传输，和小存储。二进制编码使用数字标签从架构，像5的时间以上。
例如，我们的编码这个恐龙：
{
name: "Stegosaurus",
period: JURASSIC
}编码值仅仅是15个字节：
Hex Description
0a tag: name(1), field encoding: LENGTH_DELIMITED(2). 1 << 3 | 2
0b "Stegosaurus".length()
53 'S'
74 't'
65 'e'
67 'g'
6f 'o'
73 's'
61 'a'
75 'u'
72 'r'
75 'u'
73 's'
28 tag: period(5), field encoding: VARINT(0). 5 << 3 | 0
02 JURASSIC(2)为什么网？
该协议缓冲器模式语言和二进制编码都是由谷歌定义。Wire是从广场的独立实现，它是专门针对Android和Java设计的。
对于在架构中定义的每个消息的类型，电线产生一个不可变模型类和它的建造者。生成的代码看起来像你手工编写代码：它的记录，格式化和简单。电线的API，应该感到在家里谁喜欢程序员有效的Java。
尽管如此，也有一些有趣的设计决策线：
-
电线消息宣布
公众最终场，而不是通常的getter方法。这减少了生成的代码和代码执行。更少的代码是Android程序特别有利。 -
电线避免的情况下映射。声明为字段
picture_urls在架构产生一个Java领域picture_urls，而不是传统的pictureUrls骆驼情况。虽然名字起初感到尴尬，它每次使用是梦幻般的grep或更复杂的搜索工具。，Java源代码和数据模式之间航行时没有更多的映射。它还提供了一个善意提醒调用代码，原消息是有点特殊。 -
基本类型总是装箱。如果字段不存在，它的价值是
零。这是用于自然可选字段，如恐龙，其周期是未知的。字段也可以为空，由于模式演变：如果明天我们添加一个食肉动物布尔给我们的消息定义，今天的数据不会有该字段的值。
下面是在紧凑型生成的代码恐龙上述定义的消息：
通过Wire协议缓冲编译器生成的代码//，不编辑。
//源文件：squareup /恐龙/ dinosaur.proto在9：1
package com.squareup.dinosaurs; import com.squareup.geology.Period; import com.squareup.wire.Message; import com.squareup.wire.ProtoAdapter; import com.squareup.wire.WireField; import java.util.List; import okio.ByteString; public final class Dinosaur extends Message<Dinosaur, Dinosaur.Builder> { public static final ProtoAdapter<Dinosaur> ADAPTER = ProtoAdapter.newMessageAdapter(Dinosaur.class); private static final long serialVersionUID = 0L; public static final String DEFAULT_NAME = ""; public static final Period DEFAULT_PERIOD = Period.CRETACEOUS; /** * Common name of this dinosaur, like "Stegosaurus". */ @WireField( tag = 1, adapter = "com.squareup.wire.ProtoAdapter#STRING" ) public final String name; /** * URLs with images of this dinosaur. */ @WireField( tag = 2, adapter = "com.squareup.wire.ProtoAdapter#STRING", label = WireField.Label.REPEATED ) public final List<String> picture_urls; @WireField( tag = 5, adapter = "com.squareup.geology.Period#ADAPTER" ) public final Period period; public Dinosaur(String name, List<String> picture_urls, Period period) { this(name, picture_urls, period, ByteString.EMPTY); } public Dinosaur(String name, List<String> picture_urls, Period period, ByteString unknownFields) { super(unknownFields); this.name = name; this.picture_urls = immutableCopyOf("picture_urls", picture_urls); this.period = period; } @Override public Builder newBuilder() { Builder builder = new Builder(); builder.name = name; builder.picture_urls = copyOf("picture_urls", picture_urls); builder.period = period; builder.addUnknownFields(unknownFields()); return builder; } @Override public boolean equals(Object other) { if (other == this) return true; if (!(other instanceof Dinosaur)) return false; Dinosaur o = (Dinosaur) other; return equals(unknownFields(), o.unknownFields()) && equals(name, o.name) && equals(picture_urls, o.picture_urls) && equals(period, o.period); } @Override public int hashCode() { int result = super.hashCode; if (result == 0) { result = unknownFields().hashCode(); result = result * 37 + (name != null ? name.hashCode() : 0); result = result * 37 + (picture_urls != null ? picture_urls.hashCode() : 1); result = result * 37 + (period != null ? period.hashCode() : 0); super.hashCode = result; } return result; } public static final class Builder extends