Java中使用Protocol Buffer

    xiaoxiao2026-03-26  11

    一、Protocol Buffer简介

    什么是 Google Protocol Buffer? 假如您在网上搜索,应该会得到类似这样的文字介绍: Google Protocol Buffer( 简称 Protobuf) 是 Google 公司内部的混合语言数据标准,目前已经正在使用的有超过 48,162 种报文格式定义和超过 12,183 个 .proto 文件。他们用于 RPC 系统和持续数据存储系统。 Protocol Buffers 是一种轻便高效的结构化数据存储格式,可以用于结构化数据串行化,或者说序列化。它很适合做数据存储或 RPC 数据交换格式。可用于通讯协议、数据存储等领域的语言无关、平台无关、可扩展的序列化结构数据格式。目前提供了 C++、Java、Python 三种语言的 API。 如果你在开发中使用过常用的数据交换格式如xml、json,那么protocol buffer也不是什么神奇的东西了,它和xml、json类似,也可以作为开发中的一种数据交换格式,只不过相较xml和json,protocol buffer的优点更明显,它更小、更快、更简单。

    二、Protocol Buffer的使用(Java)

    下面用一个例子来说明如何在java中使用Protocol Buffer。

    首先我们需要去Google的网站上下载Protocol Buffer的编译器:https://developers.google.com/protocol-buffers/docs/downloads,这里注意需要科学上网。

    在Java中使用ProtocolBuffer的步骤大致分为下面这几点:

    (1)编写.proto文件,定义消息类型

    (2)使用ProtocolBuffer的编译器,将.proto文件编译成对应的java文件

    (3)在Java代码中使用上一步编译好的java文件

    如何编写.proto文件呢,看下面一个例子:

    package com.demo.msg; option java_outer_classname = "PersonBean"; message Person { required string name = 1; required int32 age = 2; optional string gender = 3; }上面的代码可以保存到一个Person.proto文件中,其中package指定了包名,和java中的包名类似,option java_outer_classname = "PersonBean";这句指定了编译器在编译.proto文件时,输出的java类的类名,接着使用message定义了一个名为Person的消息,里面包含3个成员变量,其中用required修饰的变量代表必须的,optional修饰的变量代表是可选的,这里定义消息的形式跟java中定义类非常相似。

    下面需要用ProtocolBuffer的编译器来编译上面的消息,我们从google的网站上下载下来的是一个protoc.exe文件,将该文件跟上面定义的消息文件Person.proto放在同一个目录下,然后在命令行中进入该目录,执行下面的命令:

    protoc.exe --java_out=./ Person.proto就在当前目录下生成了对应的java文件PersonProto.java

    下面可以在Java项目中使用上面编译好的PersonProto.java文件了,我们新建一个java项目,项目结构如下:

    上面需要注意的是,我们在lib目录下引入了protobuf-java-2.5.0.jar包,这个包就是用来对ProtocolBuffer消息进行序列化和反序列化的.

    下面定义一个Server类,用于处理客户端发送过来的消息,代码如下:

    package com.demo.server; import com.demo.constant.Constants; import com.demo.msg.PersonBean; import com.google.protobuf.ByteString; import java.net.ServerSocket; import java.net.Socket; /** * Created by yubo7 on 2016/8/16. */ public class Server { public static void main(String[] args) throws Exception { ServerSocket ss = new ServerSocket(Constants.PORT); System.out.println("server started..."); Socket socket = ss.accept(); System.out.println("a client connected!"); //从输入流中解析出Person对象 PersonBean.Person person = PersonBean.Person.parseFrom(ByteString.readFrom(socket.getInputStream())); if(person != null) { System.out.println("server received data:\n" + person.toString()); } } } 下面定义一个Client类,用于生成一个Person类并发送给Server,代码如下:

    package com.demo.client; import com.demo.constant.Constants; import com.demo.msg.PersonBean; import java.io.OutputStream; import java.net.Socket; /** * Created by yubo7 on 2016/8/16. */ public class Client { public static void main(String[] args) throws Exception { Socket socket = new Socket("localhost", Constants.PORT); //构造一个Person对象 PersonBean.Person person = PersonBean.Person.newBuilder().setName("zhangsan") .setAge(20).setGender("male").build(); OutputStream os = socket.getOutputStream(); //将Person对象写到输出流中 os.write(person.toByteArray()); os.flush(); //这里注意一定要关闭流,否则服务端会报错 os.close(); System.out.println("client send person"); } } 上面的PORT为常量,定义在Constants类中,代码如下:

    package com.demo.constant; /** * Created by yubo7 on 2016/8/16. */ public class Constants { public static final int PORT = 9988; } 到这里就可以测试程序了,我们先启动Server,在控制台打印的内容如下图:

    然后再启动Client,在控制台打印的内容如下图:

    然后再切换回Server的控制台,可以看到控制台中的打印如下图:

    可以看到,控制台中打印了客户端发送过去的Person消息,这样,一个使用ProtocolBuffer来进行数据发送和接收的java程序就完成了。

    本文源代码已托管到GitHub:https://github.com/yubo725/ProtocolBufferDemo

    参考文章:http://www.ibm.com/developerworks/cn/linux/l-cn-gpb/

    转载请注明原文地址: https://ju.6miu.com/read-1308206.html
    最新回复(0)