1.简单明了介绍ProtocolBuffer
2. ProtocolBuffer(pb)所做事情其实类似于xml、json,也就是把某种数据结构的信息依照某种格式保存起来。主要用于数据存储、传输等。
3. 效率高,支持多种编程语言。
4. 本地搭建环境
首先安装MAVEN:
下载apache-maven-3.3.3-bin.zip并解压缩
在环境变量中添加M2_HOME,值为解压的目录
在环境变量path中添加%M2_HOME%\bin
输入mvn –v查看版本验证安装成功之后获取protobuf的jar包
下载protobuf-2.5.0.zip和protoc-2.5.0-win32.zip并解压(下文中用d:\ protobuf-2.5.0和d:\win32举例作为解压目录)
将d:\win32中的protoc.exe复制到D:\protobuf-2.5.0\src下,打开cmd,在D:\protobuf-2.5.0\java下执行mvn install
在D:\protobuf-2.5.0\java\target下得到protobuf-java-2.5.0.jar文件,导入到项目中。就ok了。
5. 核心文件.proto文件相当于确定数据协议,数据结构中存在了哪些数据,数据类型是什么。
6. 限定修饰符
required 不可增加或删除的字段,在程序中的build之前必须先初始化,不然会抛异常。
optional 可选字段,可删除、可以不初始化。
repeated 可重复字段,对应到Java文件里 就是list。
7. 定义.proto文件
message User{
required int32 acctID = 1;
required string passwd = 2;
}
1. message是消息定义的关键字,等同于C++中的struct/class,或是Java中的class。
2. LogonReqMessage为消息的名字,等同于结构体名或类名。
3. required前缀表示该字段为必要字段,既在序列化和反序列化之前该字段必须已经被赋值。与此同时,在Protocol Buffer中还存在另外两个类似的关键字,optional和repeated,带有这两种限符 的消息字段则没有required字段这样的限制。相比于optional,repeated主要用于表示数组字段。具体的使用方式在后面的用例中均会一一列出。
4. int64和string分别表示长整型和字符串型的消息字段,在Protocol Buffer中存在一张类型对照表,既Protocol Buffer中的数据类型与其他编程语言(C++/Java)中所用类型的对照。该对照表中将 给出在不同的数据场景下,哪种类型更为高效。该对照表将在后面给出。
5. acctID和passwd分别表示消息字段名,等同于Java中的域变量名,或是C++中的成员变量名。
6. 标签数字1和2则表示不同的字段的唯一编号,在序列化后的二进制数据中的布局位置。在该例中,passwd字段编码后的数据一定位于acctID之后。需要注意的是该值在同一message中不能重复。 另外,对于Protocol Buffer而言,标签值为1到15的字段在编码时可以得到优化,既标签值和类型信息仅占有一个byte,标签范围是16到2047的将占有两个bytes,而Protocol Buffer可以支持字 段数量则为2的29次方减一。有鉴于此,我们在设计消息结构时,可以尽可能考虑让repeated类型的字段标签位于1到15之间,这样便可以有效的节省编码后的字节数量。
8. 生成Java类
命令:进入protoc.exe 所在的目录下 执行:protoc.exe --java_out=./ user.proto
9. 在Java中使用
假设在.pro文件中定义一个属性为 bytes name
Java中可以这样写:
String name = “aaaa”;
user.setName(ByteString.copyFromUtf8(name)); 即可。
java中取ByteString的值
假如反序列化后的属性值为 ByteString类型的,那么可以
通过user.getName().toStingUtf8(); 即可。