protobuf简单使用

╰半橙微兮° 2022-06-06 08:56 181阅读 0赞

一、介绍

首先，protobuf是一个开源项目，而且是后台很硬的开源项目。网上现有的大部分（至少80%）开源项目，要么是某人单干、要么是几个闲杂人等合伙搞。而protobuf则不然，它是 鼎鼎大名的Google公司开发出来，并且在Google内部久经考验的一个东东。由此可见，它的作者绝非一般闲杂人等可比。  
　　 那这个听起来牛X的东东到底有啥用处捏？简单地说，这个东东干的事儿其实和XML 差不多，也就是把某种[数据结构][Link 1]的信息，以某种格式保存起来。主要用于数据存储、传输协议格式等场合。有同学可能心理犯嘀咕了：放着好好的XML不用，干嘛重新发明轮子啊？！先别急，后面俺自然会有说道。  
　　话说到了去年（大约是08年7月），Google突然大发慈悲，把这个好东西贡献给了开源社区。这下，像俺这种喜欢捡现成的家伙可就有福啦！貌似喜欢捡现成的家伙还蛮多滴，再加上 Google的号召力，开源后不到一年，protobuf的人气就已经很旺了。

二、安装 （请见本文最后）

1、下载protobuf源码包

2、解压安装

1.  root@ubuntu:/opt/protobuf-2.5.0\# ./configure  
2.  ...  
3.  root@ubuntu:/opt/protobuf-2.5.0\#make  
4.  ...  
5.  root@ubuntu:/opt/protobuf-2.5.0\# make check  
6.  ...  
7.  root@ubuntu:/opt/protobuf-2.5.0\# make install       //need root permission

3、默认的安装路径是/usr/local/include和/usr/local/lib里面，所以要设置一下编译加载库的默认环境变量，如果不设置会提示找不到动态库。

1.  export PATH=$HOME/bin/protobuf/bin:$PATH
2.  export LD\_LIBRARY\_PATH=$LD\_LIBRARY\_PATH:$HOME/bin/protobuf/lib
3.  export LIBRARY\_PATH=$LIBRARY\_PATH:$HOME/bin/protobuf/lib

三、使用示例

1、写一个简单的hello.proto文件，定义数据的类型

1.  package hello;  
2.  message Hello  
3.  \{  
4.      required int32 id = 1;  
5.      required string name = 2;  
6.      optional string email = 3;  
7.  \}

2、创建一个out目录，输出protoc 格式化后的.cc文件和.h文件

1.  protoc -I=./proto\_def --cpp\_out=./common proto\_def/bc\_pb.proto //以C++方式输出

3、然后在out目录下会生成两个文件

4、编写简单C++程序编解码测试

1.  /\*hello.cpp\*/  
2.  \#include <cstdio>  
3.  \#include <cstring>  
4.  \#include "out/hello.pb.h"  
5.    
6.  **using** **namespace** std;  
7.  **using** **namespace** hello;  
8.    
9.  **int** main()  
10. \{  
11.     Hello a;  
12.     a.set\_id(101);  
13.     a.set\_name("kiqin");  
14.     a.set\_email("769232001@qq.com");  
15.     string tmp;  
16.     **bool** ret = a.SerializeToString(&tmp);  
17.     **if** (ret)  
18.     \{  
19.         printf("encode success!\\n");  
20.     \}  
21.     **else**  
22.     \{  
23.         printf("encode faild!\\n");  
24.     \}  
25.     Hello b;  
26.     ret = b.ParseFromString(tmp);  
27.     **if** (ret)  
28.     \{  
29.         printf("decode success!\\n id= %d \\n name = %s\\n email = %s\\n",   
30.         b.id(), b.name().c\_str(), b.email().c\_str());  
31.     \}  
32.     **else**  
33.     \{  
34.         printf("decode faild!\\n");  
35.     \}  
36.     **return** 0;  
37. \}

5、为了方便编译，写一个makefile管理

1.  CC = g++  
2.  TARGET = hello  
3.  CFALGS = -Wall -g -I./out -I/usr/local/include  
4.  LDFLAGS = -L/usr/local/lib  
5.  LIBS = -lprotobuf  
6.  OBJ = hello.o hello.pb.o  
7.    
8.  $(TARGET):$(OBJ)  
9.          $(CC) $(CFLAGS) $(LDFLAGS) $(LIBS) -o $@ $^  
10. hello.o:hello.cpp  
11.         $(CC) -c $(CFLAGS) $(LDFLAGS) $(LIBS) -o $@ $<  
12. hello.pb.o:./out/hello.pb.cc  
13.         $(CC) -c $(CFLAGS) $(LDFLAGS) $(LIBS) -o $@ $<  
14. clean:  
15.         rm -fr \*.o $(TARGET)

[Link 1]: http://lib.csdn.net/base/datastructure