protocol buffer

1.protocol buffer 是 google 的一种数据交换的格式，它独立于语言，独立于平台。google 提供了三种语言的实现：java、c++ 和 python，每一种实现都包含了相应语言的编译器以及库文件。由于它是一种二进制的格式，比使用 xml 进行数据交换快许多。可以把它用于分布式应用之间的数据通信或者异构环境下的数据交换。本文通过一个简单的示例介绍 protocol buffer。

在开始之前需要下载 protocol buffer 的编译器和相应类库。下载地址为：http://code.google.com/p/protobuf/downloads/list 。当前版本为 2.3.0，下载一下两个压缩包：protoc-2.3.0-win32.zip 和 protobuf-2.3.0.zip，前者是 protocol buffer 编译器，后者包含了三种语言的开发包。

首先解压 protoc-2.3.0-win32.zip，把 protoc.exe 文件放到 path 路径中，最简单的就是把这个文件复制到 c:\windows 目录中。

解压 protobuf-2.3.0.zip 文件，假设解压后的目录为 proto_home。由于此开发包中只包含了源文件，没有包含打包后的 jar 文件，所以需要自己手动编译。下面一步一步来编译 protocol buffer 的 java 实现，由于 protocol buffer 使用 maven 作为编译工具，所以必须先下载安装 maven，maven 可以从 http://maven.apache.org 上下载。安装 maven 非常简单，只要解压并把 bin 目录添加到 path 中即可。安装好 maven 后，测试一下 maven 是否安装成功，打开命令行窗口，运行命令 mvn -version，当看到相关maven信息输出后，说明 maven 安装成功。



在编译之前还需把 protocol buffer 的编译器复制一份到把 protocol buffer 的编译器复制一份到目录 proto_home\src\ 中，由于在 maven 脚本中调用了这个文件。下面在命令行窗口中把当前工作目录定位到proto_home\java 中，运行命令 mvn package。编译完成后会在 taget 目录中生成一个 jar 文件 protobuf-java-2.3.0.jar。

protocol buffer 的编译器和基于 java 的类库已经准备好了，下面可以使用 protocol buffer 写一个简单的示例。本文中就直接使用 protocol buffer 本身自带的一些示例，这个示例在 proto_home\examples 目录中。这个示例会用到这个目录中的 addressbook.proto、AddPerson.java 和 ListPerson.java 文件。下面一步一步来运行这些示例。

首先把前面编译生成的 protobuf-java-2.3.0.jar 复制到 proto_home\examples 目录中，便于引用。

使用 protocol buffer 编译器编译 addressbook.proto 文件。打开命令行窗口，并定位到 proto_home\examples 目录中，运行命令 protoc --java_out=. addressbook.proto，执行这个命令后会在当前目录下生成一个java类 com.example.tutorial.AddressBookProtos.java。

生成了 java 类之后就是编译并运行这个示例，在命令行中执行命令 javac -d . -classpath .;protobuf-java-2.3.0.jar AddPerson.java ListPeople.java com\example\tutorial\AddressBookProtos.java。

下面运行 AddPerson，在命令中执行命令 java -cp .;protobuf-java-2.3.0.jar AddPerson addr.dat，按照提示输入相应的信息


运行这个程序会在当前目录中创建一个数据文件 addr.dat 保存 protocol buffer 生成的数据。运行程序 ListPeople 则可以读取 addr.dat 文件中的数据。
java -cp .;protobuf-java-2.3.0.jar ListPeople addr.dat

注：
1、如果使用maven编译出错，下面提供编译好的protobuf-java-2.4版本的jar包；
2、使用protoc编译不好使，则将protoco.exe拷贝到examples目录下，使用protoco.exe命令执行；

2.、构建proto描述文件。
proto中描述message信息的格式：
message name{

Message var1; # field1

Message var2; # field2

......

}
Message定义变量的格式:
FieldRule FieldType var_name = Unique numbered Tag [default = 10]
FieldRule包含required、optional、repeated。（required是必须赋值的，optional可选赋值，repeated有点类似一个List，可以重复加入）
目前ProtocBuf支持的FieldType有
========================
.proto Java Type
-----------------------------------------
double double
float float
int32 int
int64 long
uint32 int
uint64 long
sint32 int
sint64 long
fixed32 int
fixed64 long
sfixed32 int
sfixed64 long
bool boolean
string String
bytes ByteString
=========================