### protobuf的编译、安装与简单使用指南
#### 一、概述
本文档旨在提供一个关于protobuf的基础使用教程，包括其安装过程以及简单的C++示例。Protocol Buffers（简称protobuf）是由Google开发的一种数据交换格式，它比XML更小、更快、更简单。protobuf可以用于网络通信和数据存储等应用场景。
#### 二、protobuf安装步骤
1. **下载并解压protobuf源码包**：
```bash
tar -xvf protobuf.tar.gz
```
2. **进入protobuf目录**：
```bash
cd protobuf
```
3. **生成configure脚本**：
```bash
./autogen.sh
```
4. **配置安装路径并编译**：
```bash
./configure --prefix=/usr/local/protobuf
make
```
5. **进行编译检查**：
```bash
make check
```
6. **安装protobuf**：
```bash
make install
```
7. **环境变量配置**：为了确保可以在任意位置调用protobuf相关的工具和库，需要配置环境变量。
- 修改`/etc/profile`文件：
```bash
vi /etc/profile
```
添加以下内容：
```bash
export PATH=$PATH:/usr/local/protobuf/bin/
export PKG_CONFIG_PATH=/usr/local/protobuf/lib/pkgconfig/
```
- 执行`source /etc/profile`使修改生效。
- 另外，如果在某些场景下遇到无法找到`protoc`命令的情况，还需要在用户的`.profile`文件中添加上述环境变量设置。
8. **动态链接库配置**：为了确保程序能够正确地加载protobuf的动态链接库，需要修改动态链接库的配置文件。
- 使用`vim`编辑`/etc/ld.so.conf`文件：
```bash
vim /etc/ld.so.conf
```
- 在文件末尾添加一行`/usr/local/protobuf/lib`。
- 更新动态链接库缓存：
```bash
ldconfig
```
#### 三、protobuf使用示例(C++)
1. **定义.proto文件**：首先需要定义一个`.proto`文件来描述数据结构。例如，创建一个名为`a.proto`的文件：
```proto
message PermitGwPolicys {
repeated PermitGwPolicy permitGwPolicy = 1; // 策略
repeated PermitGwWhiteInfo permitGwWhiteInfo = 2; // 白名单
}
message PermitGwPolicy {
optional string permitGwPolicyId = 1; // 准入策略ID
optional string applySystemIp = 2; // 应用系统地址
optional string applySystemPort = 3; // 应用系统端口
optional string responseAction = 4; // 响应动作
repeated ExtendField extendFieldList = 5; // 扩展字段
}
message PermitGwWhiteInfo {
optional string startIp = 1; // 起始IP
optional string endIp = 2; // 结束IP
optional string permitGwPolicyId = 3; // 策略ID
repeated ExtendField extendFieldList = 4; // 扩展字段
}
```
2. **编译.proto文件**：使用`protoc`命令将`.proto`文件编译为C++代码。
```bash
protoc --cpp_out=./ a.proto
```
这将在当前目录下生成两个文件：`a.pb.h` 和 `a.pb.cc`。
3. **编写C++程序**：接下来编写一个简单的C++程序来读取并解析`a.proto`文件中的数据。
```cpp
#include <iostream>
#include <fstream>
#include <string>
#include "permitGwPolicyInfo.pb.h"
using namespace std;
int main() {
fstream input("a.proto", ios::in | ios::binary);
PermitGwPolicys a1;
a1.ParseFromIstream(&input);
cout << "===== permitgwpolicy =====" << a1.permitgwpolicy_size() << endl;
for (int i = 0; i < a1.permitgwpolicy_size(); i++) {
cout << a1.permitgwpolicy(i).permitgwpolicyid() << endl;
cout << a1.permitgwpolicy(i).applysystemip() << endl;
cout << a1.permitgwpolicy(i).applysystemport() << endl;
}
cout << "===== permitgwwhiteInfo =====" << a1.permitgwwhiteinfo_size() << endl;
for (int j = 0; j < a1.permitgwwhiteinfo_size(); j++) {
cout << a1.permitgwwhiteinfo(j).startip() << endl;
cout << a1.permitgwwhiteinfo(j).endip() << endl;
cout << a1.permitgwwhiteinfo(j).permitgwpolicyid() << endl;
}
return 0;
}
```
4. **编译C++程序**：使用`g++`命令进行编译，并链接protobuf库。
```bash
g++ -I/usr/local/protobuf/include a.pb.cc *.cpp `pkg-config --cflags --libs protobuf`
```
至此，已经完成了protobuf的基本安装与使用流程。通过上述步骤，您可以成功地安装protobuf并利用其强大的序列化功能处理各种数据结构。这为在网络通信和数据存储等方面的应用提供了便利。
