java protobuf 回调_java操作protobuf

message与builder

经过protoc编译完的每个message都将有一个对应的类，类的内部通过Builder设计模式进行创建对应的message，而生成的message本身是不可变的。

message Person{

required string my_name=1;

optional int32 my_age=2;

repeated string phone_num=3;

}

//使用builder构建message

Person p = Person.newBuilder().setMyName("res").setMyAge(20).addPhoneNum("123456").build();

builder中会为每个字段创建getter和setter，同时可以看到在proto文件中使用小写和下划线构成的message在生成的对象中名字被自动改成了驼峰的格式，官方也推荐在proto文件中使用小写加下划线定义字段名，对于repeated字段在builder中会创建addFieldName以及使用index设置特定位置的setFieldName。

在build出的对象中只存在各个字段的getter方法，而没有setter方法。需要修改的话可以调用对象的toBuilder方法生成builder进行修改，之后再build对象。在build出的对象中还有一些常用的方法：

isInitialized 用于builder来校验所有必填字段是否初始化。

toString 以人类可读的形式显示消息。

mergeFrom(Mesasage other) 适用于builder，用于覆盖消息中的独立字段，递归合并内部message，对repeated元素进行拼接。

clear() 适用builder，清空已经设置的所有字段。

enum

在proto中定义的枚举类型，会生成java中的枚举类型:

enum Gender{

male=1;

femail=2;

}

public enum Gender implements com.google.protobuf.ProtocolMessageEnum {

male(1),

femail(2);

...

private final int value;

private Gender(int value) {

this.value = value;

}

}

对于定义的枚举类型生成对应的枚举类型和值，并把值存在字段的value中，表示对应的值。