Protocol Buffer技术详解(Java实例)

该篇Blog和上一篇(C++实例)基本相同,只是面向于我们团队中的Java工程师,毕竟我们项目的前端部分是基于Android开发的,而且我们研发团队中目前主要使用的开发语言就是C++、Java和Python,其中Python主要用于编写各种工具程序。然而为了保证该篇Blog的完整性和独立性,我仍然会将上一篇Blog中已经出现的内容再一次赘述,同时对于Java中特有的部分也会着重介绍。
    
      一、生成目标语言代码。
      下面的命令帮助我们将MyMessage.proto文件中定义的一组Protocol Buffer格式的消息编译成目标语言(Java)的代码。至于消息的内容,我们会在后面以分段的形式逐一列出,同时也会在附件中给出所有源代码。
      protoc -I=./message --java_out=./src ./MyMessage.proto
      从上面的命令行参数中可以看出,待编译的文件为MyMessage.proto,他存放在当前目录的message子目录下。--java_out参数则指示编译工具我们需要生成目标语言是java,输出目录是当前目录的src子目录。这里需要补充说明的是,因为在MyMessage.proto文件中定义了option java_package = "com.lsk.lyphone"的文件级选项,所以输出的目前是src/com/lsk/lyphone,生成的目标代码文件名是MyMessage.java。
    
      二、简单message生成的Java代码。
      这里先定义一个最简单的message,其中只是包含原始类型的字段。
      option java_package = "com.lsk.lyphone";
      option java_outer_classname = "LYPhoneMessage";
      option optimize_for = LITE_RUNTIME;
      message LogonReqMessage {
          required int64 acctID = 1;
          required string passwd = 2;
      }
      对于选项java_packagejava_outer_classname的功能,我们已经在之前的一篇Blog(语言规范)中进行了清晰的阐述,这里就不在另行介绍了。然而对于选项optimize_for,这里将结合本例给出一些实用性描述。
      当前.proto文件中该选项的值为LITE_RUNTIME,因此由该.proto文件生成的所有Java类的父类均为com.google.protobuf.GeneratedMessageLite,而非com.google.protobuf.GeneratedMessage,同时与之对应的Builder类则均继承自com.google.protobuf.MessageLiteOrBuilder,而非com.google.protobuf.MessageOrBuilder。在之前的博客中已经给出了一些简要的说明,MessageLite接口是Message的父接口,在MessageLite中将缺少Protocol Buffer对反射的支持,而此功能均在Message接口中提供了接口规范,同时又在其实现类GeneratedMessage中给予了最小功能的实现。对于我们的项目而言,整个系统相对比较封闭,不会和更多的外部程序进行交互,与此同时,我们的客户端部分又是运行在Android平台,有鉴于此,我们考虑使用LITE版本的Protocol Buffer。这样不仅可以得到更高编码效率,而且生成代码编译后所占用的资源也会更少,至于反射所能带来的灵活性和极易扩展性,对于该项目而言完全可以忽略。下面我们来看一下由message LogonReqMessage生成的Java类的部分声明,以及常用方法的说明性注释。
      在做各种case的对比性分析之前必须要事先声明的是,Protocol Buffer针对Java语言所生成的代码和C++相比存在一个非常重要的差别,即为每个消息均会生成一个Builder接口和一个与消息对应的实现类,该实现类又将同时实现生成的Builder接口和扩展Protocol Buffer内置的GeneratedMessageLite(或GeneratedMessage)类。这一点对于Protocol Buffer而言,是巧妙的使用了设计模式中的Builder模式。换言之,对于所有消息字段的修改操作均需要通过与其对应的Builder接口辅助完成。相信我们会通过对下面用例的学习可以得到更为清楚的认识。

  1     //用于修改LogonReqMessage消息字段的辅助Builder接口。
2 //该接口会为消息中的每个字段均提供getter和setter方法。
3 public interface LogonReqMessageOrBuilder
4 extends com.google.protobuf.MessageLiteOrBuilder {
5
6 // required int64 acctID = 1;
7 boolean hasAcctID();
8 long getAcctID();
9
10 // required string passwd = 2;
11 boolean hasPasswd();
12 String getPasswd();
13 }
14 //该类为final类,即不可以在被子类化了。这一点在Protocol Buffer的官方文档中给予了明确
15 //的说明,因为子类化将会破坏序列化和反序列化的过程。
16 public static final class LogonReqMessage extends
17 com.google.protobuf.GeneratedMessageLite
18 implements LogonReqMessageOrBuilder {
19
20 // Use LogonReqMessage.newBuilder() to construct.
21 // 由于所有构造函数均为私有方法,由此可见,我们不能直接new LogonReqMessage的对象
22 // 实例,而是只能通过与其对应Builder来构造,或是直接通过反序列化的方式生成。
23 private LogonReqMessage(Builder builder) {
24 super(builder);
25 }
26 //该静态方法为该类Builder接口的工厂方法。返回的Builder实现类在完成各个字段的
27 //初始化后,通过build()方法返回与其对应的消息实现类,即LogonReqMessage。
28 public static Builder newBuilder() { return Builder.create(); }
29 //通过该类的对象获取与其对应的Builder类对象,一般用于通过Builder类完成消息字段的修改。
30 public Builder toBuilder() { return newBuilder(this); }
31
32 private LogonReqMessage(boolean noInit) {}
33 //判断当前对象的所有字段是否都已经被初始化。
34 public final boolean isInitialized() {
35 ... ...
36 }
37 //获取已经被初始化后的对象序列化时所占用的字节空间。
38 public int getSerializedSize() {
39 ... ...
40 }
41 //从内存中饭序列化LogonReqMessage对象。
42 //Protocol Buffer中还提供其他一些接口方法,用于从不同的数据源反序列化对象。
43 public static com.lsk.lyphone.LYPhoneMessage.LogonReqMessage parseFrom(byte[] data)
44 throws com.google.protobuf.InvalidProtocolBufferException {
45 return newBuilder().mergeFrom(data).buildParsed();
46 }
47 //功能和上一个函数相同,只是输入源改为InputStream接口。
48 public static com.lsk.lyphone.LYPhoneMessage.LogonReqMessage parseFrom(java.io.InputStream input)
49 throws java.io.IOException {
50 return newBuilder().mergeFrom(input).buildParsed();
51 }
52
53 // required int64 acctID = 1;
54 // 下面的静态变量对应于该字段在.proto中定义的标签号。该变量的命名规则为:字段(全部大写) + _FIELD_NUMBER。
55 public static final int ACCTID_FIELD_NUMBER = 1;
56 public boolean hasAcctID() {
57 return ((bitField0_ & 0x00000001) == 0x00000001);
58 }
59 public long getAcctID() {
60 return acctID_;
61 }
62
63 // required string passwd = 2;
64 public static final int PASSWD_FIELD_NUMBER = 2;
65 public boolean hasPasswd() {
66 return ((bitField0_ & 0x00000002) == 0x00000002);
67 }
68 public String getPasswd() {
69 ... ...
70 }
71 //每一个Message类都会包含一个静态内部类,即与之对应的Builder类。上面代码中所涉及的Builder类均为该内部类。
72 public static final class Builder extends
73 com.google.protobuf.GeneratedMessageLite.Builder<
74 com.lsk.lyphone.LYPhoneMessage.LogonReqMessage, Builder>
75 implements com.lsk.lyphone.LYPhoneMessage.LogonReqMessageOrBuilder {
76 //清空当前对象中的所有设置。调用该函数之后,本例中的hasAcctID和hasPasswd都会返回false。
77 public Builder clear() {
78 super.clear();
79 acctID_ = 0L;
80 bitField0_ = (bitField0_ & ~0x00000001);
81 passwd_ = "";
82 bitField0_ = (bitField0_ & ~0x00000002);
83 return this;
84 }
85 //克隆出一个Builder对象。
86 public Builder clone() {
87 return create().mergeFrom(buildPartial());
88 }
89 public com.lsk.lyphone.LYPhoneMessage.LogonReqMessage build() {
90 com.lsk.lyphone.LYPhoneMessage.LogonReqMessage result = buildPartial();
91 if (!result.isInitialized()) {
92 throw newUninitializedMessageException(result);
93 }
94 return result;
95 }
96 // Builder类中修改外部消息类的方法。
97 // required int64 acctID = 1;
98 public boolean hasAcctID() {
99 return ((bitField0_ & 0x00000001) == 0x00000001);
100 }
101 public long getAcctID() {
102 return acctID_;
103 }
104 //设置AcctID字段,该函数调用后hasAcctID函数将返回true。
105 //这里之所以让返回值为Builder对象,就是可以让调用者在一条代码中方便的连续修改多个字段,
106 //如:myMessage.setAcctID(100).setPasswd("MyName");
107 public Builder setAcctID(long value) {
108 bitField0_ |= 0x00000001;
109 acctID_ = value;
110 return this;
111 }
112 //清空AcctID字段,该函数调用后hasAcctID函数返回false。
113 //这里之所以让返回值为Builder对象,就是可以让调用者在一条代码中方便的连续清空多个字段,
114 //如:myMessage.clearAcctID().clearPasswd();
115 public Builder clearAcctID() {
116 bitField0_ = (bitField0_ & ~0x00000001);
117 acctID_ = 0L;
118 return this;
119 }
120
121 // required string passwd = 2;
122 public boolean hasPasswd() {
123 return ((bitField0_ & 0x00000002) == 0x00000002);
124 }
125 public String getPasswd() {
126 ... ...
127 }
128 public Builder setPasswd(String value) {
129 ... ...
130 }
131 public Builder clearPasswd() {
132 bitField0_ = (bitField0_ & ~0x00000002);
133 passwd_ = getDefaultInstance().getPasswd();
134 return this;
135 }
136 void setPasswd(com.google.protobuf.ByteString value) {
137 bitField0_ |= 0x00000002;
138 passwd_ = value;
139 }
140 }
141 }

在上面生成的代码中并没有列出与序列化相关的函数,这部分代码基本都是在父类中实现的,我们将在下面的例子中给出一些最基本的用法,有兴趣的开发者可以直接看Protocol Buffer中的源码,这部分代码比较通俗易懂。
      下面是读写LogonReqMessage对象的Java测试代码和说明性注释。

 1     private static void testSimpleMessage() {
2 System.out.println("==================This is simple message.================");
3 //如前所述,不能直接构造该消息类对象,只能通过他的内部Builder类构造并完成所有字段的初始化。
4 LogonReqMessage.Builder logonReqBuilder = LogonReqMessage.newBuilder();
5 logonReqBuilder.setAcctID(20);
6 logonReqBuilder.setPasswd("Hello World");
7 //builder对象初始化完毕后,再通过build方法生成与之对应的消息类对象。
8 LogonReqMessage logonReq = logonReqBuilder.build();
9 int length = logonReq.getSerializedSize();
10 System.out.println("The result length is " + length);
11 //直接序列化到内存中,之后可对该内存进行二次加工后再写到本地文件或发送到远端,如加密。
12 byte[] buf = logonReq.toByteArray();
13
14 try {
15 LogonReqMessage logonReq2 = LogonReqMessage.parseFrom(buf);
16 System.out.println("acctID = " + logonReq2.getAcctID() + "\tpassword = " + logonReq2.getPasswd());
17 } catch (InvalidProtocolBufferException e) {
18 e.printStackTrace();
19 }
20 //需要说明的是,文件中的内容是由之前C++实例代码写入的,这里这样写主要是一种验证。
21 System.out.println("Reading data from local file generated by C++");
22 try {
23 LogonReqMessage logonReq3 = LogonReqMessage.parseFrom(new FileInputStream("C:/Mine/LogonReq.dat"));
24 System.out.println("acctID = " + logonReq3.getAcctID() + "\tpassword = " + logonReq3.getPasswd());
25 } catch (FileNotFoundException e) {
26 e.printStackTrace();
27 } catch (IOException e) {
28 e.printStackTrace();
29 }
30 }

      三、嵌套message生成的Java代码。
      enum UserStatus {
          OFFLINE = 0;
          ONLINE = 1;
      }
      enum LoginResult {
          LOGON_RESULT_SUCCESS = 0;
          LOGON_RESULT_NOTEXIST = 1;
          LOGON_RESULT_ERROR_PASSWD = 2;
          LOGON_RESULT_ALREADY_LOGON = 3;
          LOGON_RESULT_SERVER_ERROR = 4;
      }
      message UserInfo {
          required int64 acctID = 1;
          required string name = 2;
          required UserStatus status = 3;
      }
      message LogonRespMessage {
          required LoginResult logonResult = 1;
          required UserInfo userInfo = 2; //这里嵌套了UserInfo消息。
      }
      对于上述消息生成的Java代码,UserInfo因为只是包含了原始类型字段,因此和上例中的LogonReqMessage没有太多的差别,这里也就不在重复列出了。由于LogonRespMessage消息中嵌套了UserInfo类型的字段,在这里我们将仅仅给出该消息生成的Java代码和关键性注释。

 1     public static final class LogonRespMessage extends
2 com.google.protobuf.GeneratedMessageLite
3 implements LogonRespMessageOrBuilder {
4
5 //Message类的通用性函数定义。
6 ... ...
7
8 // required .LoginResult logonResult = 1;
9 public static final int LOGONRESULT_FIELD_NUMBER = 1;
10 public boolean hasLogonResult() {
11 return ((bitField0_ & 0x00000001) == 0x00000001);
12 }
13 public com.lsk.lyphone.LYPhoneMessage.LoginResult getLogonResult() {
14 return logonResult_;
15 }
16
17 // required .UserInfo userInfo = 2;
18 public static final int USERINFO_FIELD_NUMBER = 2;
19 public boolean hasUserInfo() {
20 return ((bitField0_ & 0x00000002) == 0x00000002);
21 }
22 public com.lsk.lyphone.LYPhoneMessage.UserInfo getUserInfo() {
23 return userInfo_;
24 }
25 //Message类的通用性函数定义。可参照上一小节中的代码和注释。
26 ... ...
27
28 public static final class Builder extends
29 com.google.protobuf.GeneratedMessageLite.Builder<
30 com.lsk.lyphone.LYPhoneMessage.LogonRespMessage, Builder>
31 implements com.lsk.lyphone.LYPhoneMessage.LogonRespMessageOrBuilder {
32
33 //一些适用于绝大多数Builder对象的通用性方法。
34 ... ...
35
36 //当前示例中Builder生成的代码和上一小节中生成的代码非常类似,这里就不一一赘述了。
37 //和前面的例子相比一个重要的差别是setUserInfo函数多提供了一种函数签名,其参数为
38 //UserInfo类的Builder对象。这样调用者在使用时可以直接将Builder对象作为参数传入。
39 public Builder setUserInfo(com.lsk.lyphone.LYPhoneMessage.UserInfo.Builder builderForValue) {
40 userInfo_ = builderForValue.build();
41 bitField0_ |= 0x00000002;
42 return this;
43 }
44 }
45 }

下面是读写LogonRespMessage对象的Java测试代码和说明性注释。

 1     private static void testNestedMessage() {
2 System.out.println("==================This is nested message.================");
3 LogonRespMessage.Builder logonRespBuilder = LogonRespMessage.newBuilder();
4 logonRespBuilder.setLogonResult(LoginResult.LOGON_RESULT_SUCCESS);
5 UserInfo.Builder userInfo = UserInfo.newBuilder();
6 userInfo.setAcctID(200);
7 userInfo.setName("Tester");
8 userInfo.setStatus(UserStatus.OFFLINE);
9 //这里也可以直接传递userInfo对象作为参数。因为LogonRespBuilder类提供了setUserInfo的方法重载。
10 logonRespBuilder.setUserInfo(userInfo.build());
11 LogonRespMessage logonResp = logonRespBuilder.build();
12 int length = logonResp.getSerializedSize();
13 System.out.println("The result length is " + length);
14 byte[] buf = logonResp.toByteArray();
15
16 try {
17 LogonRespMessage logonResp2 = LogonRespMessage.parseFrom(buf);
18 UserInfo userInfo2 = logonResp2.getUserInfo();
19 System.out.println("LogonResult = " + logonResp2.getLogonResult().toString() + " acctID = "
20 + userInfo2.getAcctID() + " name = " + userInfo2.getName() + " status = " + userInfo2.getStatus().toString());
21 } catch (InvalidProtocolBufferException e) {
22 e.printStackTrace();
23 }
24 System.out.println("Reading data from local file generated by C++");
25 try {
26 LogonRespMessage logonResp3 = LogonRespMessage.parseFrom(new FileInputStream("C:/Mine/LogonResp.dat"));
27 UserInfo userInfo3 = logonResp3.getUserInfo();
28 System.out.println("LogonResult = " + logonResp3.getLogonResult().toString() + " acctID = "
29 + userInfo3.getAcctID() + " name = " + userInfo3.getName() + " status = " + userInfo3.getStatus().toString());
30 } catch (FileNotFoundException e) {
31 e.printStackTrace();
32 } catch (IOException e) {
33 e.printStackTrace();
34 }
35 }

      四、repeated嵌套message生成的Java代码。
      message BuddyInfo {
          required UserInfo userInfo = 1;
          required int32 groupID = 2;
      }
      message RetrieveBuddiesResp {
          required int32 buddiesCnt = 1;
          repeated BuddyInfo buddiesInfo = 2;
      }
      对于上述消息生成的代码,我们将只是针对RetrieveBuddiesResp消息所对应的Java代码进行详细说明,其余部分和前面小节的例子基本相同,可直接参照。而对于RetrieveBuddiesResp类中的代码,我们也仅仅是对buddiesInfo字段生成的代码进行更为详细的解释。

 1     public static final class RetrieveBuddiesResp extends
2 com.google.protobuf.GeneratedMessageLite
3 implements RetrieveBuddiesRespOrBuilder {
4 //这里均为Protocol Buffer生成的通用性代码。
5 ... ...
6 // repeated .BuddyInfo buddiesInfo = 2;
7 public static final int BUDDIESINFO_FIELD_NUMBER = 2;
8 //对于repeated类型的字段,均返回类型参数为字段类型的泛型容器对象。
9 public java.util.List<com.lsk.lyphone.LYPhoneMessage.BuddyInfo> getBuddiesInfoList() {
10 return buddiesInfo_;
11 }
12 public java.util.List<? extends com.lsk.lyphone.LYPhoneMessage.BuddyInfoOrBuilder> getBuddiesInfoOrBuilderList() {
13 return buddiesInfo_;
14 }
15 public int getBuddiesInfoCount() {
16 return buddiesInfo_.size();
17 }
18 public com.lsk.lyphone.LYPhoneMessage.BuddyInfo getBuddiesInfo(int index) {
19 return buddiesInfo_.get(index);
20 }
21 public com.lsk.lyphone.LYPhoneMessage.BuddyInfoOrBuilder getBuddiesInfoOrBuilder(int index) {
22 return buddiesInfo_.get(index);
23 }
24
25 //这里仍有一些Protocol Buffer生成的通用性代码。
26 ... ...
27
28 public static final class Builder extends
29 com.google.protobuf.GeneratedMessageLite.Builder<
30 com.lsk.lyphone.LYPhoneMessage.RetrieveBuddiesResp, Builder>
31 implements com.lsk.lyphone.LYPhoneMessage.RetrieveBuddiesRespOrBuilder {
32
33 //这里仅列出和操作repeated字段相关的方法,其他的方法和前面的例子基本一致。
34 // repeated .BuddyInfo buddiesInfo = 2;
35 //本来打算给出比较详细的说明,但是看到Google为每个函数的命名之后就放弃这个想法,
36 //这样一来不仅可以避免画蛇添足,而且也节省了时间。:)
37 public java.util.List<com.lsk.lyphone.LYPhoneMessage.BuddyInfo> getBuddiesInfoList() {
38 return java.util.Collections.unmodifiableList(buddiesInfo_);
39 }
40 public int getBuddiesInfoCount() {
41 return buddiesInfo_.size();
42 }
43 public com.lsk.lyphone.LYPhoneMessage.BuddyInfo getBuddiesInfo(int index) {
44 return buddiesInfo_.get(index);
45 }
46 public Builder setBuddiesInfo(int index, com.lsk.lyphone.LYPhoneMessage.BuddyInfo value) {
47 ... ...
48 }
49 public Builder setBuddiesInfo(int index, com.lsk.lyphone.LYPhoneMessage.BuddyInfo.Builder builderForValue) {
50 ... ...
51 }
52 public Builder addBuddiesInfo(com.lsk.lyphone.LYPhoneMessage.BuddyInfo value) {
53 ... ...
54 }
55 public Builder addBuddiesInfo(int index, com.lsk.lyphone.LYPhoneMessage.BuddyInfo value) {
56 ... ...
57 }
58 public Builder addBuddiesInfo(com.lsk.lyphone.LYPhoneMessage.BuddyInfo.Builder builderForValue) {
59 ... ...
60 }
61 public Builder addBuddiesInfo(
62 int index, com.lsk.lyphone.LYPhoneMessage.BuddyInfo.Builder builderForValue) {
63 ... ...
64 }
65 public Builder addAllBuddiesInfo(
66 java.lang.Iterable<? extends com.lsk.lyphone.LYPhoneMessage.BuddyInfo> values) {
67 ... ...
68 }
69 public Builder clearBuddiesInfo() {
70 ... ...
71 }
72 public Builder removeBuddiesInfo(int index) {
73 ... ...
74 }
75 }
76 }

下面是读写RetrieveBuddiesResp对象的Java测试代码和说明性注释。

 1     private static void testRepeatedMessage() {
2 System.out.println("==================This is repeated message.================");
3 RetrieveBuddiesResp.Builder retrieveBuddiesBuilder = RetrieveBuddiesResp.newBuilder();
4 retrieveBuddiesBuilder.setBuddiesCnt(2);
5 BuddyInfo.Builder buddyInfoBuilder = BuddyInfo.newBuilder();
6 buddyInfoBuilder.setGroupID(20);
7 UserInfo.Builder userInfoBuilder = UserInfo.newBuilder();
8 userInfoBuilder.setAcctID(200);
9 userInfoBuilder.setName("user1");
10 userInfoBuilder.setStatus(UserStatus.OFFLINE);
11 buddyInfoBuilder.setUserInfo(userInfoBuilder.build());
12 retrieveBuddiesBuilder.addBuddiesInfo(buddyInfoBuilder.build());
13
14 buddyInfoBuilder = BuddyInfo.newBuilder();
15 buddyInfoBuilder.setGroupID(21);
16 userInfoBuilder = UserInfo.newBuilder();
17 userInfoBuilder.setAcctID(201);
18 userInfoBuilder.setName("user2");
19 userInfoBuilder.setStatus(UserStatus.ONLINE);
20 buddyInfoBuilder.setUserInfo(userInfoBuilder);
21 retrieveBuddiesBuilder.addBuddiesInfo(buddyInfoBuilder);
22 RetrieveBuddiesResp buddiesResp = retrieveBuddiesBuilder.build();
23
24 int length = buddiesResp.getSerializedSize();
25 System.out.println("The result length is " + length);
26 byte[] buf = buddiesResp.toByteArray();
27
28 try {
29 RetrieveBuddiesResp buddiesResp2 = RetrieveBuddiesResp.parseFrom(buf);
30 System.out.println("BuddiesCount = " + buddiesResp2.getBuddiesCnt());
31 System.out.println("Repeated Size = " + buddiesResp2.getBuddiesInfoCount());
32 for (int i = 0; i < buddiesResp2.getBuddiesInfoCount(); ++i) {
33 BuddyInfo buddyInfo = buddiesResp2.getBuddiesInfo(i);
34 UserInfo userInfo = buddyInfo.getUserInfo();
35 System.out.println("GroupID = " + buddyInfo.getGroupID() + " UserInfo.acctID = " + userInfo.getAcctID()
36 + " UserInfo.name = " + userInfo.getName() + " UserInfo.status = " + userInfo.getStatus());
37 }
38
39 } catch (InvalidProtocolBufferException e) {
40 e.printStackTrace();
41 }
42 System.out.println("Reading data from local file generated by C++");
43 try {
44 RetrieveBuddiesResp buddiesResp3 = RetrieveBuddiesResp.parseFrom(new FileInputStream("C:/Mine/RetrieveBuddiesResp.dat"));
45 System.out.println("BuddiesCount = " + buddiesResp3.getBuddiesCnt());
46 System.out.println("Repeated Size = " + buddiesResp3.getBuddiesInfoCount());
47 List<BuddyInfo> buddiesInfo = buddiesResp3.getBuddiesInfoList();
48 for (BuddyInfo buddyInfo : buddiesInfo) {
49 UserInfo userInfo = buddyInfo.getUserInfo();
50 System.out.println("GroupID = " + buddyInfo.getGroupID() + " UserInfo.acctID = " + userInfo.getAcctID()
51 + " UserInfo.name = " + userInfo.getName() + " UserInfo.status = " + userInfo.getStatus());
52 }
53 } catch (FileNotFoundException e) {
54 e.printStackTrace();
55 } catch (IOException e) {
56 e.printStackTrace();
57 }
58 }

对于Java而言,我们可以通过Maven工具生成两个jar包,其中一个是protobuf-java-2.4.1.jar,主要用于optimize_for选项为非LITE_RUNTIME的情况,而另一个protobuf-java-2.4.1-lite.jar文件则恰恰与之相反。另外,我通过Beyond Compare工具对这两个jar包进行了二进制比较后发现,他们是完全相同的。这里之所以仍以LITE版本为例,主要还是因为和之前一篇Blog(C++实例)想匹配。
      最后需要说明的是,Protocol Buffer仍然提供了很多其它非常有用的功能,特别是针对序列化的目的地,比如文件流和网络流等。与此同时,也提供了完整的官方文档和规范的命名规则,在很多情况下,可以直接通过函数的名字便可获悉函数所完成的工作。
      该Blog中使用的示例代码均已附件的方式上传,欢迎大家下载并指正。

Protocol Buffer技术详解(Java实例)的更多相关文章

  1. Protocol Buffer技术详解(C++实例)

    Protocol Buffer技术详解(C++实例) 这篇Blog仍然是以Google的官方文档为主线,代码实例则完全取自于我们正在开发的一个Demo项目,通过前一段时间的尝试,感觉这种结合的方式比较 ...

  2. Protocol Buffer技术详解(数据编码)

    Protocol Buffer技术详解(数据编码) 之前已经发了三篇有关Protocol Buffer的技术博客,其中第一篇介绍了Protocol Buffer的语言规范,而后两篇则分别基于C++和J ...

  3. Protocol Buffer技术详解(语言规范)

    Protocol Buffer技术详解(语言规范) 该系列Blog的内容主体主要源自于Protocol Buffer的官方文档,而代码示例则抽取于当前正在开发的一个公司内部项目的Demo.这样做的目的 ...

  4. 红帽Linux故障定位技术详解与实例(4)

    红帽Linux故障定位技术详解与实例(4)   在线故障定位就是在故障发生时, 故障所处的操作系统环境仍然可以访问,故障处理人员可通过console, ssh等方式登录到操作系统上,在shell上执行 ...

  5. 红帽Linux故障定位技术详解与实例(3)

    红帽Linux故障定位技术详解与实例(3)   在线故障定位就是在故障发生时, 故障所处的操作系统环境仍然可以访问,故障处理人员可通过console, ssh等方式登录到操作系统上,在shell上执行 ...

  6. 红帽Linux故障定位技术详解与实例(2)

    红帽Linux故障定位技术详解与实例(2) 2011-09-28 14:26 圈儿 BEAREYES.COM 我要评论(0) 字号:T | T 在线故障定位就是在故障发生时, 故障所处的操作系统环境仍 ...

  7. 红帽Linux故障定位技术详解与实例(1)

    红帽Linux故障定位技术详解与实例(1) 2011-09-28 14:26 圈儿 BEAREYES.COM 我要评论(0) 字号:T | T 在线故障定位就是在故障发生时, 故障所处的操作系统环境仍 ...

  8. Java基础-反射(reflect)技术详解

    Java基础-反射(reflect)技术详解 作者:尹正杰 版权声明:原创作品,谢绝转载!否则将追究法律责任. 一.类加载器 1>.JVM 类加载机制  如下图所示,JVM类加载机制分为五个部分 ...

  9. Java学习-007-Log4J 日志记录配置文件详解及实例源代码

    此文主要讲述在初学 Java 时,常用的 Log4J 日志记录配置文件详解及实例源代码整理.希望能对初学 Java 编程的亲们有所帮助.若有不足之处,敬请大神指正,不胜感激!源代码测试通过日期为:20 ...

随机推荐

  1. 修改linux文件权限

    Linux系统中的每个文件和目录都有访问许可权限,用它来确定谁可以通过何种方式对文件和目录进行访问和操作. 文件或目录的访问权限分为只读,只写和可执行三种.以文件为例,只读权限表示只允许读其内容,而禁 ...

  2. CentOS学习笔记--MySQL安装

    MySQL安装 Linux中使用最广泛的数据库就是MySQL,使用在线yum的方式安装的版本落后MySQL网站好几个小版本,本节亲自测试安装新版的MySQL. 测试机器环境: VMware Works ...

  3. Android App集成支付宝

    原地址:http://blog.csdn.net/wenbingoon/article/details/7933078 手机的在线支付,被认为是2012年最看好的功能,我个人认为这也是移动互联网较传统 ...

  4. 让chrome浏览器快的不要不要的

    Chrome 已经成了很多人的主力浏览器,你可能被它的简洁快速所吸引,但它日益丰富的「扩展」,你可能从来都没有接触过,而事实上,很多扩展可以挖掘出 Chrome 的潜能,让它变得前所未有的强大.有哪些 ...

  5. 第1章 Lua基础

    1.1 全局变量 全局变量不需要声明,给一个变量赋值后即创建了这个全局变量,访问一个没有初始化的全局变量也不会出错,只不过得到的结果是:nil. 如果你想删除一个全局变量,只需要将变量负值为 nil ...

  6. RedHat Linux 5.5安装JDK+Tomcat并部署Java项目

    与大家分享下RedHat Linux 5.5安装JDK+Tomcat并部署Java项目的步骤,希望对大家有用. 1.下载并安装jdk 虚拟机中安装RedHat Linux 5.5 64位企业版, 这里 ...

  7. intellij-项目目录隐藏无用的文件和文件夹

    File-->Editor-->File Types

  8. jquery 根据文本设置选中某个选项

    <select name="streetid" id="streetid"> <option value="4">a ...

  9. C语言编程漫谈——main函数

    写在前面 促使我写这篇文章是因为我这几天找了几个一样是大三的同学,与我相同专业相同方向(物联网)的人,除了@小胡同的诗,基本没有什么其他人会现在看起来很简单的编程题目了.问了一下其他同学,他们大部分都 ...

  10. 转 jQuery中的$.extend方法来扩展JSON对象

    $.extend方法可以扩展JSON对象,用一个或多个其他对象来扩展一个对象,返回被扩展的对象. 例一 合并 settings 和 options,修改并返回 settings var setting ...