protobuf是一种跨语言和跨平台的基于二进制数据交换的序列化协议(框架)。它通过一定的语法来定义结构化的消息格式,使用自带的编译工具将proto源文件自动生成相关的java类。通过将这些类包含在项目中,能够高效、简洁的实现RPC相关业务消息的序列化与反序列化工作。
谷歌Protocol Buffers官网说明
https://developers.google.cn/protocol-buffers/docs/proto3
【下载】
https://github.com/protocolbuffers/protobuf/releases/tag/v3.6.1
https://github.com/protocolbuffers/protobuf/releases/download/v3.6.1/protobuf-java-3.6.1.tar.gz
https://github.com/protocolbuffers/protobuf/releases/download/v3.6.1/protobuf-java-3.6.1.zip
https://github.com/protocolbuffers/protobuf/releases/download/v3.6.1/protoc-3.6.1-win32.zip
【安装】
准备文件 protobuf-java-3.6.1.zip 和 protoc-3.6.1-win32.zip
将protoc-3.6.1-win32中的protoc.exe拷贝到C:\windows\system32目录
【dos命令】
dos命令格式为 protoc [OPTION] PROTO_FILES
--help(-h)
--version
-I=PATH, --proto_path=PATH
--java_out 输出java代码的目录
【定义proto源文件】
1.在指定目录下创建person.proto源文件,编写内容:
syntax="proto3"
package com.test.pb; // proto文件的命名空间
option java_package = "com.test.protobuf";// 生成代码后的命令空间
option java_outer_classname="PersonProto"; //不能与下文的message名字冲突,Person是一个message类型,不能作为ClassName
message Person { //定义一个消息类型
int32 id=1;
int32 age=2;
string name=3;
repeated string course=4;
}
2.编译生成目标语言格式
# 用cmd运行protoc命令格式
# protoc --proto_path(或-I)=引用的proto文件所在的文件夹 --java_out=指定生成的java文件的目录 proto源文件的路径
protoc --proto_path=D:\protobuf-3.6.1\examples --java_out=D:\protobuf-3.6.1\examples D:\protobuf-2.6.1\examples\person.proto
protoc -I=D:\protobuf-3.6.1\examples --java_out=D:\protobuf-3.6.1\examples person.proto
.
【版本变化】
在proto文件的第一行指定使用proto3的语法,syntax=“proto3”
字段前取消了required和optional两个关键字,目前可用的只有repeated关键字
【参考】
Protobuf数据格式解析
https://blog.csdn.net/mine_song/article/details/76691817
Google Protocol Buffer 的使用和原理
https://www.ibm.com/developerworks/cn/linux/l-cn-gpb/
[翻译] ProtoBuf 官方文档(二)- 语法指引(proto2)
https://www.jianshu.com/p/6f68fb2c7d19
Protobuf开发者指南
https://www.jianshu.com/p/3ab14a2cb477
Language Guide (proto3)
https://developers.google.cn/protocol-buffers/docs/proto3
spring boot restTemplate protobuf
https://blog.csdn.net/stonexmx/article/details/74453404
Netty4.x整合SpringBoot2.x使用Protobuf3详解
https://www.cnblogs.com/sanshengshui/p/9741655.html