protobuf学习及使用笔记
一、编译protobuf
首先下载源码,可以通过git clone拉取,也可以直接down离线包,地址:https://github.com/protocolbuffers/protobuf/releases
我这里下载的是当前最新的 3.19.4 C++版
tar zvxf protobuf-cpp-3.19.4.tar.gz
cd protobuf-3.19.4
解压之后的目录如下:
按照以下步骤执行命令:
./configure
sudo make
sudo make check #可以有无,但最好check一下,比较耗时并且可能会有一个错误
sudo make install
完成之后库文件及头文件一般会在下面路径
/usr/loacl/lib /usr/loacl/include
二、使用protobuf
首先项目需要引入libprotobuf的头文件。
然后创建一个proto文件,如我这里的simufly.proto
syntax = "proto3";
package kl.simufly;
message ControlCmd {
enum cmdType {
start = 0;
stop = 1;
terminate = 2;
}
int32 n=1;
optional cmdType cmd_type = 2;
string test=3;
}
message ModifyParameter {
string name = 1;
double value = 2;
}
一个message代表一种消息类型,或者可以理解为一个数据结构。一个proto文件可以有多个message。
protobuf有三大关键字
required:必须提供该字段的值,否则该消息将被视为“未初始化”。
optional:可以设置也可以不设置该字段。如果未设置可选字段值,则使用默认值。对于简单类型,你可以指定自己的默认值,否则,使用系统默认值:数字类型为 0,字符串为空字符串,bools 为false。比如一个int32类型,没有加optional但是给了一个初值0,依然会被处理为未设置值,除非加上optional修饰.
repeated:可以将 repeated 字段视为动态大小的数组。
接下来通过proto文件编译出h和cc文件
protoc simufly.proto --cpp_out=./
在proto文件所在目录下生成simufly.pb.cc以及simufly.pb.h文件
引入头文件并且使用命名空间,就可以开始使用序列化以及反序列化了。
这里使用起来接口就比较简单明了了,序列化如下:
反序列化如下:
如上,学习使用记录,有新内容再补充。