java---protobuffer

Protobuf协议 ，全称：Protocol Buffer 

它跟JSON，XML一样，是一个规定好的数据传播格式。是个二进制的流，效率非常高，数据非常小，可以快速传输。

简单的解释，就是按照proto的格式，定义一个配置文件，使用proto.exe按照配置文件生成java的对象类，这个对象可以就具有了protobuffer的方法，序列化和反序列化。比如生成一个person类，有name，age等属性，序列化之后，person的这个实例变成字节流，进行传输，体积很小，接收后按照protobuffer的方法反序列化，就还原为person的这个实例

需要注意protobuffer的版本，我之前使用了同事用的nano版本，使用proto.exe按照配置文件生成java的对象类后，这个对象类打开，有很多报错，都是方法缺失，比如cannot resolve 'com.google.protobuf.MessageOrBuilder'

以下内容是转载蚂蚁博主的内容，这个文章写得非常好，我觉得我写的不会比他更清楚了，具体的步骤请参见如下

Protobuf的Java实例

一、 安装Protobuf

去Protobuf的GitHub下载，解压。

如果你是Windows环境，则还要下载多一个东西。protobuf-2.5.0-windows.zip。

解压protobuf-2.5.0-windows.zip，把protoc.exe放在Protobuf安装目录下的src里。（其实放哪都可以）

二、 配置环境变量

编辑系统变量Path，添加Protoc.exe的存放目录。 

三、 Eclipse新建项目

我使用maven构建protobuf项目，方便引入protobuf-Java-2.5.0.jar依赖。 
在项目根目录创建proto文件夹，存放proto文件。 
 
maven依赖pom.xml

<dependency>
    <groupId>com.google.protobuf</groupId>
    <artifactId>protobuf-java</artifactId>
    <version>2.5.0</version>
</dependency>
 
1
2
3
4
5
 
1
2
3
4
5

四、编写.proto文件

在proto文件夹下编写person-entity.proto，如下（proto协议的规则点这查看）

option java_outer_classname = "PersonEntity";//生成的数据访问类的类名  
message Person {  
  required int32 id = 1;//同上  
  required string name = 2;//必须字段，在后面的使用中必须为该段设置值  
  optional string email = 3;//可选字段，在后面的使用中可以自由决定是否为该字段设置值
}  
 
1
2
3
4
5
6
 
1
2
3
4
5
6

四、使用protoc.exe编译成java类

有两种方法： 
1. 使用Java Rumtime执行cmd命令 
2. 直接打开cmd运行命令也行。

---

1. 使用Java Rumtime执行cmd命令

util包下新建GenerareClass类 

/**
 * protoc.exe
 * @author ganhaibin
 *
 */
public class GenerateClass {
    public static void main(String[] args) {
        String protoFile = "person-entity.proto";//  
        String strCmd = "d:/dev/protobuf-master/src/protoc.exe -I=./proto --java_out=./src/main/java ./proto/"+ protoFile;  
        try {
            Runtime.getRuntime().exec(strCmd);
        } catch (IOException e) {
            e.printStackTrace();
        }//通过执行cmd命令调用protoc.exe程序  
    }
}
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

命令格式如下。

protoc.exe -I=proto的输入目录 --java_out=java类输出目录 proto的输入目录包括包括proto文件
 
1
 
1

2. 直接打开cmd运行命令

生成的PersonEntity.java类

---

五、测试

编写Test类，模拟序列化和反序列化过程。

public class Test {
    public static void main(String[] args) throws IOException {
        //模拟将对象转成byte[]，方便传输
        PersonEntity.Person.Builder builder = PersonEntity.Person.newBuilder();
        builder.setId(1);
        builder.setName("ant");
        builder.setEmail("ghb@soecode.com");
        PersonEntity.Person person = builder.build();
        System.out.println("before :"+ person.toString());

        System.out.println("===========Person Byte==========");
        for(byte b : person.toByteArray()){
            System.out.print(b);
        }
        System.out.println();
        System.out.println(person.toByteString());
        System.out.println("================================");

        //模拟接收Byte[]，反序列化成Person类
        byte[] byteArray =person.toByteArray();
        Person p2 = Person.parseFrom(byteArray);
        System.out.println("after :" +p2.toString());
    }
}
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

输出如下 

---

后记

我想，拿protobuf协议储存数据，或者作为聊天文本的传输协议，那效率肯定让人咋舌。嘿嘿。