Protocol Buffer是谷歌开源的一种序列化和反序列化机制，类似于XML，JSON 解析，但是Protocol Buffer 更灵活、更高效、更简单。

具体在实际开发中，Protocal Buffer表现怎么样，我也不知道，因为我很少用它，至于为什么会学习它，完全是因为Android Launcher3里面的backup.proto把我牵引了过去，Protocol buffer的高效性，谷歌官网也有实例来说明，而执行消耗时间精确到了纳秒,关于它的详细介绍还是看官网:https://developers.google.com/protocol-buffers。 嗯，没错，又是英文，又要FQ。

这个开源项目，谷歌已经放到了github，Link:https://github.com/google/protobuf/ , release版本：https://github.com/google/protobuf/releases。

那么现在就以Java来配置Protocol buffer，操作系统是Windows，目的：手动编译jar包，手动将xx.proto文件生成为xx.java文件。  

要编译，那么就要环境。根据根据github上的文档，它是用maven来管理的，Link:https://github.com/google/protobuf/tree/master/java

下载安装maven，并加入环境变量,例如：     

D:\apache-maven-3.3.9\bin;D:\protobuf-3.0.0-alpha-2\src

    下载Protocol buffer 文件，例如我用的：protobuf-java-3.0.0-alpha-2.zip

    下载Protocol 可执行文件，Link:http://central.maven.org/maven2/com/google/protobuf/protoc/ 选择对应的版本，我使用的是：protoc-3.0.0-alpha-2-windows-x86_32.exe。

    解压protobuf-java-3.0.0-alpha-2.zip，并将protoc-3.0.0-alpha-2-windows-x86_32.exe重命名为protoc.exe,复制到protobuf-java-3.0.0-alpha-2/src目录下，同样将protoc.exe路径加入到环境变量。

    打开cmd 切换到protobuf-java-3.0.0-alpha-2目录，可查询maven 和 protoc.exe的版本号:

然后根据github上文档的提示：mvn install （安装相关库），切换到../javanano目录，mvn test（测试环境是否配置妥当）：

出现上面界面，基本上环境是没有问题了，就可以mvn package:

然后到目录../javanano/target下，就会看到protobuf-javanano-3.0.0-alpha-2.jar了,至此，手动生成JAR包，成功！

    

    然后就来手动解析xx.proto文件，将它生成为xx.java文件。这里以protobuf-java-3.0.0-alpha-2/example里面的例子来实验一下。

这个操作需要指令，官网和github上的文档都有说明：   

    protoc --proto_path=src --java_out=build/gen src/foo.proto

protoc 就是protoc.exe了，前面已经加入到环境变量中， proto_path 就是xx.proto的路径了，java_out就是生成的xx.java文件的存放路径了，最后面跟着还是xx.proto文件

这里，以examples/addressbook.proto 为例。

    在cmd敲入如下指令：   

protoc --proto_path=examples --java_out=examples examples/addressbook.proto

    遗憾的是，没有成功，报错了：

    

意思是说，addressbook.proto 文件中需要使用syntax = "proto2"，这个属性，根据proto的版本来的。在addressbook.proto中加上这句话：   

    ...syntax = "proto2";package tutorial;option java_package = "com.example.tutorial";option java_outer_classname = "AddressBookProtos";...

再重新执行上面的命令，结果成功生成了AddressBookProtos.java文件，文件路径：../examples/com/example/tutorial/AddressBookProtos.java：   

    package com.example.tutorial;public final class AddressBookProtos {private AddressBookProtos() {}public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry registry) {}public interface PersonOrBuilder extends// @@protoc_insertion_point(interface_extends:tutorial.Person)com.google.protobuf.MessageOrBuilder {/*** <code>required string name = 1;</code>*/boolean hasName();/*** <code>required string name = 1;</code>*/java.lang.String getName();......}

那么好，有点小激动，终于生成了xx.java文件了。不过很遗憾的是，xx.java文件是生成了，但是此文件生成的是错误的，里面的内容是有问题的，在实际的开发中，

当引用这个文件中的内容后，肯定会报错。那么为什么了。

刚接触protocol buffer的朋友，肯定会跟我刚开始一样以为成功了，其实非也。那么请注意，我使用的protoc版本为nano版本，在protobuf-3.0.0-alpha-2目录下没有

java目录，而是javanano目录，对,就是这个坑，我掉进去了。

这两个版本之前是有区别的，不妨打开protobuf-3.0.0-alpha-2/javanano/Pom.xml文件，查看下groupId:

     <groupId>com.google.protobuf.nano</groupId><artifactId>protobuf-javanano</artifactId><version>3.0.0-alpha-2</version>

而在非nano版本中，groupId为： <groupId>com.google.protobuf</groupId>，回去看看生成的AddressBookProtos.java文件,会有部分类似于下面这条语句的内容：    

com.google.protobuf.ExtensionRegistry registry

所有这些内容，对于nano版本都是错误的，前面的com.google.protobuf都应该对应于groundId，所以对于nano版本，应该为：

com.google.protobuf.nano.ExtensionRegistry registry

那么问题出在哪里，要跳出这个坑，还需要认真阅读文档，请参阅protobuf-3.0.0-alpha-2/javanano/README.tet，

或者https://github.com/google/protobuf/tree/master/javanano。有这么一段内容：   

- Invoke with --javanano_out, e.g.:./protoc '--javanano_out=\java_package=src/proto/simple-data.proto|my_package,\java_outer_classname=src/proto/simple-data.proto|OuterName\:.' src/proto/simple-data.proto

于是乎我果断将java_out修改为javanano_out：    

protoc --proto_path=examples --javanano_out=examples examples/addressbook.proto

生成的xx.java文件如下：   

public interface AddressBookProtos {public static final class Person extendscom.google.protobuf.nano.MessageNano {// enum PhoneTypepublic static final int MOBILE = 0;public static final int HOME = 1;public static final int WORK = 2;public static final class PhoneNumber extendscom.google.protobuf.nano.MessageNano {private static volatile PhoneNumber[] _emptyArray;public static PhoneNumber[] emptyArray() {// Lazily initializes the empty arrayif (_emptyArray == null) {synchronized (com.google.protobuf.nano.InternalNano.LAZY_INIT_LOCK) {if (_emptyArray == null) {_emptyArray = new PhoneNumber[0];}}}return _emptyArray;}...}

看到上面的内容，终于出现了com.google.protobuf.nano.xxxxx,这样就跟grounpId对应上了，对应于nano版本。