首页 > 代码库 > Protobuf C/C++实战笔记(1)

Protobuf C/C++实战笔记(1)

 

前言:
  Protobuf作为数据交换格式, 被很多人喜欢. 数据压缩比高, 向后兼容性强, 性能优异, 而且对平台中性, 支持多语言(C/C++, JAVA, Python). 优点太多, 实在不胜枚举(居家旅行, 杀人放火必备良药, oh yeah! ^_^).
  本篇文章着重记录Linux下对C/C++版Protobuf的编译/链接和API使用.

Protobuf下载和安装
  让我们使用protobuf 2.4.1作为样例来展示.
  社区url: http://code.google.com/p/protobuf/
  下载链接: http://protobuf.googlecode.com/files/protobuf-2.4.1.tar.gz
  以下是相关的命令和操作
  1). 下载和解压
  wget http://protobuf.googlecode.com/files/protobuf-2.4.1.tar.gz
  tar -jxvf protobuf-2.4.1.tar.gz
  2). 编译和安装
  ./configure --disable-shared --prefix=/path/to  
  make && make install
  3). 目录结构
  tree -L 2 # 两层的目录结构(bin/inculde/lib), 如下所示:
  
  评注: bin/protoc 是pb生成工具, include, lib则是对应的头文件和相应的静态/动态库

实战演示
  让我们来编辑一下msg.proto文件

message msg_t {  required int32 id = 1;} 

  评注: 简单定义了msg_t类
  借助protoc来生成相应语言版本的序列/反序列代码

protoc --cpp_out=./ msg.proto

  评注: --cpp_out指定了c/c++版本代码的输出路径
  最终生成 msg.pb.cc msg.pb.h 两文件
  编写如下测试代码:

#include "msg.pb.h"#include <stdio.h>#include <assert.h>int main() {  char buf[1024] = {‘\0‘};  int buf_len = 0;  msg_t msg1;  msg1.set_id(1001);  // *) serialize phrase => object to byte array   msg1.SerializeToArray(buf, sizeof(buf));  buf_len = msg1.ByteSize();   msg_t msg2;  // *) deserialize phrase => byte array to object  msg2.ParseFromArray(buf, buf_len);  assert(msg1.id() == msg2.id());  return 0;}

  进行编译并运行
  g++ -o app app.cpp msg.pb.cc -I/path/to/protobuf/include -L/path/to/protobuf/lib -lprotobuf -lpthread
  ./app
  评注: /path/to为具体protobuf的安装目录 

链接方式
  静态链接还是动态链接? 这是个问题!
  在指定的protobuf库路径中, 如果存在动态连接库, 则编译的程序优先选择动态链接, 否则则采用静态链接的方式.
  让我们用图来对比说明
  动态链接方式
  在protobuf的lib目录中, 若存在动态连接库(so文件)
  
  则编译后的app可执行程序
  使用ldd app分析, 存在如下依赖项
  
  评注: 红线区域标明了引用了动态连接库libprotobuf.so.7
  直接执行二进制app文件, 遇到如下错误

./app: error while loading shared libraries: libprotobuf.so.7: cannot open shared object file: No such file or directory

  显然这边需要设定LD_LIBRARY_PATH变量

export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/path/to/protobuf/lib

  评注: /path/to/protobuf/lib为实际的protobuf安装路径
  静态链接方式
  简单的在lib目录移除所有动态连接库(so)文件,
  
  然后进行编译, 使用ldd分析
  
  直接执行app就可以了

总结:
  这边主要讲述了protobuf的编译/安装, 以及小demo编写, 重要的讲述了静态链接和动态链接的区别. 网上资料多以动态链接居多, 但实际上静态链接的方式的需要更直接些.

Protobuf C/C++实战笔记(1)