【ProtoBuf】通讯录实现（网络版）

Protobuf 还常用于通讯协议、服务端数据交换场景。那么在这个示例中，我们将实现一个网络版本的通讯录，模拟实现客户端与服务端的交互，通过 Protobuf 来实现各端之间的协议序列化。

需求如下：

• 客户端可以选择对通讯录进行以下操作：

1. 新增⼀个联系人
2. 删除⼀个联系人
3. 查询通讯录列表
4. 查询⼀个联系人的详细信息

• 服务端提供增、删、查能力，并需要持久化通讯录。
• 客户端、服务端间的交互数据使用 Protobuf 来完成。

一、环境搭建

Httplib 库：cpp-httplib 是个开源的库，是一个 C++ 封装的 http 库，使用这个库可以在 Linux、Windows 平台下完成 http 客户端、http 服务端的搭建。使用起来非常方便，只需要包含头文件 httplib.h 即可。编译程序时，需要带上 -lpthread 选项。

源码库地址：

yhirose/cpp-httplib: A C++ header-only HTTP/HTTPS server and client library (github.com)

二、Centos 下编写的注意事项

如果使用 CentOS 环境，yum 源带的 g++ 最新版本是 4.8.5，发布于 2015 年，年代久远。编译该项目会出现异常，将 gcc / g++ 升级为更高版本可解决问题。

# 安装scl
yum install -y centos-release-scl

# 安装gcc 8版本
yum install -y devtoolset-8-gcc devtoolset-8-gcc-c++

# 启⽤版本
source /opt/rh/devtoolset-8/enable

# 查看版本已经变成gcc 8.3.1
gcc -v

第二步安装 gcc 8 版本的时候，如果显示如下报错：

Could not retrieve mirrorlist http://mirrorlist.centos.org/

可以参考：

SCL更换阿里数据源_centos-sclo-scl-rh.repo-CSDN博客

注意： scl 命令启用只是临时的，退出 shell 或重启就会恢复原系统 gcc 版本，如果要长期使用的话执行：

echo "source /opt/rh/devtoolset-8/enable" >> /etc/profile

三、约定双端交互接口

1、新增一个联系人

[请求] 
    Post /contacts/add AddContactRequest
    Content-Type: application/protobuf

[响应] 
    AddContactResponse 
    Content-Type: application/protobuf

2、删除一个联系人

[请求] 
    Post /contacts/del DelContactRequest 
    Content-Type: application/protobuf

[响应] 
    DelContactResponse 
    Content-Type: application/protobuf

3、查询通讯录列表

[请求]
    GET /contacts/find-all 
 
[响应] 
    FindAllContactsResponse 
    Content-Type: application/protobuf

4、查询一个联系人的详细信息

[请求] 
    Post /contacts/find-one FindOneContactRequest 
    Content-Type: application/protobuf
 
[响应]
    FindOneContactResponse 
    Content-Type: application/protobuf

四、客户端代码实现

1、add_contact.proto

2、main.cc

3、ContactException.h（定义异常类）

4、makefile

5、运行结果

五、服务端代码实现

1、add_contact.proto（服务端存储通讯录结构定义）

2、main.cc

3、makefile

4、运行结果

{
    "age" : 20,
    "name" : "张珊",
    "phone" : 
    [
        {
            "number" : "110112119",
            "type" : 0
        },
        {
            "number" : "110112119",
            "type" : 0
        },
        {
            "number" : "110112119",
            "type" : 0
        },
        {
            "number" : "110112119",
            "type" : 0
        },
        {
            "number" : "110112119",
            "type" : 0
        }
    ],
    "qq" : "95991122",
    "address" : 
    {
        "home_address" : "陕西省西安市⻓安区",
        "unit_address" : "陕西省西安市雁塔区"
    },
    "remark" : 
    {
        "key1" : "value1",
        "key2" : "value2",
        "key3" : "value3",
        "key4" : "value4",
        "key5" : "value5"
    }
}