protocolBuffer 说明

http://www.cnblogs.com/shrimps/archive/2008/11/06/1327988.html
近期手上项目需要选择一配置信息保存方案，现就XML、JSON、Protocol Buffer（以下简称PB）、Lua做一次横向对比。首先要说明的是Lua严格来说属于嵌入式脚本语言，而XML、JSON、PB都属于数据交换格式，两者之间不属于同类别，按理说不应该放在一起比较，但是就项目需求来讲，Lua也能够实现配置信息保存。故而将Lua和XML、JSON、PB放在一起做横向对比。

　 XML | JSON | PB | Lua
数据结构支持 | 复杂结构 | 简单结构 | 较复杂结构 | 复杂结构
数据保存方式 | 文本 | 文本 | 二进制 | 文本
数据保存大小 | 大 | 一般 | 小 | 一般
解析效率 | 慢 | 一般 | 快 | 稍快
语言支持程度 | 非常多 | 多 | C++/Java/Python | 多
开发难度？繁琐？ | 繁琐 | 简单 | 简单 | 相对繁琐
学习成本 | 低 | 低 | 低 | 高
适用范围 | 数据交换 | 数据交换 | 数据交换 | 数据保存及脚本处理

最终我的选择为Lua，理由如下：
首先配置文件可能很复杂；其次需要脚本功能；Lua性能较好；语言支持程度好，本项目除了用c++做主要开发外，可能还有大量辅助软件开发，就要求快速开发，性能适用就好，因此可能会选择其他语言做快速开发。而lua的多语言支持还可以。


公司打算用protocolBuffer。
现在讲一下protocolBuffer的安装。
1.在 http://code.google.com/p/protobuf/downloads/list 下载
protobuf-2.3.0.zip
protoc-2.3.0-win32.zip

解压protoc-2.3.0-win32.zip，里面有个protoc.exe文件，配置到path
dos下执行：protoc --version 查看版本。

解压protobuf-2.3.0.zip 将上面的那个protoc.exe文件拷贝到src文件夹中。
protobuf里没有jar包，要自己编译，要用到maven，先下载maven，配置bin目录到path。
然后dos下进入protobuf-2.3.0\java 目录，执行：
mvn install
mvn package

这时maven自动下载依赖包，编译并打包jar。
在protobuf-2.3.0\java\target中生成protobuf-java-2.3.0.jar

官方的例子。
在dos的protobuf\protobuf-2.3.0\examples目录下，执行：protoc --java_out=. addressbook.proto ，这时会根据proto生成对应的AddressBookProtos.java文件。
具体的proto文件的写法，官方有详细文档。

在eclipse下建立项目Test_protobuf，考依赖包protobuf-java-2.3.0.jar，examples目录下的AddPerson.java，ListPeople.java和刚生成的AddressBookProtos.java 3个测试文件。
执行Addperson类，按提示输入信息，会生成 addr.dat文件（F5一下）。
执行Listperson类，看到刚才输入的信息。


官方文档
http://code.google.com/intl/zh-CN/apis/protocolbuffers/docs/javatutorial.html
http://code.google.com/intl/zh-CN/apis/protocolbuffers/docs/reference/java/index.html
http://code.google.com/intl/zh-CN/apis/protocolbuffers/docs/proto.html
http://code.google.com/intl/zh-CN/apis/protocolbuffers/docs/reference/java-generated.html
http://code.google.com/intl/zh-CN/apis/protocolbuffers/docs/encoding.html

---------------------------------------------------------------------
maven安装
去官网下载包
1. 安装
a. 安装jdk， 设置环境变量JAVA_HOME, 把JAVA_HOME/bin加入环境变量PATH中
b. 安装maven， 解压缩，然后把${maven_home}/bin加入环境变量PATH中。 ${maven_home}为maven的目录。
c. 把settings.xml文件拷贝到${user.home}/.m2目录下。
d. 修改hosts文件或dns， repos.eff.com 192.168.0.27。

2. 说明
settings.xml文件中描述了repository的位置， ${user.home}/.m2为本地cache。当运行mvn命令时，
mvn会自动从本地cache或远程repository下载需要的类库。


b. mvn clean. 清除classes, jar, test report等生成的文件。
c. mvn compile. 编译main/java及main/resources。
d. mvn test. 编译后运行junit test.
缺省包括以下
**/*Test.java
**/Test*.java
**/*TestCase.java
不包括以下
**/Abstract*Test.java
**/Abstract*TestCase.java
e. mvn package。 编译运行test后，打包。
f. mvn install。 把编译好的jar install到本地repository cache中。
g. mvn deploy。把编译好的jar deploy到文件描述的路径中。
h. mvn eclipse:eclipse。根据pom文件改写.project和.class文件，下载依赖包，并加入m2_repo参数