protobuf-java的使用

使用方法

• 编译得到protoc工具，下载protobuf的源码，进入源码目录后

 ./configure --prefix=/usr/local/protobuf2.5    要安装到的目录
make
make install
# PS：之前还用过2.3版本protobuf，make时会报错，解决方法：
# 在src/google/protobuf/message.cc中，添加`#include<istream>`

安装完成后会在/usr/local/protobuf2.5下生成bin、include、lib三个文件夹，我们要用的是bin下的protoc工具:
/usr/local/protobuf2.5/bin/protoc --proto_path=. --java_out=/Users/laifuzhi/IdeaProjects/template/src/main/java/ MyProto.proto
该命令会将当前文件夹下的MyProto.proto文件转换为一个java源文件，放到/Users/laifuzhi/IdeaProjects/template/src/main/java/目录下

• 工程中引入protobuf的jar包，和protoc的版本保持一致，可以通过protoc的--version参数查看protoc的版本

<dependency>
    <groupId>com.google.protobuf</groupId>
    <artifactId>protobuf-java</artifactId>
    <version>2.5.0</version>
</dependency>

• 编辑protobuf文件：

option java_package = "com.lfz.proto"; //转换后的java源文件包名
option java_outer_classname = "FirstModule"; //转换后的java源文件文件名、类名
//demo
message CommonBean {
    required int32 id [default = 0] = 1; //编号
    required string name = 2; //姓名
    optional string address = 3; //地址
    repeated string messages = 4; //消息的list
}

• 代码中的基本使用

FirstModule.CommonBean.Builder builder = FirstModule.CommonBean.newBuilder();
builder.setId(1).setName("lfz"); //id和name是required的，所以必填
FirstModule.CommonBean bean1 = builder.build();
byte[] bytes = bean1.toByteArray(); //序列化
FirstModule.CommonBean bean2 = FirstModule.CommonBean.parseFrom(bytes); //反序列化

• tips

之前工作中需要将protobuf对象转换为json，使用jackson等工具不能直接转换，需要使用第三方工具:

<dependency>
    <groupId>com.googlecode.protobuf-java-format</groupId>
    <artifactId>protobuf-java-format</artifactId>
    <version>1.2</version>
</dependency>

将上面的protobuf转为json并打印：

FirstModule.CommonBean.Builder builder = FirstModule.CommonBean.newBuilder();
builder.setId(1).setName("lfz");
FirstModule.CommonBean bean1 = builder.build();
System.out.println(JsonFormat.printToString(bean1));
byte[] bytes = bean1.toByteArray(); //比java的序列化短了很多
FirstModule.CommonBean bean2 = FirstModule.CommonBean.parseFrom(bytes);
System.out.println(JsonFormat.printToString(bean2));