Protocol Buffers(protobuf)在Java开发中使用

来源：互联网发布：centos 6.5 iso下载编辑：程序博客网时间：2024/06/16 06:29

数据交换的方式很多比如：XML,JSON,Protobuf。虽然protobuf很流行，并且系出名门，可是没怎么用过。通过阅读google developers里关于protocal-buffers的内容基本可以使用它了。如果你访问该链接https://developers.google.com/protocol-buffers/ 失败的话，肯能需要VPN服务。

语言手册：https://developers.google.com/protocol-buffers/docs/proto

Protobuf-Java:https://developers.google.com/protocol-buffers/docs/javatutorial

下载地址：https://developers.google.com/protocol-buffers/docs/downloads

如果是Windows系统建议下载protoc-2.6.0-win32.zip，这样即可省去编译。

官方提供的C++,Python,Java的运行库下载：https://code.google.com/p/protobuf/downloads/list 这里需要注意的是运行库的版本需要和protoc的版本对应。

下文是通过使用protocal-buffers官网提供的一个数据格式的例子来熟悉protocal buffer在Java开发中的基本使用方法。

1.编写一个.proto文件命名为：addressbook.proto，该文件内容来自protocal-buffers官网

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
package tutorial;
 
option java_package = "com.example.tutorial";
option java_outer_classname = "AddressBookProtos";
 
message Person {
  required string name = 1;
  required int32 id = 2;
  optional string email = 3;
 
  enum PhoneType {
    MOBILE = 0;
    HOME = 1;
    WORK = 2;
  }
 
  message PhoneNumber {
    required string number = 1;
    optional PhoneType type = 2 [default = HOME];
  }
 
  repeated PhoneNumber phone = 4;
}
 
message AddressBook {
  repeated Person person = 1;
}

2.使用protoc-2.6.0-win32.zip解压后的protoc.exe生成Java类

查询protoc.exe帮助:

1
D:\__dev\jar\protobuff>protoc.exe -h

生成Java类：

1
2
D:\__dev\jar\protobuff>protoc.exe --proto_path=F:\__eclipse\test\proto 
--java_out=F:\__eclipse\test\src F:\__eclipse\test\proto\addressbook.proto

在Eclipse中的项目目录结构图如下：

说明：

上图中：addressbook.proto数据格式文件，AddressBookProtos.java是生成的java类，protobuf-java-2.5.0.jar是Java运行时类库。

3.使用AddressBookProtos类来实现对象的序列号和反序列化，了解Protocol-buffers jar的相关API

代码实例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
package com.example.test;
 
import java.util.Arrays;
 
import com.example.tutorial.AddressBookProtos.AddressBook;
import com.example.tutorial.AddressBookProtos.Person;
import com.google.protobuf.InvalidProtocolBufferException;
 
public class AddressBookProtoUse {
 
    public static void main(String[] args) {
        //构建一个Person对象
        Person person = Person
                .newBuilder()
                .setEmail("zhangsan@163.com")
                .setId(10086)
                .setName("zhangsan")
                .addPhone(
                        Person.PhoneNumber.newBuilder().setNumber("186")
                                .setType(Person.PhoneType.HOME).build())
                .build();
        System.out.println("打印输出Person对象信息：");
        System.out.println(person);
        System.out.println("Person对象调用toString()方法：");
        System.out.println(person.toString());
 
        System.out.println("Person对象字段是否初始化：" + person.isInitialized());
 
        // 序列号
        System.out.println("Person对象调用toByteString()方法：");
        System.out.println(person.toByteString());
 
        System.out.println("Person对象调用toByteArray()方法:");
        System.out.println(Arrays.toString(person.toByteArray()));
         
        try {
            System.out.println("反序列化后的对象信息：");
            // 反序列化
            Person newPerson = Person.parseFrom(person.toByteArray());
            System.out.println(newPerson);
            newPerson = Person.parseFrom(person.toByteString());
            System.out.println(newPerson);
        } catch (InvalidProtocolBufferException e) {
            e.printStackTrace();
        }
 
        // 向地址簿添加两条Person信息
        AddressBook.Builder books = AddressBook.newBuilder();
        books.addPerson(person);
        books.addPerson(Person.newBuilder(person).setEmail("tom@163.com")
                .build());
        System.out.println("AddressBook对象信息：");
        System.out.println(books.build());
 
    }
}

运行结果：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
打印输出Person对象信息：
name: "zhangsan"
id: 10086
email: "zhangsan@163.com"
phone {
  number: "186"
  type: HOME
}
 
Person对象调用toString()方法：
name: "zhangsan"
id: 10086
email: "zhangsan@163.com"
phone {
  number: "186"
  type: HOME
}
 
Person对象字段是否初始化：true
Person对象调用toByteString()方法：
<ByteString@89ec59 size=40>
Person对象调用toByteArray()方法:
[10, 8, 122, 104, 97, 110, 103, 115, 97, 110, 16, -26, 78, 26, 16, 122, 104, 97, 110, 103, 115, 97, 110, 64, 49, 54, 51, 46, 99, 111, 109, 34, 7, 10, 3, 49, 56, 54, 16, 1]
反序列化后的对象信息：
name: "zhangsan"
id: 10086
email: "zhangsan@163.com"
phone {
  number: "186"
  type: HOME
}
 
name: "zhangsan"
id: 10086
email: "zhangsan@163.com"
phone {
  number: "186"
  type: HOME
}
 
AddressBook对象信息：
person {
  name: "zhangsan"
  id: 10086
  email: "zhangsan@163.com"
  phone {
    number: "186"
    type: HOME
  }
}
person {
  name: "zhangsan"
  id: 10086
  email: "tom@163.com"
  phone {
    number: "186"
    type: HOME
  }
}

0 0