protobuf(Protocol Buffers)java初体验
因为项目须要所以简单的研究了下protobuf。我也是參照网上的博客,所以大部分内容我也就不反复造轮子了。首先protobuf介绍点击这里,使用介绍点击这里,使用demo看这里。
我个人的第一个样例也是參照这个demo来的。只是当中我有遇到一些问题,所以揪出来说说,也就给自己做个笔记,方便查阅。
主要的东西相信大家也了解了。直接步入主题了:
1、限定修饰符介绍 required\optional\repeated,之前给定的博客已经有这个介绍了我也不多说。这里把一些小玩儿拿出来讲讲
①、required必须的字段,假设不赋值就会抛出 com.google.protobuf.UninitializedMessageException: Message missing required fields: ...异常
②、optional可选字段,没什么好说的就是可有可无咯
③、repeated可反复的字段能够用来表示数组,在这里我还小小的纠结了会,搞过去就好了(纠结了好一会才知道protobuf数组怎么定义)。事实上定义数组非常easyrepeated string name=字段号;然后在赋值的刚開始用数组的形式来赋值,会抛出java.lang.IndexOutOfBoundsException: Index: 0, Size: 0的异常,我在想size为0,也就是说不能这样搞呀,然后看了下源代码是com.google.protobuf.LazyStringList name_ = com.google.protobuf.LazyStringArrayList.EMPTY这种,也就是说这个玩儿就是个集合嘛。所以赋值就用集合那套来搞定好了
2、接下来就是正式開始了,首先准备所以须要的protoc.exe和protobuf的jar包。下载点击这里。没什么好配置的。所以開始吧。
①、首先编写一个proto文件,这里我的文件是test.proto
package protobuf; option java_package = "com.test.protobuf"; option java_outer_classname = "FirstProtobuf"; message testBuf { required int32 ID = 1; optional string Url = 2; repeated string name=3;enum PhoneType {
MOBILE = 0;
HOME = 1;
WORK = 2;
}
}
定义包名什么的就没什么好说的了。
option java_outer_classname = "FirstProtobuf";定义生成类的名字
message
testBuf定义一个message内部类基本的字段什么就在这里面了
required
int32 ID = 1; 定义字段,每一个字段都必须有一个唯一的字段号,由于我也是初体验所以也不知道这个字段号究竟有什么用,可是不写编译就会出Missing field number的错,反复就会出Field number 1 has already been used in "protobuf.testBuf" by field "....".的错
②、将文件放在解压的protoc.exe同级文件夹下
③、就该编译了,我这里依照网上说的(protoc.exe --java_out=./test.proto)编译出现了问题Missing input file.然后查了下问题解决,查看原文,所以用protoc ./test.proto --java_out=./命令编译通过
④、把生成的文件拷到新建的java文件夹下,然后把jar拷贝进来build path下
⑤、開始測试
序列号数据(封装数据)
public static void main(String[] args) { FirstProtobuf.testBuf.Builder builder = FirstProtobuf.testBuf.newBuilder(); builder.setID(777); builder.setName(0, ""); List<String> values = new ArrayList<String>(); values.add("aaa"); values.add("aba"); values.add("baa"); values.add("acc"); builder.addAllName(values);FirstProtobuf.testBuf info = builder.build(); byte[] result = info.toByteArray(); System.out.println(result.toString()); TestAlone.getData(result); }</pre>反序列化数据
public static void getData(byte[] result) { try { FirstProtobuf.testBuf testBuf = FirstProtobuf.testBuf.parseFrom(result); System.out.println(testBuf); System.out.println(FirstProtobuf.testBuf.PhoneType.HOME);//这里使用枚举 } catch (InvalidProtocolBufferException e) { e.printStackTrace(); } }好了,到这里初体验完,事实上不难的,我刚開始时一直没有理解这个protobuf究竟是干什么的,直到我把整个流程跑通了后才理解,它就是一个封装数据(二进制)协议,通过这种方式封装数据更小,效率更高