项目——仿RabbitMQ实现消息队列

打印 上一主题 下一主题

主题 943|帖子 943|积分 2829

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有账号?立即注册

x
1.项目先容

曾经在学习Linux的过程中,我们学习过阻塞队列 (BlockingQueue) 。 当时我们说阻塞队列最大的用途, 就是用来实现生产者消费者模型。 生产者消费者模型是后端开发的常用编程方式, 它存在诸多利益:
   

  • 解耦合
  • 支持并发
  • 支持忙闲不均
  • 削峰填谷
  在实际的后端开发中, 尤其是分布式系统里, 跨主机之间使用生产者消费者模型, 也是非常普遍的需求。因此, 我们通常会把阻塞队列封装成一个独立的服务器程序, 并且赋予其更丰富的功能。 如许的服务程序我们就称为消息队列 (Message Queue, MQ)。
   MQ(Message Queue)消息队列,是基础数据结构中“先进先出”的一种数据机构。指把要传输的数据(消息)放在队列中,用队列机制来实现消息传递——生产者产生消息并把消息放入队列,然后由消费者去处理。消费者可以到指定队列拉取消息,大概订阅相应的队列,由MQ服务端给其推送消息。(来源:百度百科)
  市面上成熟的消息队列非常多:


  • RabbitMQ
  • Kafka
  • RocketMQ
  • ActiveMQ
其中 RabbitMQ 是一个非常知名、功能强大且广泛使用的消息队列。咱们就仿照RabbitMQ 模仿实现一个简单的消息队列。
   RabbitMQ的优点
  

  • 基于AMQP协议
  • 高并发(是一个容量的概念,服务器可以担当的大使命数目)
  • 高性能(是一个速率的概念,单元时间内服务器可以处理的使命数)
  • 高可用(是一个长期的概念,单元时间内服务器可以正常工作的时间比例)
  • 强大的社区支持,以及很多公司都在使用
  • 支持插件
  • 支持多语言

2.开发情况



  • Linux(Ubuntu-22.04)
  • VSCode/Vim
  • g++/gdb
  • Makefile

3.技术选型



  • 开发主语言: C++
  • 序列化框架: Protobuf 二进制序列化
  • 网络通信:

    • 方案一:自定义应用层协议+原生socket(不推荐,难度较高)
    • 方案二:自定义应用层协议+muduo库(对tcp长毗连的封装、并且使用epoll的事件驱动模式,实现高并发服务器与客户端

  • 原数据信息数据库:SQLite3
  • 单元测试框架: Gtest

4.情况搭建

本人使用的是Ubuntu22.4版本,情况搭建指令如下:


  • 安装wget
  1. sudo apt-get install wget
复制代码


  • 安装lrzsz传输工具
  1. sudo apt-get install lrzsz
复制代码


  • gcc/g++编译器
  1. sudo apt-get install gcc g++
复制代码


  • 安装项目构建工具make
  1. sudo apt-get install make
复制代码


  • 安装调试器
  1. sudo apt-get install gdb
复制代码


  • 安装 git
  1. sudo apt-get install git
复制代码


  • cmake
  1. sudo apt-get install cmake
复制代码


  • 安装 Protobuf
  1. #安装protobuf依赖库
  2. sudo apt-get install autoconf automake libtool curl unzip gzip
  3. #下载protobuf包
  4. wget https://github.com/protocolbuffers/protobuf/releases/download/v3.20.2/protobuf-all-3.20.2.tar.gz
  5. #若 github 下载过慢,则到下方链接进行下载
  6. wget https://gitee.com/qigezi/bitmq/blob/master/mqthird/protobufall-3.20.2.tar.gz
  7. # 解压缩
  8. tar -zxf protobuf-all-3.20.2.tar.gz
  9. # 切换目录
  10. cd protobuf-3.20.2/
  11. # 如果下载的是具体的某一门语言,不需要执行这一步
  12. ./autogen.sh
  13. # 配置安装路径 默认安装在 /usr/local 目录, lib、 bin 都是分散的
  14. ./configure
  15. # 开始编译 15 分钟左右
  16. make
  17. # 开始安装, 需要 root 权限
  18. sudo make install
  19. # 确认是否安装成功
  20. protoc --version
复制代码
最后的查看protobuf版本的代码可能并不能成功打印出对应的版本,并不是由于安装失败了,而是安装后的库存放于 /usr/local/lib 中, 导致运行程序时默认检索不到。可以修改/etc/ld.so.conf 文件,添加库文件路径到其中。
  1. vim /etc/ld.so.conf
复制代码
我们编写一个后缀位.proto的文件,内容如下:

编写完毕之后,在命令行输入如下内容:
  1. protoc --cpp_out=. test.proto
复制代码
编译成功之后,会生成两个文件:.pb.h和.pb.cc

这个pb.h就是c++中的头文件,pb.cc是源文件。
此时我们再创建一个test.cc文件,编写如下代码(留意,头文件要包含刚刚生成的pb.h文件)
  1. #include <iostream>
  2. #include "test.pb.h" // 引入编译生成的头文件
  3. using namespace std;
  4. int main()
  5. {
  6.     string people_str;
  7.     // 序列化
  8.     {
  9.         // .proto 文件声明的 package,通过 protoc 编译后,会为编译生成的C++代码声明同名的命名空间
  10.         // 其范围是在.proto 文件中定义的内容
  11.         contacts::PeopleInfo people;
  12.         people.set_age(20);
  13.         people.set_name("张三");
  14.         // 调用序列化方法,将序列化后的二进制序列存入 string 中
  15.         if (!people.SerializeToString(&people_str))
  16.         {
  17.             cout << "序列化联系人失败." << endl;
  18.         }
  19.         // 打印序列化结果
  20.         cout << "序列化后的 people_str: " << people_str.size() << endl;
  21.     }
  22.     // 反序列化
  23.     {
  24.         contacts::PeopleInfo people;
  25.         // 调用反序列化方法,读取 string 中存放的二进制序列,并反序列化出对象
  26.         if (!people.ParseFromString(people_str))
  27.         {
  28.             cout << "反序列化出联系人失败." << endl;
  29.         }
  30.         // 打印结果
  31.         cout << "Parse age: " << people.age() << endl;
  32.         cout << "Parse name: " << people.name() << endl;
  33.     }
  34.     return 0;
  35. }
复制代码
编写完毕之后,使用如下命令举行编译:
  1. g++ -std=c++11 test.cc test.pb.cc -o test -lprotobuf
复制代码
编译成功后,就会生成一个可实行文件test,我们运行该文件:

如果最终能成功表现出上面的结果,则阐明安装是没有问题的。

安装 Muduo
  1. # 1.下载muduo库
  2. # git 方式
  3. git clone https://github.com/chenshuo/muduo.git
  4. # 备用下载地址
  5. wget https://gitee.com/hansionz/mq/raw/master/resource/muduo-master.zip
  6. # 2.解压muduo-master压缩包
  7. unzip muduo-master.zip
  8. # 3.安装依赖库
  9. sudo apt-get install libz-dev libboost-all-dev
  10. # 4.运行脚本编译安装
  11. cd muduo-master/
  12. ./build.sh
  13. ./build.sh install
复制代码
同样,我们也需要测试一下是否安装成功,在实行完上面的步骤后,muduo-master同级目录下会生成一个build目录,我们进入该目录下。

然后继承进入release-cpp11目录下的bin目录
  1. cd release-cpp11/bin
复制代码
这个目录下包含很多可实行程序,我们运行其中的protobuf_server,启动后他会卡在那里,表示服务端已经就绪,要等待客户端毗连。

我们重新启动一个窗口,然后打开这个目录下的protobuf_client(客户端),并绑定好ip和端口。

在输入回车的一瞬间就打印出很多消息,阐明与服务端毗连成功了。
并且服务端也打印出了日志。

如果以上步骤都没问题,则阐明muduo库安装成功。



  • 安装 SQLite3
  1. sudo apt-get install sqlite3 libsqlite3-dev
  2. # 验证是否安装成功
  3. sqlite3 --version
复制代码


  • 安装 Gtest
  1. sudo apt-get install libgtest-dev
复制代码
测试 GTest 是否安装成功,编写下面C++代码:
  1. #include<gtest/gtest.h>
  2. int add(int a,int b)
  3. {
  4.     return a+b;
  5. }
  6. TEST(testCase,test1)
  7. {
  8.     EXPECT_EQ(add(2,3),5);
  9. }
  10. int main(int argc,char **argv)
  11. {
  12.     testing::InitGoogleTest(&argc,argv);   
  13.     return RUN_ALL_TESTS();
  14. }
复制代码
编译源文件
  1. g++ test_gtest.cc -o gtest -lgtest
复制代码
运行gtest程序

如果可以成功运行出结果,则阐明安装成功了。

5.第三方库快速上手

在正式编写项目代码之前,我们还需要熟悉一下前面安装的各种第三方库,使用这些库的利益在于,我们可以直接使用库中已经编写好的代码,而不消什么都去本身手动实现,大大节省了编写代码的时间和难度。
下面我将会简单的先容一下每个库怎样使用,带大家快速上手。
5.1 Protobuf

笔者在之前写过一篇博客,具体先容了protobuf的语法,感兴趣的同砚可以去看看:从入门到夺目——ProtoBuf_proto message和协议-CSDN博客
   Protobuf 是什么
  ProtoBuf(全称 Protocol Buffer)是数据结构序列化和反序列化框架,它具有以下特点:


  • 语言无关、平台无关: 即 ProtoBuf 支持 Java、 C++、 Python 等多种语言,支持多个平台
  • 高效: 即比 XML 更小、更快、更为简单
  • 扩展性、兼容性好: 你可以更新数据结构,而不影响和破坏原有的旧程序
   Protobuf 使用流程先容
  



  • 编写 .proto 文件,描述我们想要定义的结构化对象(描述对象中,包含什么成员,每个成员具有什么属性),不理解的同砚就以为定义了一个C语言中的结构体。
  • 使用 protoc 编译器编译 .proto 文件,生成一系列接口代码,.h中定义了我们所描述的数据结构对象类,.cc定义告终构化对象数据的访问、操作、序列化、反序列化
  • 依赖生成的接口,将编译生成的头文件包含进我们的代码中,实现对 .proto 文件中定义的字段举行设置和获取,和对 message 对象举行序列化和反序列化
   ProtoBuf 快速上手
  我们以一个简单通讯录的实现来驱动对 Protobuf 的学习。在通讯录 demo 中,我们将实现:


  • 对一个联系人的信息使用 Protobuf 举行序列化,并将结果打印出来
  • 对序列化后的内容使用 Protobuf 举行反序列,解析出联系人信息并打印出来
  • 联系人包含以下信息: 姓名、年岁
通过通讯录 demo,我们能快速的了解 ProtoBuf 的使用流程。


  • 1)创建.proto文件
我们为通讯录 demo 新建文件: contacts.proto


  • 2)指定 proto3 语法
在 .proto 文件中,要使用 syntax = "proto3"; 来指定文件语法为 proto3,并且必须写在除去注释内容的第一行。 如果没有指定,编译器会使用 proto2 语法。
在通讯录 demo 的 contacts.proto 文件中,可以为文件指定 proto3 语法,内容如下:



  • 3)package 声明符
package 是一个可选的声明符,能表示 .proto 文件的定名空间,在项目中要有唯一性。它的作用是给生成的代码添加定名空间,制止我们定义的消息出现冲突(和C++中的定名空间是一个意思)。
在通讯录 demo 的 contacts.proto 文件中,可以声明其定名空间,内容如下:



  • 4)定义消息(message)
消息(message) : 要定义的结构化对象,我们可以给这个结构化对象中定义其对应的属性内容。(和C语言中的结构体比力像)
在通讯录 demo 中我们就需要为联系人定义一个 message:

留意:消息范例名非常告急,这个名字就是将来生成的类的名字,我们这里将其定名为PeopleInfo表示这个结构化对象表示的是联系人信息。


  • 5)定义消息字段
在 message 中我们可以定义其属性字段,字段定义格式为: 字段范例 字段名 = 字段唯一编号;


  • 字段名称定名规范:全小写字母,多个字母之间用 _ 毗连。
  • 字段范例分为:标量数据范例 和 特殊范例(包括枚举、其他消息范例等)。
  • 字段唯一编号:用来标识字段,一旦开始使用就不能够再改变。
下面的表格展示了定义于消息体中的标量数据范例,以及编译 .proto 文件之后主动生成的类中与之对应的字段范例。在这里展示了与 C++ 语言对应的范例

留意:变长编码[1]是指:颠末 protobuf 编码后,原本 4 字节或 8 字节的数可能会被变为其他字节数
更新 contacts.proto, 新增姓名、年岁字段


  • 6)编译contacts.proto文件
编译命令:
  1. protoc --cpp_out=. contacts.proto
复制代码
编译成功会生成两个文件,一个是pb.cc,一个是pb.h。

我们打开pb.h后可以看到如下内容(简化后的)
  1. namespace contacts {
  2.     class PeopleInfo{
  3.     public:
  4.       // string name = 1;
  5.       void clear_name();
  6.       const std::string& name() const;
  7.       template <typename ArgT0 = const std::string&, typename... ArgT>
  8.       void set_name(ArgT0&& arg0, ArgT... args);
  9.       std::string* mutable_name();
  10.       PROTOBUF_NODISCARD std::string* release_name();
  11.       void set_allocated_name(std::string* name);
  12.     private:
  13.       const std::string& _internal_name() const;
  14.       inline PROTOBUF_ALWAYS_INLINE void _internal_set_name(const std::string& value);
  15.       std::string* _internal_mutable_name();
  16.     public:
  17.       // uint32 age = 2;
  18.       void clear_age();
  19.       uint32_t age() const;
  20.       void set_age(uint32_t value);
  21.     private:
  22.       uint32_t _internal_age() const;
  23.       void _internal_set_age(uint32_t value);
  24.     }
  25. }
复制代码
我们再来对比一下之前的.proto文件,就能很明显的发现生成之后的代码都是根据我们之前写的内容生成的。

protoc编译器会主动帮我们生成很多的接口方法,如set_name()就是用来设置name字段,name()就是获取name字段,并且还支持举行序列化以及反序列化。
我们本身定义的消息类会继承于Message类,Message会继承MessageLite类,而MessageLite中提供了读写消息实例的方法,包括序列化方法和反序列化方法。
  1. class MessageLite
  2. {
  3. public:
  4.     //序列化:
  5.     bool SerializeToOstream(ostream* output) const; // 将序列化后数据写入文件流
  6.     bool SerializeToArray(void *data, int size) const;
  7.     bool SerializeToString(string* output) const;
  8.     //反序列化:
  9.     bool ParseFromIstream(istream* input); // 从流中读取数据,再进行反序列化动作
  10.     bool ParseFromArray(const void* data, int size);
  11.     bool ParseFromString(const string& data);
  12. };
复制代码
既然消息类是继承于MessageLite的,所以上面的方法我们也可以直接使用。
留意:
序列化的结果为二进制字节序列,而非文本格式。



  • 7)序列化与反序列化的使用
创建一个测试文件 info.cc,方法中我们实现:


  • 对一个联系人的信息使用 PB 举行序列化,并将序列化结果打印出来
  • 对序列化后的内容使用 PB 举行反序列,解析出联系人信息并打印出来
  1. #include <iostream>
  2. #include "./contacts.pb.h" // 引入编译生成的头文件
  3. using namespace std;
  4. int main()
  5. {
  6.     string people_str;
  7.     // 序列化
  8.     {
  9.         //设置创建一个结构化对象
  10.         contacts::PeopleInfo people;
  11.         people.set_age(20);
  12.         people.set_name("张三");
  13.         // 调用序列化方法,将序列化后的二进制序列存入 string 中
  14.         if (!people.SerializeToString(&people_str))
  15.         {
  16.             cout << "序列化联系人失败." << endl;
  17.         }
  18.         // 打印序列化结果
  19.         cout << "序列化成功,结果: " << people_str.size() << endl;
  20.     }
  21.     cout << endl;
  22.     // 反序列化
  23.     {
  24.         contacts::PeopleInfo people;
  25.         // 调用反序列化方法,读取 string 中存放的二进制序列,并反序列化出对象
  26.         if (!people.ParseFromString(people_str)) {
  27.         cout << "反序列化出联系人失败." << endl;
  28.         }
  29.         // 打印结果
  30.         cout << "反序列化成功" << endl;
  31.         cout << "Parse age: " << people.age() << endl;
  32.         cout << "Parse name: " << people.name() << endl;
  33.     }
  34.     return 0;
  35. }
复制代码
编写完代码之后,我们举行编译,生成可实行程序:
  1. g++ test.cc contacts.pb.cc -o Test -std=c++11 -lprotobuf
复制代码
运行可实行程序:

由于 ProtoBuf 是把联系人对象序列化成了二进制序列,这里用 string 来作为接收二进制序列的容器。所以在终端打印的时候会有换行等一些乱码表现。另外相对于 xml 和JSON 来说,由于 PB 被编码成二进制,破解成本增大, ProtoBuf 编码是相对安全的。
ProtoBuf团体来说还是比力简单的,重点就在于怎样编写.proto文件,有了该文件之后我们就可以转化成C++代码,直接进使用用了。

5.2 Muduo

   什么是Muduo
  Muduo是一个基于非阻塞 IO 和事件驱动的 C++高并发 TCP 网络编程库。 它是一款基于主从 Reactor 模型的网络库,其使用的线程模型是 one loop per thread, 所谓 one loop per thread 指的是:


  • 一个线程只能有一个事件循环(EventLoop), 用于响应计时器和 IO 事件
  • 一个文件描述符只能由一个线程举行读写,换句话说就是一个 TCP 毗连必须归属于某个 EventLoop 管理

muduo库有下面几个特点:


  • 1.基于主从reactor模型的高性能服务器框架

    • reactor模型:基于事件触发的模型(基于epoll举行IO事件监控)
    • 主从reactor模型:将IO事件监控举行进一步的层次划分

      • 主reactor:只对新建毗连事件举行监控(保证不受IO阻塞影响实现高效的新建毗连获取)
      • 从reactor:针对新建毗连举行IO事件监控(举行IO操作和业务处理)
      • 主从reactor必然是一个多实行流的并发模式——one thread one loop



   Muduo库 服务器常见接口先容
  

  • muduo::net::TcpServer 类基础先容
  1. typedef std::shared_ptr<TcpConnection> TcpConnectionPtr;
  2. typedef std::function<void (const TcpConnectionPtr&)> ConnectionCallback;
  3. typedef std::function<void (const TcpConnectionPtr&, Buffer*, Timestamp)> MessageCallback;
  4. class InetAddress : public muduo::copyable
  5. {
  6. public:
  7.     InetAddress(StringArg ip, uint16_t port, bool ipv6 = false);
  8. };
  9. class TcpServer : noncopyable
  10. {
  11.     public:
  12.     enum Option
  13.     {
  14.         kNoReusePort,   
  15.         kReusePort,
  16.     };
  17.     TcpServer(EventLoop* loop,
  18.         const InetAddress& listenAddr,
  19.         const string& nameArg,
  20.         Option option = kNoReusePort);
  21.     void setThreadNum(int numThreads);
  22.     void start();
  23.     /// 当一个新连接建立成功的时候被调用
  24.     void setConnectionCallback(const ConnectionCallback& cb)
  25.     { connectionCallback_ = cb; }
  26.     /// 消息的业务处理回调函数---这是收到新连接消息的时候被调用的函数
  27.     void setMessageCallback(const MessageCallback& cb)
  28.     { messageCallback_ = cb; }
  29. };
复制代码
创建TcpServer服务类后会给我们创建一个服务器,我们就不需要手动创建套接字了。

TcpServer构造函数各个参数的含义:


  • 1.loop:事件监控(封装了epoll)
  • 2.listenAddr:需要传入一个InetAddress范例的对象,该对象表示服务器绑定的IP和端标语。
  • 3.nameArg:服务器名称,用于标识差别的服务器
  • 4.option:如果我们主动关闭了服务器,服务器会进入TIME_WAIT状态,在这段时间内我们不能使用上次的IP和端口了,必须强制等待一段时间,为了办理这个问题,我么可以开启地址重用,如许主动断开毗连之后,也可以立刻重启服务器。
枚举范例Option内容如下:

其中kReusePort用于设置地址重用,kNoReusePort用于关闭地址重用。
setThreadNum:
  1. void setThreadNum(int numThreads);
复制代码
前面说到过muduo库是基于主从reactor模型的服务器,意味着在服务器内部除了创建一个主线程,还要创建很多的从线程,从线程并不是在事件到来时才被创建,而是会预先创建一批从线程(线程池),每到来一个事件,就让线程池中的某一个线程去实行。
setThreadNum就是用于设置服务器中从线程的个数。
start:
  1. void start();
复制代码
用于启动服务器。服务器并不是在我们创建好TcpServer对象时就启动了,创建TcpServer对象只是设置了服务器的一些参数(如IP,端口等),要手动调用start函数才能正式启动服务器。
回调函数:
  1. // 当一个新连接建立成功的时候被调用
  2. void setConnectionCallback(const ConnectionCallback& cb)
  3. {
  4.     connectionCallback_ = cb;
  5. }
  6. // 消息的业务处理回调函数---这是收到新连接消息的时候被调用的函数
  7. void setMessageCallback(const MessageCallback& cb)
  8. {
  9.     messageCallback_ = cb;
  10. }
复制代码
当一个新毗连建立成功时,希望实行什么动作就可以设置setConnectionCallback函数,我们将需要实行的动作写到一个函数中,并将该函数传递给setConnectionCallback函数的参数,如许在新毗连建立成功时,服务器会主动帮我们调用我们传递的函数。
setMessageCallback是消息的业务处理回调函数,新毗连建立成功后会收到来自客户端的消息,当收到客户端消息时就会主动调用我们传递的函数。
留意:
回调函数并不是想怎么写就怎么写的,必须按照指定的格式:





  • muduo::net::EventLoop 类基础先容
  1. class EventLoop : noncopyable
  2. {
  3. public:
  4.     void loop();
  5.     void quit();
  6.     TimerId runAt(Timestamp time, TimerCallback cb);
  7.     TimerId runAfter(double delay, TimerCallback cb);
  8.     TimerId runEvery(double interval, TimerCallback cb);
  9.     void cancel(TimerId timerId);
  10. private:
  11.     std::atomic<bool> quit_;
  12.     std::unique_ptr<Poller> poller_;
  13.     mutable MutexLock mutex_;
  14.     std::vector<Functor> pendingFunctors_ GUARDED_BY(mutex_);
  15. };
复制代码


  • EventLoop是muduo库中的核心对象之一。它主要用于处理事件循环,相当于一个事件分发器。在网络编程场景下,它负责处理 I/O 事件(如套接字的可读、可写事件)以及定时器事件等。
  • EventLoop会不断地循环等待事件的发生,一旦有事件就绪,就会调用相应的回调函数来处理该事件。这种事件驱动的机制是高效处理大量并发 I/O 操作的关键。
  • EventLoop内部维护了一个epoll来管理浩繁的文件描述符(套接字)。它使用这些机制来高效地检测哪些文件描述符上有事件发生。
EventLoop中有很多接口,但是我们这个项目只会用到loop()接口,内部是一个死循环,用于事件监控,当触发事件时会举行IO处理。




  • muduo::net::TcpConnection 类基础先容
  1. class TcpConnection : noncopyable,
  2. public
  3. std::enable_shared_from_this<TcpConnection>
  4. {
  5. public:
  6.     TcpConnection(EventLoop* loop,
  7.         const string& name,
  8.         int sockfd,
  9.         const InetAddress& localAddr,
  10.         const InetAddress& peerAddr);
  11.     //判断连接状态
  12.     bool connected() const { return state_ == kConnected; }
  13.     bool disconnected() const { return state_ == kDisconnected; }
  14.     //发送数据
  15.     void send(string&& message); // C++11
  16.     void send(const void* message, int len);
  17.     void send(const StringPiece& message);
  18.     void send(Buffer* message); // this one will swap data
  19.     //关闭连接
  20.     void shutdown(); // NOT thread safe, no simultaneous calling
  21.     void setContext(const boost::any& context)
  22.     { context_ = context; }
  23.     const boost::any& getContext() const
  24.     { return context_; }
  25.     boost::any* getMutableContext()
  26.     { return &context_; }
  27.     void setConnectionCallback(const ConnectionCallback& cb)
  28.     { connectionCallback_ = cb; }
  29.     void setMessageCallback(const MessageCallback& cb)
  30.     { messageCallback_ = cb; }
  31. private:
  32.     enum StateE { kDisconnected, kConnecting, kConnected, kDisconnecting };
  33.     EventLoop* loop_;
  34.     ConnectionCallback connectionCallback_;
  35.     MessageCallback messageCallback_;
  36.     WriteCompleteCallback writeCompleteCallback_;
  37.     boost::any context_;
  38. };
复制代码
TcpConnection用于表示一个 TCP 毗连的类。它封装了一个 TCP 毗连的状态、对应的套接字以及相干的读写操作和事件处理。
下面是我们会用到的TcpConnection中的接口: 


  • connected用于判断是否建立了毗连
  • disconnected用于判断毗连是否断开了
  • send用于向套接字中写入数据(向客户端发送数据)
  • shutdown用于关闭毗连。




  • muduo::net::Buffer 类基础先容
  1. class Buffer : public muduo::copyable
  2. {
  3. public:
  4.     static const size_t kCheapPrepend = 8;
  5.     static const size_t kInitialSize = 1024;
  6.     explicit Buffer(size_t initialSize = kInitialSize)
  7.         : buffer_(kCheapPrepend + initialSize)
  8.         , readerIndex_(kCheapPrepend)
  9.         , writerIndex_(kCheapPrepend)
  10.     {}
  11.     void swap(Buffer& rhs);
  12.     size_t readableBytes() const;
  13.     size_t writableBytes() const;
  14.     const char* peek() const;
  15.     const char* findEOL() const;
  16.     const char* findEOL(const char* start) const;
  17.     void retrieve(size_t len);
  18.     void retrieveInt64();
  19.     void retrieveInt32();
  20.     void retrieveInt16();
  21.     void retrieveInt8();
  22.     string retrieveAllAsString();
  23.     string retrieveAsString(size_t len);
  24.     void append(const StringPiece& str);
  25.     void append(const char* /*restrict*/ data, size_t len);
  26.     void append(const void* /*restrict*/ data, size_t len);
  27.     char* beginWrite();
  28.     const char* beginWrite() const;
  29.     void hasWritten(size_t len);
  30.     void appendInt64(int64_t x);
  31.     void appendInt32(int32_t x);
  32.     void appendInt16(int16_t x);
  33.     void appendInt8(int8_t x);
  34.     int64_t readInt64();
  35.     int32_t readInt32();
  36.     int16_t readInt16();
  37.     int8_t readInt8();
  38.     int64_t peekInt64() const;
  39.     int32_t peekInt32() const;
  40.     int16_t peekInt16() const;
  41.     int8_t peekInt8() const;
  42.     void prependInt64(int64_t x);
  43.     void prependInt32(int32_t x);
  44.     void prependInt16(int16_t x);
  45.     void prependInt8(int8_t x)
  46.     void prepend(const void* /*restrict*/ data, size_t len);
  47. private:
  48.     std::vector<char> buffer_;
  49.     size_t readerIndex_;
  50.     size_t writerIndex_;
  51.     static const char kCRLF[];
  52. };
复制代码
Buffer就是一个缓冲区,它可以临时存储从网络套接字读取的数据,大概将要发送到网络套接字的数据。
先容比力告急的几个接口:


  • 1.string retrieveAllAsString(); 从缓冲区中读取数据,读入到字符串中
  • 2.retrieve(size_t len); 从缓冲区中读取len个字节的数据。
  • 3.readableBytes(); 获取缓冲区的可读数据的大小
  • 4.append();向发送缓冲区中追加数据
   使用Muduo库搭建服务器
  我们会搭建一个浅易的翻译服务,客户端上传需要翻译的单词,服务端举行解析后返回给客户端。
服务器团体框架如下:
  1. #include <iostream>
  2. #include "include/muduo/net/TcpServer.h";
  3. #include "include/muduo/net/EventLoop.h";
  4. #include "include/muduo/net/TcpConnection.h";
  5. using namespace std;
  6. class TranslateServer
  7. {
  8. public:
  9.     TranslateServer(int port) //要绑定的端口
  10.         : _server(&_baseloop, muduo::net::InetAddress("0.0.0.0", port),
  11.          "TcpServer", muduo::net::TcpServer::Option::kReusePort) //启动地址重用
  12.     {
  13.     }
  14.     void Start();
  15. private:
  16.     //新连接建立成功时的回调函数
  17.     void onConnection(const muduo::net::TcpConnectionPtr& conn);
  18.     //收到请求时的回调函数
  19.     void onMessage(const muduo::net::TcpConnectionPtr& conn, muduo::net::Buffer* buf, muduo::Timestamp);
  20. private:
  21.     muduo::net::EventLoop _baseloop;
  22.     muduo::net::TcpServer _server;
  23. };
  24. int main()
  25. {
  26.     TranslateServer server(8080);
  27.     server.Start();
  28.     return 0;
  29. }
复制代码
在main函数中创建了一个TranslateServer对象,并传入需要绑定的端口8080,在TranslateServer对象内部会主动帮我处理好:新毗连建立成功时应该做什么,当收到毗连中发来的哀求应该做什么。
所以在main函数中只需要掉哟Start()函数即可启动服务器。
细节实现:
  1. #include <iostream>
  2. #include <functional>
  3. #include <unordered_map>
  4. #include "include/muduo/net/TcpServer.h"
  5. #include "include/muduo/net/EventLoop.h"
  6. #include "include/muduo/net/TcpConnection.h"
  7. using namespace std;
  8. class TranslateServer
  9. {
  10. public:
  11.     TranslateServer(int port) //要绑定的端口
  12.         : _server(&_baseloop, muduo::net::InetAddress("0.0.0.0", port),
  13.          "TcpServer", muduo::net::TcpServer::Option::kReusePort) //启动地址重用
  14.     {
  15.         auto fun1 = bind(&TranslateServer::onConnection, this, std::placeholders::_1);
  16.         _server.setConnectionCallback(fun1);  //不能直接设置为onConnection函数,因为包含一个隐藏的this指针
  17.         auto fun2 = bind(&TranslateServer::onMessage, this, std::placeholders::_1,
  18.             std::placeholders::_2, std::placeholders::_3);
  19.         _server.setMessageCallback(fun2);     //不能直接设置为onMessage函数,因为包含一个隐藏的this指针
  20.     }
  21.     void start()
  22.     {
  23.         _server.start();  //开始事件监听
  24.         _baseloop.loop(); //开始事件监控(是一个死循环)
  25.     }
  26. private:
  27.     //新连接建立成功时的回调函数
  28.     void onConnection(const muduo::net::TcpConnectionPtr& conn)
  29.     {
  30.         //该函数在建立连接和关闭连接时都会被调用
  31.         if (conn->connected())
  32.         {
  33.             cout << "连接建立成功!" << endl;
  34.         }
  35.         else
  36.         {
  37.             cout << "关闭连接" << endl;
  38.         }
  39.     }
  40.     string translate(const string& word)
  41.     {
  42.         static unordered_map<string, string> dict = {
  43.             {"hello", "你好"},
  44.             {"sun", "太阳"},
  45.             {"left", "左"}
  46.         };
  47.         auto it = dict.find(word);
  48.         if (it != dict.end())
  49.         {
  50.             return it->second;
  51.         }
  52.         else
  53.         {
  54.             return "查找失败";
  55.         }
  56.     }
  57.     //收到请求时的回调函数
  58.     void onMessage(const muduo::net::TcpConnectionPtr& conn, muduo::net::Buffer* buf, muduo::Timestamp)
  59.     {
  60.         //1.将缓冲区的数据读取出来放到word中
  61.         string word = buf->retrieveAllAsString();
  62.         //2.通过内置词典,翻译word对应的中文
  63.         string res = translate(word);
  64.         //3.将翻译的结果返回给客户端
  65.         conn->send(res);
  66.     }
  67. private:
  68.     muduo::net::EventLoop _baseloop;
  69.     muduo::net::TcpServer _server;
  70. };
  71. int main()
  72. {
  73.     TranslateServer server(8080);
  74.     server.start();
  75.     return 0;
  76. }
复制代码


  • 1.TranslateServer的构造函数:需要调用setConnectionCallback和setMessageCallback设置好对应的回调函数,即onConnection和onMessage函数,这两个函数的参数都必须符合特定的格式,才能作为setConnectionCallback和setMessageCallback的参数,而类的成员函数默认会携带一个隐藏的this指针,无法直接传递,需要依靠C++11中的包装器来完成。
  • 2.start函数:start是用于启动服务器,_server.start()是启动事件的监听,而_baseloop.loop()是开始事件的监控(前面说到过muduo库是基于epoll模型的),所以当调用该函数后,当套接字中读取到有事件就绪时,直接会调用设置好的回调函数。
  • 3.onConnection函数:新毗连到来时判断毗连有没有成功建立,如果有则打印。
  • 4.onMessage函数:举行业务处理的函数,当客户端发送翻译哀求时,会被监控到,并调用该函数,该函数就能读取到用户哀求,并对哀求举行处理,最后将处理结果返回给用户。

   Muduo库 客户端常见接口先容
  1. class TcpClient : noncopyable
  2. {
  3. public:
  4.     TcpClient(EventLoop* loop,
  5.         const InetAddress& serverAddr,
  6.         const string& nameArg);
  7.     ~TcpClient(); // force out-line dtor, for std::unique_ptr members.
  8.     void connect();//连接服务器
  9.     void disconnect();//关闭连接
  10.     void stop();
  11.     //获取客户端对应的通信连接 Connection 对象的接口,发起 connect 后,有可能还没有连接建立成功
  12.     TcpConnectionPtr connection() const
  13.     {
  14.         MutexLockGuard lock(mutex_);
  15.         return connection_;
  16.     }
  17.     // 连接服务器成功时的回调函数
  18.     void setConnectionCallback(ConnectionCallback cb)
  19.     { connectionCallback_ = std::move(cb); }
  20.     // 收到服务器发送的消息时的回调函数
  21.     void setMessageCallback(MessageCallback cb)
  22.     { messageCallback_ = std::move(cb); }
  23. private:
  24.     EventLoop* loop_;
  25.     ConnectionCallback connectionCallback_;
  26.     MessageCallback messageCallback_;
  27.     WriteCompleteCallback writeCompleteCallback_;
  28.     TcpConnectionPtr connection_ GUARDED_BY(mutex_);
  29. };
复制代码
TcpClient类中的接口和TcpServer类中的接口基本上是一样的,下面只先容与TcpServer差别的地方。
1.connect(); 用于毗连服务器(向服务器发起TCP毗连)


  • 2.disconnect(); 用于关闭毗连
  • 3.stop(); 制止客户端运行
  • 4.connection(); 获取客户端对应的通信毗连 Connection 对象的接口,通过该对象可以向服务器send数据
需要留意的是,由于 muduo 库不管是服务端还是客户端都是异步操作,对于客户端来说如果我们在毗连还没有完全建立成功的时候,想要调用connection()获取Connection对象,此时获取的就是一个空的Connection,如果再调用send就会直接崩溃。
为了办理这个问题,我们可以使用内置的 CountDownLatch 类举行同步控制
  1. class CountDownLatch : noncopyable
  2. {
  3. public:
  4.     explicit CountDownLatch(int count);
  5.     void wait(){
  6.         MutexLockGuard lock(mutex_);
  7.         while (count_ > 0){
  8.             condition_.wait();
  9.         }
  10.     }
  11.     void countDown(){
  12.         MutexLockGuard lock(mutex_);
  13.         --count_;
  14.         if (count_ == 0){
  15.             condition_.notifyAll();
  16.         }
  17.     }
  18.     int getCount() const;
  19. private:
  20.     mutable MutexLock mutex_;
  21.     Condition condition_ GUARDED_BY(mutex_);
  22.     int count_ GUARDED_BY(mutex_);
  23. };
复制代码
CountDownLatch类中包含两个函数,一个是wait,顾名思义就是调用这个接口时就会举行阻塞等待;另一个是countDown,调用这个函数时会唤醒阻塞。
所以正确的流程如下:

   使用Muduo库搭建客户端
  团体框架如下:
  1. #include <iostream>
  2. #include <functional>
  3. #include <unordered_map>
  4. #include "include/muduo/net/TcpClient.h"
  5. #include "include/muduo/net/EventLoopThread.h"
  6. #include "include/muduo/net/TcpConnection.h"
  7. #include "include/muduo/base/CountDownLatch.h"
  8. using namespace std;
  9. class TranslateClient
  10. {
  11. public:
  12.     TranslateClient(const std::string& ip, int port)
  13.         : _latch(1)
  14.         , _client(_baseloop.startLoop(), muduo::net::InetAddress(ip, port), "TcpClient")
  15.     { }
  16.     void connect();
  17.     void send(const std::string& str);
  18. private:
  19.     //连接建立成功时的回调函数,连接建立成功后,唤醒阻塞
  20.     void onConnect(const muduo::net::TcpConnectionPtr& conn);
  21.     void onMessage(const muduo::net::TcpConnectionPtr& conn, muduo::net::Buffer* buf,
  22.         muduo::Timestamp timestamp);
  23. private:
  24.     muduo::CountDownLatch _latch;
  25.     muduo::net::EventLoopThread _baseloop;
  26.     muduo::net::TcpClient _client;
  27.     muduo::net::TcpConnectionPtr _conn;
  28. };
  29. int main()
  30. {
  31.     TranslateClient client("127.0.0.1", 8080);
  32.     client.connect();
  33.     while (true)
  34.     {
  35.         string str;
  36.         cout << "请输入要翻译的单词:";
  37.         getline(cin, str);
  38.         if (str == "quit")
  39.             break;
  40.         client.send(str);
  41.         sleep(1);
  42.     }
  43.     return 0;
  44. }
复制代码
main函数中创建了一个TranslateClient对象,并绑定对应的IP和端口,然后毗连该IP和端口的服务器,然后会进入一个死循环,每次读取一个字符串,然后将该字符串发送给服务端。
和服务端一样,客户端的TranslateClient构造函数也需要绑定回调函数onConnection和onMessage。
留意客户端使用的是EventLoopThread而不是EventLoop,EventLoopThread 能更好地管理 EventLoop 的生命周期,包括启动、制止和资源清理。而直接使用 EventLoop,客户端代码要本身负责这些复杂操作,使用 EventLoopThread 可让客户端专注于业务逻辑。
实现细节:
  1. #include <iostream>
  2. #include <functional>
  3. #include <unordered_map>
  4. #include "include/muduo/net/TcpClient.h"
  5. #include "include/muduo/net/EventLoopThread.h"
  6. #include "include/muduo/net/TcpConnection.h"
  7. #include "include/muduo/base/CountDownLatch.h"
  8. using namespace std;
  9. class TranslateClient
  10. {
  11. public:
  12.     TranslateClient(const std::string& ip, int port)
  13.         : _latch(1)
  14.         , _client(_baseloop.startLoop(), muduo::net::InetAddress(ip, port), "TcpClient")
  15.     {
  16.         auto fun1 = bind(&TranslateClient::onConnect, this, placeholders::_1);
  17.         _client.setConnectionCallback(fun1);
  18.         auto fun2 = bind(&TranslateClient::onMessage, this, placeholders::_1, placeholders::_2, placeholders::_3);
  19.         _client.setMessageCallback(fun2);
  20.     }
  21.     void connect()
  22.     {
  23.         _client.connect();
  24.         _latch.wait(); //阻塞等待,直到连接建立成功
  25.     }
  26.     void send(const std::string& str)
  27.     {
  28.         if (_conn->connected())
  29.             _conn->send(str);
  30.     }
  31. private:
  32.     //连接建立成功时的回调函数,连接建立成功后,唤醒阻塞
  33.     void onConnect(const muduo::net::TcpConnectionPtr& conn)
  34.     {
  35.         if (conn->connected())
  36.         {
  37.             _latch.countDown(); //唤醒阻塞
  38.             _conn = conn;
  39.         }
  40.         else
  41.         {
  42.             std::cout << "连接断开!!" << endl;
  43.             _conn.reset();
  44.         }
  45.     }
  46.     void onMessage(const muduo::net::TcpConnectionPtr& conn, muduo::net::Buffer* buf,
  47.         muduo::Timestamp timestamp)
  48.     {
  49.         string res = buf->retrieveAllAsString();
  50.         std::cout << "翻译结果:" << res << endl;
  51.     }
  52. private:
  53.     muduo::CountDownLatch _latch;
  54.     muduo::net::EventLoopThread _baseloop;
  55.     muduo::net::TcpClient _client;
  56.     muduo::net::TcpConnectionPtr _conn;
  57. };
  58. int main()
  59. {
  60.     TranslateClient client("127.0.0.1", 8080);
  61.     client.connect();
  62.     while (true)
  63.     {
  64.         string str;
  65.         cout << "请输入要翻译的单词:";
  66.         getline(cin, str);
  67.         if (str == "quit")
  68.             break;
  69.         client.send(str);
  70.         sleep(1);
  71.     }
  72.     return 0;
  73. }
复制代码


  • 1.TranslateClient的构造函数:需要调用setConnectionCallback和setMessageCallback设置好对应的回调函数,即onConnection和onMessage函数,这两个函数的参数都必须符合特定的格式,才能作为setConnectionCallback和setMessageCallback的参数,而类的成员函数默认会携带一个隐藏的this指针,无法直接传递,需要依靠C++11中的包装器来完成。
  • 2.connect函数:会调用_client.connect()函数,该函数会向服务端发起毗连,但是这个操作是异步的,所以不能直接获取Connection对象,而是要确保毗连毗连成功之后才获取。所以这里会调用一个wait函数,比及onConnection函数被调用时,则阐明毗连建立成功。
  • 3.send函数:由于是异步的,毗连可能已经被关闭了,这种情况下不能发送数据,需要特判。
  • 4.onConnection函数:当毗连建立成功后,会唤醒阻塞,此时再获取的肯定是非空的Connection。
  • 5.onMessage函数:对收到的服务器响应直接打印。
   运行结果:
  

通过muduo库,我们就能快速搭建一个TCP通信模型,这比我们本身手写一个要快很多,并且性能也要更好。

5.2.1 基于muduo库函数实现protobuf协议的通信

在上面我们使用muduo库实现了一个简单的翻译服务器和客户端,但是这个应用中还存在一些问题:我们没有制定协议去办理Tcp粘包问题。
   前面的应用中客户端给服务器发送哀求中,哀求中只包含哀求信息的字符串,但是这种方式是不太好的,由于TCP会存在粘包问题(两次哀求的数据粘到一起,无法将他们分开),所以我们需要制定合理的协议并加上protobuf来实现真正的网络通讯模型。
  正好muduo库中也包含了一些使用案例,其中一个就是使用protobuf+自定义协议的方式来办理TCP粘包问题的例子,我们一起来看一下陈硕大佬是怎样处理这个问题的。
在muduo-master/examples中有一个protobuf文件夹:

我们打开其中的codec,内容如下:

由于代码中包含较多回调函数,直接看代码非常复杂,这里就不直接先容代码了,而是将其中比力告急的接口简化成图描述他们之间的关系,等了解他们的关系之后再看代码就轻易很多了。
下面是项目中自定义的协议,一个完备的哀求包含下面几个部分:



  • 1.len:固定大小4个字节,表示除了len之外整个报文的长度。
  • 2.nameLen:表示typeName的长度。
  • 3.typeName:表示某种范例的名称。这个范例名称用于区分差别种类的消息、哀求或对象。
  • 4.protobufData:真正要发送给服务器的数据,通过protobuf举行序列化后的二进制字节流。
  • 5.checkSum:数据校验和,判断数据在传输过程中是否发生破坏大概篡改。
将项目代码简化成流程图,如下所示:



  • 在ProtobufDispatcher类中,会通过registerMessageCallback函数举行业务注册,将差别哀求对应的回调函数生存至关系映射表中。
  • ProtobufCodec中的onMessage会将缓冲区中的数据举行处理,读取到一个完备的protobufData数据,这一步实际上就是处理TCP粘包的步骤。
  • 在TcpClient(客户端类)中设置消息回调函数为ProtobufCodec中的onMessage,即每收到一个用户哀求后都会将其中的protobufData数据读取出来。
  • onMessage不仅仅会将缓冲区中的数据处理成protobuf结构对象,还会通过protobuf哀求,调用ProtobufDispatcher中的onProtobufMessage函数,他会帮我们根据差别的protobuf哀求调用差别的处理函数。
onMessage的定义如下:
  1. void ProtobufCodec::onMessage(const TcpConnectionPtr& conn,
  2.                               Buffer* buf,
  3.                               Timestamp receiveTime)
  4. {
  5.   while (buf->readableBytes() >= kMinMessageLen + kHeaderLen)
  6.   {
  7.     const int32_t len = buf->peekInt32();
  8.     if (len > kMaxMessageLen || len < kMinMessageLen)
  9.     {
  10.       errorCallback_(conn, buf, receiveTime, kInvalidLength);
  11.       break;
  12.     }
  13.     else if (buf->readableBytes() >= implicit_cast<size_t>(len + kHeaderLen))
  14.     {
  15.       ErrorCode errorCode = kNoError;
  16.       MessagePtr message = parse(buf->peek()+kHeaderLen, len, &errorCode);
  17.       if (errorCode == kNoError && message)
  18.       {
  19.         messageCallback_(conn, message, receiveTime);
  20.         buf->retrieve(kHeaderLen+len);
  21.       }
  22.       else
  23.       {
  24.         errorCallback_(conn, buf, receiveTime, errorCode);
  25.         break;
  26.       }
  27.     }
  28.     else
  29.     {
  30.       break;
  31.     }
  32.   }
  33. }
复制代码
其中的parse函数就会解析出一个完备的protoData数据,然后通过messageCallback函数调用对应的实行方法。
ProtobufDispatcher:
  1. class ProtobufDispatcher
  2. {
  3. public:
  4.   typedef std::function<void (const muduo::net::TcpConnectionPtr&,
  5.                                 const MessagePtr& message,
  6.                                 muduo::Timestamp)> ProtobufMessageCallback;
  7.   explicit ProtobufDispatcher(const ProtobufMessageCallback& defaultCb)
  8.     : defaultCallback_(defaultCb)
  9.   {
  10.   }
  11.   void onProtobufMessage(const muduo::net::TcpConnectionPtr& conn,
  12.                          const MessagePtr& message,
  13.                          muduo::Timestamp receiveTime) const
  14.   {
  15.     CallbackMap::const_iterator it = callbacks_.find(message->GetDescriptor());
  16.     if (it != callbacks_.end())
  17.     {
  18.       it->second->onMessage(conn, message, receiveTime);
  19.     }
  20.     else
  21.     {
  22.       defaultCallback_(conn, message, receiveTime);
  23.     }
  24.   }
  25.   template<typename T>
  26.   void registerMessageCallback(const typename CallbackT<T>::ProtobufMessageTCallback& callback)
  27.   {
  28.     std::shared_ptr<CallbackT<T> > pd(new CallbackT<T>(callback));
  29.     callbacks_[T::descriptor()] = pd;
  30.   }
  31. private:
  32.   typedef std::map<const google::protobuf::Descriptor*, std::shared_ptr<Callback> > CallbackMap;
  33.   CallbackMap callbacks_;
  34.   ProtobufMessageCallback defaultCallback_;
  35. };
复制代码
我们直接使用上面的protobuf协议方式,完成一个可以完成翻译和计算器的服务器+客户端项目。
   编写proto文件
  

编写好了之后通过指令生成对应的.pb.cc和.pb.h文件

   完成服务端代码
  1. #include <iostream>
  2. #include <functional>
  3. #include <memory>
  4. #include "request.pb.h"
  5. #include "muduo/proto/codec.h"
  6. #include "muduo/proto/dispatcher_lite.h"
  7. #include "muduo/proto/dispatcher.h"
  8. #include "muduo/net/EventLoop.h"
  9. #include "muduo/net/TcpServer.h"
  10. using namespace std;
  11. class ProtoServer
  12. {
  13.     typedef shared_ptr<request::TranslateRequest> TranslateRequestPtr;
  14.     typedef shared_ptr<request::TranslateResponse> TranslateResponsePtr;
  15.     typedef shared_ptr<request::CalculatorRequest> CalculatorRequestPtr;
  16.     typedef shared_ptr<request::CalculatorResponse> CalculatorResponsePtr;
  17. public:
  18.     ProtoServer(int port)
  19.             : _server(&_baseloop, muduo::net::InetAddress(port), "ProtoServer", muduo::net::TcpServer::kReusePort)
  20.             , _dispatcher(bind(&ProtoServer::onUnknownMessage, this, placeholders::_1, placeholders::_2, placeholders::_3))
  21.             , _codec(bind(&ProtobufDispatcher::onProtobufMessage, &_dispatcher, placeholders::_1, placeholders::_2, placeholders::_3))
  22.     {
  23.         //注册业务处理函数
  24.         _dispatcher.registerMessageCallback<request::TranslateRequest>(std::bind(&ProtoServer::onTranslate, this,
  25.             placeholders::_1, placeholders::_2, placeholders::_3));
  26.         _dispatcher.registerMessageCallback<request::CalculatorRequest>(std::bind(&ProtoServer::onCalculator, this,
  27.             placeholders::_1, placeholders::_2, placeholders::_3));
  28.         //设置回调函数
  29.         _server.setConnectionCallback(bind(&ProtoServer::onConnection, this, placeholders::_1));
  30.         _server.setMessageCallback(bind(&ProtobufCodec::onMessage, &_codec, placeholders::_1, placeholders::_2, placeholders::_3));
  31.     }
  32.     void start()
  33.     {
  34.         _server.start();
  35.         _baseloop.loop();
  36.     }
  37.    
  38. private:
  39.     string translate(const string& word)
  40.     {
  41.         static unordered_map<string, string> dict = {
  42.             {"sun", "太阳"},
  43.             {"left", "左"},
  44.             {"right", "右"},
  45.             {"hello", "你好"}
  46.         };
  47.         
  48.         auto it = dict.find(word);
  49.         if (it != dict.end())
  50.             return it->second;
  51.         else  
  52.             return "未找到";
  53.     }
  54.     void onTranslate(const muduo::net::TcpConnectionPtr& conn, const TranslateRequestPtr& req, muduo::Timestamp rt)
  55.     {
  56.         //读取请求字符串
  57.         string word = req->word();
  58.         //将请求字符串进行翻译
  59.         string tranStr = translate(word);
  60.         //构建TranslateResponse响应
  61.         request::TranslateResponse resp;
  62.         resp.set_result(tranStr);
  63.         //发送响应
  64.         _codec.send(conn, resp);
  65.     }
  66.     void onCalculator(const muduo::net::TcpConnectionPtr& conn, const CalculatorRequestPtr& req, muduo::Timestamp rt)
  67.     {
  68.         int num1 = req->num1();
  69.         int num2 = req->num2();
  70.         char op = req->op()[0];
  71.         request::CalculatorResponse resp;
  72.         switch(op)
  73.         {
  74.             case '+':
  75.                 resp.set_result(num1 + num2);
  76.                 resp.set_code(true);
  77.                 break;
  78.             case '-':
  79.                 resp.set_result(num1 - num2);
  80.                 resp.set_code(true);
  81.                 break;
  82.             case '*':
  83.                 resp.set_result(num1 * num2);
  84.                 resp.set_code(true);
  85.                 break;
  86.             case '/':
  87.                 if (num2 == 0)
  88.                 {
  89.                     resp.set_code(false);
  90.                 }
  91.                 else
  92.                 {
  93.                     resp.set_result(num1 / num2);
  94.                     resp.set_code(true);
  95.                 }
  96.                 break;                                
  97.         }
  98.         _codec.send(conn, resp);
  99.     }
  100.     void onConnection(const muduo::net::TcpConnectionPtr& conn)
  101.     {
  102.         if (conn->connected())
  103.         {
  104.             cout << "连接成功!!!" << endl;
  105.         }
  106.         else
  107.         {
  108.             cout << "断开连接" << endl;
  109.         }
  110.     }
  111.     void onUnknownMessage(const muduo::net::TcpConnectionPtr& conn, const MessagePtr& message, muduo::Timestamp)
  112.     {
  113.         std::cout << "onUnknownMessage: " << message->GetTypeName() << std::endl;
  114.     }
  115.    
  116. private:
  117.     muduo::net::EventLoop _baseloop;
  118.     muduo::net::TcpServer _server;
  119.     ProtobufDispatcher _dispatcher;
  120.     ProtobufCodec _codec;
  121. };
  122. int main()
  123. {
  124.     ProtoServer server(8080);
  125.     server.start();
  126.     return 0;
  127. }
复制代码
构造函数内容如下:

留意事项:


  • 成员变量相对于没有协议之前的版本,新增了一个ProtobufDispatcher(事件分配器)和一个ProtobufCodec(协议处理器)

    • ProtobufDispatcher的作用是将用户的哀求事件分配给差别的回调函数,根据差别的哀求实行差别的业务。
    • ProtobufCodec用于协议处理,他能从缓冲区中的字符流中读取到一个完备的ProtobufData数据,然后将其反序列化为Protobuf结构化对象(哀求的protobuf);也可以将Protobuf结构化对象(响应的protobuf)序列化成ProtobufData,然后封装成报文发送给客户端。

  • _dispatcher在注册事件时,在模板参数中需要填写指定的哀求范例,当服务端收到对应的哀求范例时,就会调用对应的回调函数。
  • _dispatcher绑定的回调函数需要留意,其第二个参数是用智能指针(shard_ptr)的方式。
  • _在服务端给客户端发送响应时不能直接调用conn->send(str),由于此时直接发送就就是字节流,没有使用protobuf对应的response和应用层定制协议。客户端会无法识别。所以应该交给_codec处理,他会将结构化对象举行序列化并封装成完备报文再发送给对端。
   完成客户端代码
  1. #include <iostream>
  2. #include <functional>
  3. #include <memory>
  4. #include "request.pb.h"
  5. #include "muduo/proto/codec.h"
  6. #include "muduo/proto/dispatcher_lite.h"
  7. #include "muduo/proto/dispatcher.h"
  8. #include "muduo/net/EventLoopThread.h"
  9. #include "muduo/net/TcpClient.h"
  10. #include "muduo/net/TcpConnection.h"
  11. #include "muduo/base/CountDownLatch.h"
  12. #include "muduo/base/Mutex.h"
  13. using namespace std;
  14. class ProtoClient
  15. {
  16. public:
  17.         typedef shared_ptr<google::protobuf::Message> MessagePtr;
  18.     typedef shared_ptr<request::TranslateRequest> TranslateRequestPtr;
  19.     typedef shared_ptr<request::TranslateResponse> TranslateResponsePtr;
  20.     typedef shared_ptr<request::CalculatorRequest> CalculatorRequestPtr;
  21.     typedef shared_ptr<request::CalculatorResponse> CalculatorResponsePtr;
  22.         ProtoClient(const std::string& ip, int port)
  23.                 : _latch(1)
  24.                 , _client(_loopthread.startLoop(), muduo::net::InetAddress(ip, port), "Client")
  25.                 , _dispatcher(bind(&ProtoClient::onUnknownMessage, this, placeholders::_1, placeholders::_2, placeholders::_3))
  26.                 , _codec(bind(&ProtobufDispatcher::onProtobufMessage, &_dispatcher, placeholders::_1, placeholders::_2, placeholders::_3))
  27.         {
  28.                 //注册业务回调函数
  29.                 _dispatcher.registerMessageCallback<request::TranslateResponse>(bind(&ProtoClient::translateResp, this, placeholders::_1, placeholders::_2, placeholders::_3));
  30.                 _dispatcher.registerMessageCallback<request::CalculatorResponse>(bind(&ProtoClient::calculatorResp, this, placeholders::_1, placeholders::_2, placeholders::_3));
  31.                 //注册连接以及消息回调
  32.                 _client.setConnectionCallback(std::bind(&ProtoClient::onConnection, this, placeholders::_1));
  33.                 _client.setMessageCallback(bind(&ProtobufCodec::onMessage, &_codec, placeholders::_1, placeholders::_2, placeholders::_3));
  34.         }
  35.         void connect()
  36.         {
  37.                 _client.connect();
  38.                 _latch.wait();
  39.         }
  40.         void translate()
  41.         {
  42.                 std::cout << "请输入你要翻译的单词:";
  43.                 string word;
  44.                 getline(cin, word);
  45.                 request::TranslateRequest req;
  46.                 req.set_word(word);
  47.                 send(req);
  48.         }
  49.         void calculator()
  50.         {
  51.                 std::cout << "请输入操作数1:";
  52.                 int num1 = 0;
  53.                 cin >> num1;
  54.                 getchar();
  55.                 std::cout << "请输入操作符:";
  56.                 string op;
  57.                 getline(cin, op);
  58.                 std::cout << "请输入操作数2:";
  59.                 int num2 = 0;
  60.                 cin >> num2;
  61.                 getchar();
  62.                 request::CalculatorRequest req;
  63.                 req.set_num1(num1);
  64.                 req.set_op(op);
  65.                 req.set_num2(num2);
  66.                 send(req);
  67.         }
  68. private:
  69.         void translateResp(const muduo::net::TcpConnectionPtr& conn, const TranslateResponsePtr& req, muduo::Timestamp rt)
  70.         {
  71.                 cout << "结果为:" << req->result() << endl;
  72.         }
  73.         void calculatorResp(const muduo::net::TcpConnectionPtr& conn, const CalculatorResponsePtr& req, muduo::Timestamp rt)
  74.         {
  75.                 if (req->code() == false)
  76.                 {
  77.                         cout << "发生错误" << endl;
  78.                 }
  79.                 else
  80.                 {
  81.                         cout << "结果为:" << req->result() << endl;
  82.                 }
  83.         }
  84.         //多态
  85.         void send(const google::protobuf::Message& msg)
  86.         {
  87.                 if (_conn->connected())
  88.                         _codec.send(_conn, msg);
  89.         }
  90.     void onConnection(const muduo::net::TcpConnectionPtr& conn)
  91.     {
  92.         if (conn->connected())
  93.         {
  94.             cout << "连接成功!!!" << endl;
  95.                         _latch.countDown();
  96.                         _conn = conn;
  97.         }
  98.         else
  99.         {
  100.             cout << "断开连接" << endl;
  101.                         _conn.reset();
  102.         }
  103.     }
  104.     void onUnknownMessage(const muduo::net::TcpConnectionPtr& conn, const MessagePtr& message, muduo::Timestamp)
  105.     {
  106.         std::cout << "onUnknownMessage: " << message->GetTypeName() << std::endl;
  107.                 conn->shutdown();
  108.     }
  109. private:
  110.         muduo::CountDownLatch _latch; //实现同步
  111.         muduo::net::EventLoopThread _loopthread; //异步循环处理线程
  112.         muduo::net::TcpConnectionPtr _conn; //客户端与服务器的连接
  113.         muduo::net::TcpClient _client;    //客户端
  114.         ProtobufDispatcher _dispatcher; //请求分发器
  115.         ProtobufCodec _codec; //协议处理器
  116. };
  117. void menu()
  118. {
  119.         cout << "**********************" << endl;
  120.         cout << "*     1.translate    *" << endl;
  121.         cout << "*     2.calculator   *" << endl;
  122.         cout << "*     0.exit         *" << endl;
  123.         cout << "**********************" << endl;
  124. }
  125. int main()
  126. {
  127.         ProtoClient client("127.0.0.1", 8080);
  128.         client.connect();
  129.         int choose = 1;
  130.         while (choose)
  131.         {
  132.                 menu();
  133.                 cout << "请选择:";
  134.                 cin >> choose;
  135.                 getchar();
  136.                 switch (choose)
  137.                 {
  138.                 case 1:
  139.                         client.translate();
  140.                         break;
  141.                 case 2:
  142.                         client.calculator();
  143.                         break;
  144.                 case 0:
  145.                         break;
  146.                 default:
  147.                         cout << "选择失败,请重新选择" << endl;
  148.                         break;
  149.                 }
  150.         }
  151.         return 0;
  152. }
复制代码
留意:
客户端与服务端的编写比力雷同,差别的地方在于服务端使用的是EventLoop,而客户端使用的是EventLoopThread,并且由于客户端是异步的,不能保证发送毗连哀求之后毗连就建立成功了,而是比及onConnection函数被调用之后才以为毗连建立成功了,所以调用connect()发起毗连之后,需要等待,比及onConnection被调用才允许向服务端发送哀求。
   编写makefile
  1. all:server client
  2. server:protobuf_server.cc request.pb.cc ../../../..third/muduo-master/examples/protobuf/codec/codec.cc
  3.         g++ -o $@ $^ -std=c++11 -I../../../../include -L../../../../lib -lmuduo_net -lmuduo_base -lprotobuf -lpthread -lz
  4. client:protobuf_client.cc request.pb.cc ../../../../third/muduo-master/examples/protobuf/codec/codec.cc
  5.         g++ -o $@ $^ -std=c++11 -I../../../../include -L../../../../lib -lmuduo_net -lmuduo_base -lprotobuf -lpthread -lz
  6. .PHONY:clean
  7. clean:
  8.         rm -rf server client
复制代码
  运行结果
  先启动服务器,然后运行客户端

客户端毗连成功后会打印一个菜单。
再试一下对应的服务:


如果发生除0错误,直接设置错误码,制止服务器计算结果造成崩溃:

   总结
  上面就是基于muuduo库实现protobuf协议通信的简单小demo,反面我们的rabbitmq也是基于上面那一套模型,所以上面的内容肯定要理解清楚,知道每一句代码是什么意思,有什么作用。

5.3 SQLite3

   什么是 SQLite
  SQLite 是一个进程内的轻量级数据库,它实现了自给自足的、无服务器的、零设置的、事件性的 SQL 数据库引擎。它是一个零设置的数据库,这意味着与其他数据库不一样,我们不需要在系统中设置。像其他数据库, SQLite 引擎不是一个独立的进程,可以按应用程序需求举行静态或动态毗连, SQLite 直接访问其存储文件。
   为什么要用 SQLite
  

  • 不需要一个单独的服务器进程或操作的系统(无服务器的)
  • SQLite 不需要设置
  • 一个完备的 SQLite 数据库是存储在一个单一的跨平台的磁盘文件
  • SQLite 是非常小的,是轻量级的,完全设置时小于 400KiB,省略可选功能设置时小于 250KiB
  • SQLite 是自给自足的,这意味着不需要任何外部的依赖
  • SQLite 事件是完全兼容 ACID 的,允许从多个进程或线程安全访问
  • SQLite 支持 SQL92(SQL2)标准的大多数查询语言的功能
  • SQLite 使用 ANSI-C 编写的,并提供了简单和易于使用的 API
  • SQLite 可在 UNIX(Linux, Mac OS-X, Android, iOS)和 Windows(Win32, WinCE, WinRT)中运行
   SQLite3 C/C++ API 先容
  C/C++ API 是 SQLite3 数据库的一个客户端, 提供一种用 C/C++操作数据库的方法。
下面我们先容一下常见的几个接口:
SQLite3 官方文档: List Of SQLite Functions
1.查看当前数据库在编译阶段是否启动了线程安全
  1. int sqlite3_threadsafe(); 0-未启用; 1-启用
复制代码
需要留意的是 sqlite3 是有三种安全等级的:


  • 1. 非线程安全模式
  • 2. 线程安全模式(差别的毗连在差别的线程/进程间是安全的,即一个句柄不能用于多线程间)
  • 3. 串行化模式(可以在差别的线程/进程间使用同一个句柄)
2.创建/打开数据库文件,并返回操作句柄
  1. int sqlite3_open(const char *filename, sqlite3 **ppDb)
  2. //成功返回SQLITE_OK
  3. //若在编译阶段启动了线程安全,则在程序运行阶段可以通过参数选择线程安全等级
  4. int sqlite3_open_v2(const char *filename, sqlite3 **ppDb, int flags, const char *zVfs );
  5. //成功返回SQLITE_OK
复制代码
其中flag有以下几个选项:


  • SQLITE_OPEN_READWRITE -- 以可读可写方式打开数据库文件
  • SQLITE_OPEN_CREATE -- 不存在数据库文件则创建
  • SQLITE_OPEN_NOMUTEX--多线程模式,只要差别的线程使用差别的毗连即可保证线程安全
  • SQLITE_OPEN_FULLMUTEX--串行化模式
3.实行语句
  1. int sqlite3_exec(sqlite3*, char *sql, int (*callback)(void*,int,char**,char**), void* arg, char **err)
  2. //返回: SQLITE_OK 表示成功
复制代码
我们的sql语句可能会举行查询操作,我们需要对查询到的结果举行处理,所以需要用到回调函数callbck,他的各种参数含义如下:int (*callback)(void*,int,char**,char**)。


  • void* : 是设置的在回调时传入的 arg 参数
  • int:一行中数据的列数
  • char**:存储一行数据的字符指针数组(一个回调处理一行数据,如果有多行则会循环调用回调函数)
  • char**:每一列的字段名称
这个回调函数有个 int 返回值,成功处理的情况下必须返回 0,返回非 0会触发 ABORT 退出程序。
4.销毁句柄
  1. int sqlite3_close(sqlite3* db); //成功返回 SQLITE_OK
  2. int sqlite3_close_v2(sqlite3*); //推荐使用--无论如何都会返回SQLITE_OK
复制代码
5.获取错误信息
  1. const char *sqlite3_errmsg(sqlite3* db);
复制代码
  封装SQLite3操作类
  下面我们将这几个接口封装成一个类,快速上手这几个接口。
  1. #include <iostream>
  2. #include <string>
  3. #include <vector>
  4. #include <sqlite3.h>
  5. class SqliteHelper
  6. {
  7.     typedef int (*sqliteCallback)(void*, int, char**, char**);
  8. public:
  9.     SqliteHelper(const std::string& dbfile)
  10.         : _dbfile(dbfile)
  11.         , _handler(nullptr)
  12.     {}
  13.     bool open(int flag = SQLITE_OPEN_FULLMUTEX) //默认为串行化
  14.     {
  15.         //不存在则创建 | 以可读可写方式
  16.         int ret = sqlite3_open_v2(_dbfile.c_str(), &_handler, SQLITE_OPEN_CREATE | SQLITE_OPEN_READWRITE  | flag, nullptr);
  17.         if (ret != SQLITE_OK)
  18.         {
  19.             std::cout << "创建/打开数据库失败: ";
  20.             std::cout << sqlite3_errmsg(_handler) << std::endl;
  21.             return false;
  22.         }
  23.         return true;
  24.     }
  25.     bool exec(const std::string& sql, sqliteCallback cb, void* arg)
  26.     {
  27.         int ret = sqlite3_exec(_handler, sql.c_str(), cb, arg, nullptr);
  28.         if (ret != SQLITE_OK)
  29.         {
  30.             std::cout << "执行语句失败: ";
  31.             std::cout << sqlite3_errmsg(_handler) << std::endl;
  32.             return false;
  33.         }
  34.         return true;
  35.     }
  36.     void close()
  37.     {
  38.         if (_handler)
  39.             sqlite3_close_v2(_handler);
  40.     }
  41. private:
  42.     std::string _dbfile;
  43.     sqlite3* _handler;
  44. };
复制代码
团体代码都是比力简单的,只要明白了每个函数参数的意思,一个一个往里面填即可。
   测试代码
  上面我们完成了对sqlite3函数的封装,这里我们对刚刚完成的代码举行测试。
我们先测试一下新增功能:
  1. #include <iostream>
  2. #include "sqlite.hpp"
  3. int main()
  4. {
  5.     //创建库文件
  6.     SqliteHelper helper("./test.db");
  7.     helper.open();
  8.     //1.创建/打开表 (学生信息表:编号, 姓名,年龄)
  9.     const char* ct = "create table if not exists student(id int primary key, name varchar(32), age int);";
  10.     helper.exec(ct, nullptr, nullptr);  //创建表不需要回调函数
  11.     //2.增删改查
  12.     const char* insert_sql1 = "insert into student values(1, '张三', 18);";
  13.     const char* insert_sql2 = "insert into student values(2, '李四', 20);";
  14.     const char* insert_sql3 = "insert into student values(3, '王五', 32);";
  15.     helper.exec(insert_sql1, nullptr, nullptr);
  16.     helper.exec(insert_sql2, nullptr, nullptr);
  17.     helper.exec(insert_sql3, nullptr, nullptr);
  18.     //3.关闭数据库
  19.     helper.close();
  20.     return 0;
  21. }
复制代码
上面的代码很简单:插入3条语句,我们将程序举行编译后运行。

运行没有报错,还生成了一个test.db,这个就是我们刚刚创建的数据库(sqlite3中一个库对应一个文件)。
我们使用sqlite3命令打开该文件。

查看该库下的表所使用的命令与MySQL差别,MySQL的命令是show tables,而这里是.tables。

现在我们使用select命令就能查询到刚刚插入的数据了。

接下来我们测试一下删除功能。
  1. #include <iostream>
  2. #include "sqlite.hpp"
  3. int main()
  4. {
  5.     //创建库文件
  6.     SqliteHelper helper("./test.db");
  7.     helper.open();
  8.     //1.创建/打开表 (学生信息表:编号, 姓名,年龄)
  9.     const char* ct = "create table if not exists student(id int primary key, name varchar(32), age int);";
  10.     helper.exec(ct, nullptr, nullptr);  //创建表不需要回调函数
  11.     //2.增删改查
  12.     const char* update_sql = "delete from student where id = 2";
  13.     helper.exec(update_sql, nullptr, nullptr);
  14.     //3.关闭数据库
  15.     helper.close();
  16.     return 0;
  17. }
复制代码
运行之后,查看数据库,果然id为2的学生信息被删除了。

每次都要去数据库中查看结果非常贫苦,接下来我们使用代码来查询数据库中的结果。
  1. #include <iostream>
  2. #include "sqlite.hpp"
  3. int select_stu_callback(void* arg, int col_count, char** result, char** fields_name)
  4. {
  5.     //result表示的是某一行的数据
  6.     for (int i = 0; i < col_count; i++)
  7.     {
  8.         std::cout << result[i] << " ";
  9.     }
  10.     std::cout << std::endl;
  11.     return 0;  //非常重要,否则会发生错误
  12. }
  13. int main()
  14. {
  15.     //创建库文件
  16.     SqliteHelper helper("./test.db");
  17.     helper.open();
  18.     //1.创建/打开表 (学生信息表:编号, 姓名,年龄)
  19.     const char* ct = "create table if not exists student(id int primary key, name varchar(32), age int);";
  20.     helper.exec(ct, nullptr, nullptr);  //创建表不需要回调函数
  21.     //2.增删改查
  22.     // const char* insert_sql1 = "insert into student values(1, '张三', 18);";
  23.     // const char* insert_sql2 = "insert into student values(2, '李四', 20);";
  24.     // const char* insert_sql3 = "insert into student values(3, '王五', 32);";
  25.     // helper.exec(insert_sql1, nullptr, nullptr);
  26.     // helper.exec(insert_sql2, nullptr, nullptr);
  27.     // helper.exec(insert_sql3, nullptr, nullptr);
  28.     // const char* update_sql = "delete from student where id = 2";
  29.     // helper.exec(update_sql, nullptr, nullptr);
  30.     const char* select_sql = "select * from student";
  31.     helper.exec(select_sql, select_stu_callback, nullptr);
  32.     //3.关闭数据库
  33.     helper.close();
  34.     return 0;
  35. }
复制代码
运行结果:


5.4 GTest

GTest 是一个跨平台的 C++单元测试框架,由 google 公司发布。 gtest 是为了在差别平台上为编写 C++单元测试而生成的。它提供了丰富的断言、致命和非致命判断、参数化等等.
   GTest 使用
  使用分为两个方向:


  • 1.简单的宏断言
  • 2.事件机制(全局,单独用例)
   宏断言
  TEST 宏
  1. TEST(test_case_name, test_name)
  2. TEST_F(test_fixture,test_name)
复制代码


  • TEST:主要用来创建一个简单测试, 它定义了一个测试函数, 在这个函数中可以使用任何 C++代码并且使用框架提供的断言举行查抄
  • TEST_F:主要用来举行多样测试,适用于多个测试场景如果需要相同的数据设置的情况, 即相同的数据测差别的举动
断言
GTest 中的断言的宏可以分为两类:


  • ASSERT_系列:如果当前点检测失败则退出当前函数
  • EXPECT_系列:如果当前点检测失败则继承往下实行
留意:断言宏,必须在单元测试宏函数中使用。
下面是经常使用的断言先容
  1. // bool 值检查
  2. ASSERT_TRUE(参数),期待结果是 true
  3. ASSERT_FALSE(参数),期待结果是 false
  4. //数值型数据检查
  5. ASSERT_EQ(参数 1,参数 2),传入的是需要比较的两个数 equal
  6. ASSERT_NE(参数 1,参数 2), not equal,不等于才返回 true
  7. ASSERT_LT(参数 1,参数 2), less than,小于才返回 true
  8. ASSERT_GT(参数 1,参数 2), greater than,大于才返回 true
  9. ASSERT_LE(参数 1,参数 2), less equal,小于等于才返回 true
  10. ASSERT_GE(参数 1,参数 2), greater equal,大于等于才返回 true
复制代码
下面我们做个测试, 使用 TEST 宏及断言,断言age大于18
  1. #include <iostream>
  2. #include <gtest/gtest.h>
  3. //test为单元测试名
  4. //greate_than为单元测试下的一个测试用例的名称
  5. TEST(test, greate_than)
  6. {
  7.     int age = 20;
  8.     ASSERT_GT(age, 18);
  9.     printf("OK!\n");
  10. }
  11. int main(int argc, char* argv[])
  12. {
  13.     testing::InitGoogleTest(&argc, argv);
  14.     RUN_ALL_TESTS();  //运行所有的单元测试
  15.     return 0;
  16. }
复制代码
留意:ASSERT_GT肯定要放在宏函数中,放在main函数大概其他函数内部会报错。
运行结果:

上面的断言是age大于18,如果修改成小于18会出现什么结果(将上面的ASSERT_GT换成ASSERT_LT)

可以看到在断言失败之后,OK并没有被打印,这就是ASSERT_系列(如果当前点检测失败则退出当前函数),如果我们将其修改成EXPECT系列呢。
  1. #include <iostream>
  2. #include <gtest/gtest.h>
  3. //test为单元测试名
  4. //greate_than为单元测试下的一个测试用例的名称
  5. TEST(test, less_than)
  6. {
  7.     int age = 20;
  8.     EXPECT_LT(age, 18);
  9.     printf("OK!\n");
  10. }
  11. int main(int argc, char* argv[])
  12. {
  13.     testing::InitGoogleTest(&argc, argv);
  14.     RUN_ALL_TESTS();  //运行所有的单元测试
  15.     return 0;
  16. }
复制代码
运行结果:

固然断言失败了,但是没有直接退出函数,而是继承实行打印出了OK。
如果想要测试两个用例,则取差别测试用例名称即可
  1. #include <iostream>
  2. #include <gtest/gtest.h>
  3. //test为单元测试名
  4. //greate_than为单元测试下的一个测试用例的名称
  5. TEST(test, less_than)
  6. {
  7.     int age = 20;
  8.     EXPECT_LT(age, 18);
  9.     printf("OK!\n");
  10. }
  11. TEST(test, greater_than)
  12. {
  13.     int age = 20;
  14.     EXPECT_GT(age, 18);
  15.     printf("OK!\n");
  16. }
  17. int main(int argc, char* argv[])
  18. {
  19.     testing::InitGoogleTest(&argc, argv);
  20.     RUN_ALL_TESTS();  //运行所有的单元测试
  21.     return 0;
  22. }
复制代码
结果如下:



在学习完断言宏之后,你可能会以为没有什么用,这个断言宏还没有C语言中的assert好用,由于assert可以在任意位置使用,而断言宏只能在单元测试宏函数中使用。
其实GTest中真正有效的是事件机制。
   事件机制
  GTest 中的事件机制是指在测试前和测试后提供给用户自行添加操作的机制,而且该机制也可以让同一测试套件下的测试用例共享数据。 GTest 框架中事件的结构层次:



  • 测试程序:一个测试程序只有一个 main 函数,也可以说是一个可实行程序是一个测试程序。该级别的事件机制是在程序的开始和结束实行
  • 测试套件:代表一个测试用例的集合体,该级别的事件机制是在团体的测试案例开始和结束实行(可以理解为一个测试情况,可以在单元测试之前举行测试情况初始化,测试完毕之后举行情况清理。
  • 测试用例:该级别的事件机制是在每个测试用例开始和结束都实行
事件机制的最大利益就是能够为我们各个测试用例提前准备好测试情况,并在测试完毕后用于销毁情况,如许有个利益就是如果我们有一段代码需要举行多种差别方法的测试,则可以通过测试机制在每个测试用例举行之前初始化测试情况和数据,并在测试完毕后清理测试造成的影响。
   测试套件分为两类:
  

  • 1.全局测试套件:在团体的测试中,只会初始化一次情况,在全部测试用例完毕后,才会清理情况。
  • 2.用例测试套件:在每次的单元测试中,都会重新初始化测试情况,完毕后清理情况。
  GTest 提供了两种常见的的事件:
   

  • 全局事件:针对整个测试程序。实现全局的事件机制,需要创建一个本身的类,然后继承 testing::Environment 类,然后分别实现成员函数 SetUp 和 TearDown,同时在 main 函数内举行调用 testing::AddGlobalTestEnvironment(new MyEnvironment);函数添加全局的事件机制。
  全局测试套件,其实就是我们用户本身,定义一个全局测试情况类。
  1. #include <iostream>
  2. #include <gtest/gtest.h>
  3. //全局事件:针对整个测试程序,提供全局事件机制,能够在测试之前配置测试环境数据,测试完毕后清理数据
  4. //先定义环境类,通过继承 testing::Environment 的派生类来完成
  5. class MyEnvironment : public testing::Environment
  6. {
  7. public:
  8.     virtual void SetUp() override //重写的虚函数接口 SetUp 会在测试之前被调用
  9.     {
  10.         std::cout << "单元测试执行前的环境初始化!" << std::endl;
  11.     }
  12.     virtual void  TearDown() override //TearDown 会在测试完毕后调用.
  13.     {
  14.         std::cout << "单元测试执行后的环境清理!" << std::endl;
  15.     }
  16. };
  17. TEST(MyEnvironment, test1)
  18. {
  19.     std::cout << "单元测试1" << std::endl;
  20. }
  21. TEST(MyEnvironment, test2)
  22. {
  23.     std::cout << "单元测试2" << std::endl;
  24. }
  25. int main(int argc, char* argv[])
  26. {
  27.     testing::InitGoogleTest(&argc, argv);
  28.     testing::AddGlobalTestEnvironment(new MyEnvironment);
  29.     RUN_ALL_TESTS();
  30.     return 0;
  31. }
复制代码

运行结果:

实行顺序如图所示:

其实SetUp函数雷同于C++中的构造函数,TearDown雷同于析构函数。
全局测试套件的最大利益就是初始化测试情况以及测试完毕之后对测试情况举行清理。


   

  • TestSuite 事件:针对一个个测试套件。测试套件的事件机制我们同样需要去创建一个类,继承自 testing::Test,实现两个静态函数 SetUpTestCase 和TearDownTestCase,测试套件的事件机制不需要像全局事件机制一样在 main 注册,而是需要将我们寻常使用的 TEST 宏改为 TEST_F 宏。
  

  • SetUpTestCase() 函数是在测试套件第一个测试用例开始前实行
  • TearDownTestCase() 函数是在测试套件最后一个测试用例结束后实行
  • 需要留意 TEST_F 的第一个参数是我们创建的类名,也就是当前测试套件的名称,如许在 TEST_F 宏的测试套件中就可以访问类中的成员了。
情况测试类中,可以定义成员变量,成员变量是独立的,是与当前测试套件相干的单元测试才能访问。
模板如下所示:
  1. class HashTestEnv : public testing::Test //不再像全局那样,继承Environment
  2. {
  3. public:
  4.     static void SetUpTestCase() { } //在所有单元测试前执行,初始化测试环境
  5.     static void TearDownTestCase() { } //在所有单元测试后执行,清理测试环境
  6. public:
  7.     //成员变量
  8.     //注意:成员变量必须是公有的。
  9. };
  10. //单元测试宏,变成了TEST_F
  11. //注意:测试的命名,必须与套件环境类名一致(为了能直接访问类成员变量)
  12. TEST_F(HashTestEnv, test1)
  13. {
  14. }
复制代码
我们现在根据这个模板来编写一下代码。
  1. #include <iostream>
  2. #include <gtest/gtest.h>
  3. #include <unordered_map>
  4. class MyTest : public testing::Test
  5. {
  6. public:
  7.     static void SetUpTestCase()
  8.     {
  9.         std::cout << "所有单元测试前执行,初始化总环境" << std::endl;
  10.     }
  11.     static void TearDownTestCase()
  12.     {
  13.         std::cout << "所有单元测试完毕后执行,清理总环境" << std::endl;
  14.     }
  15. public:
  16.     std::unordered_map<std::string, std::string> _mymap;
  17. };
  18. TEST_F(MyTest, insert_test)
  19. {
  20.     _mymap.insert({"hello", "你好"});
  21.     _mymap.insert({"bye", "再见"});
  22. }
  23. TEST_F(MyTest, size_test)
  24. {
  25.     ASSERT_EQ(_mymap.size(), 2);
  26. }
  27. int main(int argc, char* argv[])
  28. {
  29.     testing::InitGoogleTest(&argc, argv);
  30.     RUN_ALL_TESTS();
  31.     return 0;
  32. }
复制代码
运行结果:

   在insert_test单元测试中明显已经向_mymap中插入了两个数据,为什么在size_test中举行宏断言时却说_mymap的大小为0?
  每个单元测试中的成员变量都是独立的,每一次都会重新初始化。
   如果我们将这个成员变量设置为全局呢?
  

运行结果:

现在两个单元测试使用的就是同一个map了,所以在insert_test中插入了两个新数据,在size_test中调用size得到的大小不再是0,而是2了。
   如果想将map设置为成员变量,怎样完成添加数据
  我们需要创建独立测试,我们之前创建的SetUpTestCase和TearDownTestCase都是静态的,他们用于团体情况的初始化和清理,而非静态的SetUp和TearDownTest是针对每一个单元测试举行初始化和清理。
  1. #include <iostream>
  2. #include <gtest/gtest.h>
  3. #include <unordered_map>
  4. class MyTest : public testing::Test
  5. {
  6. public:
  7.     static void SetUpTestCase()
  8.     {
  9.         std::cout << "所有单元测试前执行,初始化总环境" << std::endl;
  10.     }
  11.     void SetUp() override
  12.     {
  13.         std::cout << "单元测试初始化" << std::endl;
  14.         _mymap.insert({"hello", "你好"});
  15.         _mymap.insert({"bye", "再见"});
  16.     }
  17.     static void TearDownTestCase()
  18.     {
  19.         std::cout << "所有单元测试完毕后执行,清理总环境" << std::endl;
  20.     }
  21.     void TearDown()
  22.     {
  23.         std::cout << "单元测试清理" << std::endl;
  24.     }
  25. public:
  26.     std::unordered_map<std::string, std::string> _mymap;
  27. };
  28. TEST_F(MyTest, insert_test)
  29. {
  30.     _mymap.insert({"yes", "是的"});
  31.     ASSERT_EQ(_mymap.size(), 3);
  32. }
  33. TEST_F(MyTest, size_test)
  34. {
  35.     ASSERT_EQ(_mymap.size(), 2);
  36. }
  37. int main(int argc, char* argv[])
  38. {
  39.     testing::InitGoogleTest(&argc, argv);
  40.     RUN_ALL_TESTS();
  41.     return 0;
  42. }
复制代码
运行结果:


所以SetUpTestCase可以初始化设置为全部单元测试共有的数据,而SetUp可以插入每个单元测试所需的独立的测试数据。

5.5 C++11 异步操作实现线程池

   先容
  std::future 是 C++11 标准库中的一个模板类,它表示一个异步操作的结果。当我们在多线程编程中使用异步使命时, std::future 可以资助我们在需要的时候获取使命的实行结果。 std::future 的一个告急特性是能够阻塞当火线程,直到异步操作完成,从而确保我们在获取结果时不会遇到未完成的操作。
   应用场景
  

  • 异步使命: 当我们需要在后台实行一些耗时操作时,如网络哀求或计算麋集型使命等, std::future 可以用来表示这些异步使命的结果。通过将使命与主线程分离,我们可以实现使命的并行处理,从而进步程序的实行服从
  • 并发控制: 在多线程编程中,我们可能需要等待某些使命完成后才能继承实行其他操作。通过使用 std::future,我们可以实现线程之间的同步,确保使命完成后再获取结果并继承实行后续操作
  • 结果获取: std::future 提供了一种安全的方式来获取异步使命的结果。我们可以使用 std::future::get()函数来获取使命的结果,此函数会阻塞当火线程,直到异步操作完成。如许,在调用 get()函数时,我们可以确保已经获取到了所需的结果
   用法示例
  5.5.1 使用 std::async 关联异步使命

std::async 是一种将使命与 std::future 关联的简单方法。它创建并运行一个异步使命,并返回一个与该使命结果关联的 std::future 对象。默认情况下, std::async 是否启动一个新线程,大概在等待 future 时,使命是否同步运行都取决于你给的参数。这个参数为 std::launch 范例:


  • std::launch::deferred 表明该函数会被延迟调用,直到在 future 上调用 get()大概 wait()才会开始实使用命
  • std::launch::async 表明函数会在本身创建的线程上运行
  • std::launch::deferred | std::launch::async 内部通过系统等条件主动选择策略
   std::launch::deferred演示代码:
  1. #include <iostream>
  2. #include <thread>
  3. #include <future>
  4. int Add(int num1, int num2)
  5. {
  6.     std::cout << "加法" << std::endl;
  7.     return num1 + num2;
  8. }
  9. int main()
  10. {
  11.     std::cout << "111" << std::endl;
  12.     std::future<int> result = std::async(std::launch::deferred, Add, 2, 3);
  13.     std::cout << "222" << std::endl;
  14.     int sum = result.get();
  15.     std::cout << "333" << std::endl;
  16.     std::cout << sum << std::endl;
  17.     return 0;
  18. }
复制代码
在上图中,我们创建了一个简单的函数:Add,然后我们使用async举行异步关联,此时Add函数并不会被调用,直到future范例的sum调用了get之后才会被调用。
运行结果:

可以看到打印加法并不在111和222之间,进一步阐明白Add函数并不是在async关联时被调用,而是在调用get之后才被调用的。
   std::launch::async演示代码:
  async模式下会在内部创建工作线程,异步的完成使命。
  1. #include <iostream>
  2. #include <thread>
  3. #include <future>
  4. int Add(int num1, int num2)
  5. {
  6.     std::cout << "加法" << std::endl;
  7.     return num1 + num2;
  8. }
  9. int main()
  10. {
  11.     std::cout << "111" << std::endl;
  12.     std::future<int> result = std::async(std::launch::async, Add, 2, 3);
  13.     std::this_thread::sleep_for(std::chrono::seconds(1));
  14.     std::cout << "222" << std::endl;
  15.     int sum = result.get();
  16.     std::cout << "333" << std::endl;
  17.     std::cout << sum << std::endl;
  18.     return 0;
  19. }
复制代码
为了防止主线程走的太快,我们让主线程制止一秒等待异步线程实行完毕。

与前面差别的是,在使用async关联异步后,Add函数就会被调用,所以加法的打印是在111和222之间的,此时的get直接获取刚刚调用的结果,不会再次调用Add函数了。
我们再次修改代码,在Add函数中也添一个sleep。
  1. #include <iostream>
  2. #include <thread>
  3. #include <future>
  4. int Add(int num1, int num2)
  5. {
  6.     std::cout << "加法 111" << std::endl;
  7.     std::this_thread::sleep_for(std::chrono::seconds(5));
  8.     std::cout << "加法 222" << std::endl;
  9.     return num1 + num2;
  10. }
  11. int main()
  12. {
  13.     std::cout << "111" << std::endl;
  14.     std::future<int> result = std::async(std::launch::async, Add, 2, 3);
  15.     std::this_thread::sleep_for(std::chrono::seconds(1));
  16.     std::cout << "222" << std::endl;
  17.     int sum = result.get();
  18.     std::cout << "333" << std::endl;
  19.     std::cout << sum << std::endl;
  20.     return 0;
  21. }
复制代码
运行结果:

在调用async函数时会创建一个工作线程去实行Add函数,并休眠5秒钟,主线程休眠一秒后会向下实行,直到遇到get函数,但是此时的get还没有获取到结果(工作线程还没实行完),所以主线程会阻塞在get函数等待工作线程实行完毕。


5.5.2 使用 std::promise 和 std::future 配合

std::promise 提供了一种设置值的方式,它可以在设置之后通过相干联的 std::future 对象举行读取。换种说法就是之前说过 std::future 可以读取一个异步函数的返回值了, 但是要等待就绪,而 std::promise 就提供一种方式手动让 std::future 就绪(通过在线程中对promise对象设置数据,其他线程通过future获取设置数据的方式实现获取异步实行结果)。
简单来说其作用是:它用于在一个线程中存储一个值或非常,并在另一个线程中通过 future 来获取这个值或非常。
  1. #include <iostream>
  2. #include <thread>
  3. #include <future>
  4. int Add(int num1, int num2, std::promise<int>& prom)
  5. {
  6.     prom.set_value(num1 + num2);
  7.     return num1 + num2;
  8. }
  9. int main()
  10. {
  11.     std::promise<int> prom;
  12.     //通过std::promise的get_future()函数与fu绑定
  13.     std::future<int> fu = prom.get_future();
  14.     //将函数Add及对象prom放在线程里面执行
  15.     std::thread thr(Add, 10, 20, std::ref(prom));
  16.     int res = fu.get();
  17.     std::cout << "sum: " << res << std::endl;
  18.     thr.join();
  19.     return 0;
  20. }
复制代码
这段代码,首先创建了一个promise对象和一个future对象,并将两者举行绑定,随后通过thread线程调用Add函数,留意Add函数中需要传递promise对象进去,并且通过set_value函数生存num1+num2的计算结果结果。最后主线程就能通过通过与promise绑定的future对象,获取到结果。



5.5.3 使用 std::packaged_task 和 std::future 配合

std::packaged_task 就是将使命和 std::future 绑定在一起的模板,是一种对使命的封装。我们可以通过 std::packaged_task 对象获取使命相干联的 std::future 对象(通过调用 get_future()方法得到)。 std::packaged_task 的模板参数是函数签名。
可以把 std::future 和 std::async 看成是分开的, 而 std::packaged_task 则是一个团体。
  1. #include <iostream>
  2. #include <thread>
  3. #include <future>
  4. int Add(int num1, int num2)
  5. {
  6.     return num1 + num2;
  7. }
  8. int main()
  9. {
  10.     std::packaged_task<int(int, int)> task(Add);
  11.     std::future<int> fu = task.get_future();
  12.     //task可以看作是一个可调用对象来调用执行任务,如
  13.     task(11, 22);
  14.     //但是又不能完成当作一个函数来使用
  15.     //std::async(std::launch::async, task, 11, 22); //error
  16.     //std::thread(task, 11, 22); //error
  17.     int sum = fu.get();
  18.     std::cout << sum << std::endl;
  19. }
复制代码
通过packaged_task对Add函数举行二次封装得到task对象,task可以看作是一个可调用对象,通过task(11, 22)就能直接调用Add函数。但是他又不能完全看作是一个函数,比方下面的两种写法都是错误的。


  • std::async(std::launch::async, task, 11, 22); //error
  • std::thread(task, 11, 22); //error
我们更倾向于将task定义成一个指针,传递到线程中,通过解引用的方式实行目标函数。但是单纯的指针,存在生命周期的问题,可能会出现风险,所以我们可以在堆上new对象,并使用智能指针来管理。
  1. #include <iostream>
  2. #include <thread>
  3. #include <memory>
  4. #include <future>
  5. int Add(int num1, int num2)
  6. {
  7.     return num1 + num2;
  8. }
  9. int main()
  10. {
  11.     //std::packaged_task<int(int, int)> task(Add);
  12.     auto ptask = std::make_shared<std::packaged_task<int(int, int)>>(Add);
  13.     std::future<int> fu = ptask->get_future();
  14.     std::thread thr([ptask](){
  15.         (*ptask)(11, 22);
  16.     });
  17.     int sum = fu.get();
  18.     std::cout << sum << std::endl;
  19.     thr.join();
  20.     return 0;
  21. }
复制代码

5.5.4 实现线程池

基于线程池实使用命的时候,入口函数内部实行逻辑是固定的,因此选择std::packaged_task 加上 std::future 的组合来实现。
1.线程池的工作头脑:
用户传入要实行的函数,以及需要处理的数据(函数的参数),由线程池中的工作线程来实行函数完成使命
2.怎样实现:
   管理的成员:
  

  • 使命池:用 vector 维护的一个函数使命池子
  • 互斥锁 & 条件变量: 实现同步互斥
  • 肯定数目的工作线程:用于不断从使命池取出使命实使用命
  • 结束运行标志:以便于控制线程池的结束。
    管理的操作:
  

  • 入队使命:入队一个函数和参数
  • 制止运行:停止线程池
  线程池团体框架如下:
  1. #include <iostream>
  2. #include <functional>
  3. #include <memory>
  4. #include <thread>
  5. #include <future>
  6. #include <vector>
  7. using functor = std::function<void()>;
  8. class threadpool
  9. {
  10. public:
  11.     threadpool(int count = 1);
  12.     ~threadpool();
  13.     //push的参数:F为用户需要执行的函数,args是函数中的参数
  14.     //push内部,会将这个函数封装成一个异步任务,抛入线程池中,由工作线程取出并执行
  15.     template<typename F, typename ...Args>
  16.     auto push(F &&func, Args&& ...args) -> std::future<decltype(func(args...))>; //通过decltype推导出函数运行的返回值类型
  17.     void stop();
  18. private:
  19.     //线程入口函数——内部不断从任务池中取出任务执行。
  20.     void entry();
  21. private:
  22.     std::atomic_bool _stop;   //结束标志
  23.     std::mutex _mutex;   //互斥锁
  24.     std::condition_variable _cv;   //条件变量
  25.     std::vector<std::thread> _threads;  //线程池
  26.     std::vector<functor> _tasks;  //任务池
  27. };
复制代码


  • 值得留意的是上面的push函数,由于将来我们并不能确定用户传递进来的函数返回值,参数。所以我们要设置成模板+可变参数包。
  • push函数内部还会将运行结果返回给用户,但是差别的函数可能会有差别范例的返回值,我们需要使用auto和decltype来推导出函数结果对应的返回值范例,最终还要加上future,我们期望用户能使用future来获取异步实行的结果。
  • push函数会将用户传递的使命(函数+参数)封装成一个异步使命(package_task)并参加到使命池_tasks当中,线程池会指派一个线程实行该使命,并将实行的结果生存至future对象中,然后返回给用户。
代码如下:
  1. #include <iostream>
  2. #include <functional>
  3. #include <memory>
  4. #include <thread>
  5. #include <future>
  6. #include <vector>
  7. using functor = std::function<void()>;
  8. class threadpool
  9. {
  10. public:
  11.     threadpool(int count = 1)
  12.         : _stop(false)
  13.     {
  14.         for (int i = 0; i < count; i++)
  15.         {
  16.             _threads.emplace_back(&threadpool::entry, this);
  17.         }
  18.     }
  19.     ~threadpool()
  20.     {
  21.         stop();
  22.     }
  23.     //push的参数:F为用户需要执行的函数,args是函数中的参数
  24.     //push内部,会将这个函数封装成一个异步任务,抛入线程池中,由工作线程取出并执行
  25.     template<typename F, typename ...Args>
  26.     auto push(F &&func, Args&& ...args) -> std::future<decltype(func(args...))> //通过decltype推导出函数运行的返回值类型
  27.     {
  28.         using return_type = decltype(func(args...));
  29.         //1.将传入的函数封装成一个packaged_task任务
  30.         auto fun = std::bind(std::forward<F>(func), std::forward<Args>(args)...);
  31.         auto task = std::make_shared<std::packaged_task<return_type()>>(fun);
  32.         std::future<return_type> fu = task->get_future();
  33.         //2.构造一个lambda匿名对象(捕获任务对象)
  34.         {
  35.             std::unique_lock<std::mutex> lock(_mutex);
  36.             _tasks.push_back([task](){
  37.                 (*task)();
  38.             });
  39.             //3.将构造出来的匿名对象,抛入任务池中(线程池会指派一个线程去执行该线程)
  40.             _cv.notify_one();
  41.         }
  42.         return fu;
  43.     }
  44.     void stop()
  45.     {
  46.         if (_stop == false)
  47.         {
  48.             _stop = true;
  49.             _cv.notify_all(); //唤醒所有线程
  50.             for (auto& thread : _threads)
  51.             {
  52.                 thread.join();
  53.             }
  54.         }
  55.     }
  56. private:
  57.     //线程入口函数——内部不断从任务池中取出任务执行。
  58.     void entry()
  59.     {
  60.         while (_stop == false)
  61.         {
  62.             std::vector<functor> tmp_tasks;
  63.             {
  64.                 //加锁:等待任务池不为空,或者_stop被设置为true
  65.                 std::unique_lock<std::mutex> lock(_mutex);
  66.                 _cv.wait(lock, [&](){
  67.                     return _stop || !_tasks.empty();
  68.                 });
  69.                 tmp_tasks.swap(_tasks); //将任务队列中所有的任务取出放到临时任务池中
  70.             }
  71.             //取出任务执行
  72.             for (auto& task : tmp_tasks)
  73.                 task();
  74.         }
  75.     }
  76. private:
  77.     std::atomic_bool _stop;   //结束标志
  78.     std::mutex _mutex;   //互斥锁
  79.     std::condition_variable _cv;   //条件变量
  80.     std::vector<std::thread> _threads;  //线程池
  81.     std::vector<functor> _tasks;  //任务池
  82. };
复制代码


  • threadpool构造函数:用户传入一个count表示线程池预先创建的线程个数,_threads内部添加count个线程,每个线程都去实行entry函数。
  • push函数:用户传入一个函数以及函数对应的参数,在push函数内部会将函数以及参数封装成fun,再使用packaged_task和future对fun举行绑定。然后加锁,向使命池中添加使命,使命的内容就是实行task对应的函数,添加完毕之后唤醒一个线程去实行,最后将future返回给用户,用户能通过get获取运行结果。
  • stop函数:唤醒全部的线程,并且等待全部的线程。
  • entry函数:线程入口函数,是一个while循环,结束条件就是stop被设置为ture(即调用了stop),每个线程都会调用该函数,并被锁阻塞住,当获取到锁之后,会继承判断如果使命池不为空,就制止等待了,将tmp_tasks与_tasks举行交换,获取使命池中全部的线程,依次实行。
编写测试代码:
  1. int Add(int num1, int num2)
  2. {
  3.     return num1 + num2;
  4. }
  5. int main()
  6. {
  7.     threadpool pool(5);
  8.     for (int i = 0; i < 10; i++)
  9.     {
  10.         int rand1 = rand() % 100;
  11.         int rand2 = rand() % 100;
  12.         std::future<int> fu = pool.push(Add, rand1, rand2);
  13.         std::cout << rand1 << "+" << rand2 << "=" << fu.get() << std::endl;
  14.         sleep(1);
  15.     }
  16.     pool.stop();
  17.     return 0;
  18. }
复制代码
运行结果:


6.需求分析

6.1 核心概念

我们以前学习过生产者消费者模型,而我们要实现的消息队列就是生产者消费者模型,只不外生产者不再是同一主机上的进程了,而是一个客户端。



其中, Broker Server 是最核心的部分, 负责消息的存储和转发。
而在 AMQP(Advanced Message Queuing Protocol-高级消息队列协议,一个提供同一消息服务的应用层标准高级消息队列协议,为面向消息的中心件设计,使得服从该规范的客户端应用和消息中心件服务器的全功能互操作成为可能)模型中,也就是消息中心件服务器 Broker 中,又存在以下概念:


  • 虚拟机 (VirtualHost): 雷同于 MySQL 的 "database", 是一个逻辑上的集合。一个BrokerServer 上可以存在多个 VirtualHost
  • 交换机 (Exchange): 生产者把消息先发送到 Broker 的 Exchange 上,再根据差别的规则, 把消息转发给差别的 Queue
  • 队列 (Queue): 真正用来存储消息的部分, 每个消费者决定本身从哪个 Queue 上读取消息
  • 绑定 (Binding): Exchange 和 Queue 之间的关联关系, Exchange 和 Queue 可以理解成 "多对多" 关系,使用一个关联表就可以把这两个概念联系起来
  • 消息 (Message): 传递的内容
   那么怎样理解交换机和队列之间的关系呢?
  消费队列服务器中会存在很多的队列,如果说这是一个消息发布系统的消息队列,那么会存在音乐消息队列,体育消息队列,花边消息队列等。而音乐消息又可以分成歌曲消息和歌手消息。

当消息发布客户端想发布一条消息到消息队列服务器中时,需要把消息参加到对应的队列当中去,如果发布的是一个歌曲消息,那么这个消息不能只参加到歌曲队列当中,还要参加到音乐队列中,也就是说生产者和队列之间不是单对单的关系,而是多对多的。
所以我们使用交换机来帮我们维护生成者与队列之间的关系,在生产者与消费者之间添加一个交换机,并且交换机会绑定很多的队列。

生产者会将消息先发送给交换机,交换机根据匹配规则,将消息转发到差别的队列中去。比方,生产者发布了一个歌曲消息,交换机会将该消息转发到音乐消息队列和歌曲消息队列中。
总结:所谓的 Exchange 和 Queue 可以理解成 "多对多" 关系, 和数据库中的 "多对多" 一样. 意思是:一个 Exchange 可以绑定多个 Queue (可以向多个 Queue 中转发消息)一个 Queue 也可以被多个 Exchange 绑定 (一个 Queue 中的消息可以来自于多个Exchange)


留意:上述数据结构, 既需要在内存中存储, 也需要在硬盘中存储


  • 内存存储: 方便使用
  • 硬盘存储: 重启数据不丢失

6.2 核心API

对于 Broker 来说, 要实现以下核心 API,通过这些 API 来实现消息队列的基本功能


  • 1. 创建交换机 (exchangeDeclare)
  • 2. 销毁交换机 (exchangeDelete)
  • 3. 创建队列 (queueDeclare)
  • 4. 销毁队列 (queueDelete)
  • 5. 创建绑定 (queueBind)
  • 6. 清除绑定 (queueUnbind)
  • 7. 发布消息 (basicPublish)
  • 8. 订阅消息 (basicConsume)
  • 9. 确认消息 (basicAck)
  • 10. 取消订阅 (basicCancel)
另一方面, Producer 和 Consumer 则通过网络的方式, 远程调用这些 API, 实现生产者消费者模型
   关于 VirtualHost(虚拟机):对于 RabbitMQ 来说, VirtualHost 也是可以随意创建删除的此处咱们暂时不做这部分功能(实现起来也比力简单, 咱们的代码中会完成部分和虚拟主机相干的结构设计)
  
6.3 交换机范例

对于 RabbitMQ 来说, 主要支持四种交换机范例(交换机决定了一个消息应该放到哪个队列):


  • Direct: 生产者发送消息时, 直接指定被该交换机绑定的队列名
  • Fanout: 生产者发送的消息会被复制到该交换机的全部队列中
  • Topic: 绑定队列到交换机上时, 指定一个字符串为 bindingKey。发送消息指定一个字符串为 routingKey。当 routingKey 和 bindingKey 满意肯定的匹配条件的时候, 则把消息投递到指定队列
  • Header
其中 Header 这种方式比力复杂, 比力少见。常用的是前三种交换机范例,项目中也主要实现这三种
   这三种操作就像给 qq 群发红包
  

  • Direct 是发一个专属红包, 只有指定的人能领
  • Fanout 是使用了邪术, 发一个 10 块钱红包, 群里的每个人都能领 10 块钱
  • Topic 是发一个画图红包, 发 10 块钱红包, 同时出个题, 得画的像的人, 才能领.也是每个领到的人都能领 10 块钱
  
6.4 长期化

Exchange, Queue, Binding, Message 等数据都有长期化需求
当程序重启 / 主机重启, 保证上述内容不丢失。

6.5 网络通信

生产者和消费者都是客户端程序, Broker 则是作为服务器,通过网络举行通信。在网络通信的过程中, 客户端部分要提供对应的 api, 来实现对服务器的操作。


  • 1. 创建 Connection
  • 2. 关闭 Connection
  • 3. 创建 Channel
  • 4. 关闭 Channel
  • 5. 创建队列 (queueDeclare)
  • 6. 销毁队列 (queueDelete)
  • 7. 创建交换机 (exchangeDeclare)
  • 8. 销毁交换机 (exchangeDelete)
  • 9. 创建绑定 (queueBind)
  • 10. 清除绑定 (queueUnbind)
  • 11. 发布消息 (basicPublish)
  • 12. 订阅消息 (basicConsume)
  • 13. 确认消息 (basicAck)
  • 14. 取消订阅(basicCancel)
可以看到, 在 Broker 的基础上, 客户端还要增加 Connection 操作和 Channel 操作


  • Connection 对应一个 TCP 毗连
  • Channel 则是 Connection 中的逻辑通道
一个 Connection 中可以包含多个 Channel。 Channel 和 Channel 之间的数据是独立的,不会相互干扰。如许做主要是为了能够更好的复用 TCP 毗连, 达到长毗连的效果,制止频繁的创建关闭 TCP 毗连。
   Connection 可以理解成一根网线. Channel 则是网线里具体的线缆
  


6.6 消息应答

被消费的消息, 需要举行应答。应答模式分成两种:


  • 主动应答: 消费者只要消费了消息, 就算应答完毕了, Broker 直接删除这个消息
  • 手动应答: 消费者手动调用应答接口, Broker 收到应答哀求之后, 才真正删除这个消息
   手动应答的目的, 是为了保证消息确实被消费者处理成功了. 在一些对于数据可靠性要求高的场景, 比力常见
  
7.模块划分

7.1 服务端模块

7.1.1 长期化数据管理中央模块

在数据管理模块中管理交换机,队列,队列绑定,消息等部分数据数据。
7.1.1.1 交换机数据管理

1.要管理的数据:描述了一个交换机应该有什么数据


  • 1)交换机名称:唯一标识
  • 2)交换机范例:决定了消息的转发方式

    • 每个队列绑定中有个bingding_key,每条消息中有个routing_key
    • 1.直接交换:binding_key与routing_key相同,则将消息放入队列
    • 2.广播交换:将消息放入交换机绑定的全部队列中
    • 3.主题交换:routing_key与多个绑定队列的binding_key有个匹配规则,匹配成功则放入

  • 3)长期化标志:决定了当前交换机信息是否需要长期化存储
  • 4)删除标志:指的是关联了当前交换机的全部客户端都退出了,是否要主动删除交换机。
  • 5)其他参数:(暂未使用,方便扩展)

2.对交换机的管理操作:


  • 1)创建交换机:这里的创建本质上是声明的意思(有则OK,没有则创建)
  • 2)删除交换机:留意——每个交换机都会绑定一个或多个队列(意味着会有一个或多个绑定信息),因此删除交换机需要删除相干的绑定信息
  • 3)获取指定名称交换机。
  • 4)获取当前交换机数目

7.1.1.2 队列数据管理

1.要管理的数据:


  • 1)队列名称:唯一的标识
  • 2)长期化存储标志:决定了是否将队列信息长期化存储起来,决定了重启后这个队列是否存在。
  • 3)是否独占标志:独占指的是,只有当前客户端本身能够订阅队列消息,其他客户端无法订阅该队列的消息。
  • 4)主动删除标志:当订阅了当前队列的全部客户端都退出后,是否删除该队列。
  • 5)其他参数:(暂未使用,方便扩展)

2.提供的管理操作:


  • 1)创建队列
  • 2)删除队列
  • 3)获取指定队列信息
  • 4)获取队列数目
  • 5)获取全部队列名称:当系统重启后,需要重新加载数据和历史消息(消息以队列为单元存储在文件中),而加载消息需要知道队列名称,由于在存储消息时,存储文件以队列名称举行定名。
留意:如果一个队列的长期化标志为false,意味着重启后,队列就没了,也没有客户端能够订阅队列的消息,因此这个队列里的消息如果长期化存储了,是没有意义的,因此通常一个队列的长期化标志是false,那么它的消息也就不需要长期化。

7.1.1.3 绑定数据管理

队列绑定用于描述哪个队列和哪个交换机绑定到了一起。
1.管理的数据:


  • 1)交换机名称
  • 2)队列名称
  • 3)binding_key:绑定密钥——描述了交换机的主题交换和直接交换的消息发布匹配规则,由数字,字符,_ ,# 和 . 组成,比方(binding_key: news.music.#)

2.管理的操作:


  • 1)添加绑定
  • 2)清除绑定
  • 3)获取交换机相干的全部绑定信息:

    • 1.删除交换机的时候,删除相干的绑定信息
    • 2.当消息发布到交换机,交换机通过绑定信息将消息发布到指定队列

  • 4)获取队列相干的全部绑定信息:删除队列的时候,要删除相干的绑定信息
  • 5)获取绑定信息数目

7.1.1.4 消息数据管理

1.管理的数据


  • 1)ID:消息的唯一标识
  • 2)长期化标志:表示是否对消息举行长期化(还要取决于队列的长期化标志)
  • 3)routing_key:决定了当前消息要发布的队列(消息发布到交换机后,根据绑定队列的binding_key决定是否发布到指定队列)
  • 4)消息主体:消息内容
————以下是服务端为了管理所添加的信息————


  • 5)存储偏移量:消息以队列为单元存储在文件中,这个偏移量是当前消息相较于文件起始位置的偏移量
  • 6)消息长度:从偏移量位置取出指定长度的消息(办理粘包问题)
  • 7)是否有效标志:标识当前消息是否已被删除(当一个文件中,有效消息占据总消息比例不到50%,且数据量超过2000,则举行垃圾接纳,重新整理文件数据存储。当系统重启,也只需要重新加载有效消息)

2.消息的管理
管理方式:以队列为单元举行管理(消息的全部操作都是以队列为单元的)
管理数据:


  • 1)消息链表:生存全部的待推送消息
  • 2)待确认消息(hash):消息推送给客户端后,会等待客户端举行消息确认,收到确认后,才会真正删除消息
  • 3)长期化消息(hash):假设消息都会举行长期化存储,操作过程中会存在垃圾接纳操作,但是垃圾接纳会改变消息的存储位置,因此每次垃圾接纳后,都需要用新的位置,去更新长期化消息的信息。
  • 4)长期化的有效消息数目
  • 5)长期化的总的消息数目:决定了什么时候举行垃圾接纳
管理操作:


  • 1)向队列新增消息
  • 2)获取队首消息:获取消息后,就会将消息从待推送消息链表删除(不再是待发送消息,而是待确认消息)
  • 3)确认消息:从待确认消息中移除消息,并举行长期化数据的删除
  • 4)恢复队列历史消息:主要是在构造函数中举行(只有在重启时才会举行)
  • 5)垃圾接纳(消息长期化子模块完成):长期化文件中有效消息比例小于50%,且总消息数目超过2000举行垃圾接纳
  • 6)删除队列相干消息文件:当一个队列被删除了,则消息没有存在的意义了。
上面两个是内部管理单元,而下面是向外(客户端)提供的。
队列消息管理:


  • 1)初始化队列消息结构
  • 2)移除队列消息结构
  • 3)向队列新增消息
  • 4)对队列消息举行确认
  • 5)恢复队列历史消息

7.1.2 虚拟机管理模块

虚拟机其实就是交换机+队列+绑定+消息的团体逻辑单元,因此虚拟机管理其实就是将上面四个模块的归并管理。
1.要管理的数据:


  • 1)交换机数据管理句柄
  • 2)队列数据管理句柄
  • 3)绑定信息数据管理句柄
  • 4)消息数据管理句柄
2.要管理的操作:


  • 1)声明/删除交换机(留意:在删除交换机时需要删除相干的绑定信息)
  • 2)声明/删除队列(留意:在删除队列时,要删除相干的绑定信息以及消息数据)
  • 3)队列的绑定/清除绑定(留意:绑定的时候,交换机和队列必须是存在的)
  • 4)获取指定队列的消息
  • 5)对指定队列的指定消息举行确认
  • 6)获取交换机相干的全部绑定信息(一条消息要发布给指定交换机时,交换秘密获取全部的绑定信息,来确定消息要发布到哪个队列)


7.1.3 交换路由模块

消息的发布是将一条新消息发布到交换机上,由交换机决定放入哪些队列,而决定交给哪个队列,其中交换机范例起了很大作用(直接交换,广播交换,主题交换)
直接交换和广播交换头脑较为简单,而主题交换涉及到了一个规则匹配的流程,交换路由模块就是专门做匹配过程的。
   

  • 每个队列和交换机的绑定信息中,都有一个binding_key:这是队列发布的匹配规则(binding_key只能由数字、字母、_ 、. 、#、*构成,其中 # 和 * 是通配符,# 用于匹配0个或多个单词,* 用于匹配一个单词) 
  • 每条要发布的消息中,都有一个routing_key:是消息的发布规则(routing_key只能由数字、字母、_ 、. 构成)
  交换机的三种交换模式:

  • 广播:直接将消息发布给交换机的全部绑定队列
  • 直接:routing_key与binding_key完全同等则匹配成功
  • 主题:binding_key是匹配规则,routing_key是消息规则(比方binding_key是news.music.#,routing_key是news.music.pop,则两者可以匹配成功)
路由匹配模块没有要管理的数据,只有向外提供的路由匹配操作(提供判断routing_key与binding_key是否能够匹配成功的接口)

7.1.4 消费者管理模块

消费者指的是订阅了一个队列消息的客户端,一旦这个队列有了消息就会推送给这个客户端。
在核心API中有个订阅消息的服务(这里的订阅并不是订阅某条消息,而是订阅了某个队列的消息),当前主要实现了消息推送功能,因此一旦有了消息就要能找到消费者相干信息(消费者对应的信道)。
1.消费者信息:


  • 1)消费者标识:区分差别的消费者
  • 2)订阅队列名称:当前队列有消息就会推送给这个客户端,以及当客户端收到消息后,需要对指定队列的消息举行确认
  • 3)主动确认标志:

    • 主动确认——推送消息后,直接删除消息不需要额外确认
    • 手动确认——需要比及收到确认回复后再去删除

  • 4)消费处理回调函数指针:队列收到一条消息后,通过回调函数指针举行处理(该函数内部逻辑固定——向指定客户端推送消息)

2.消费者管理:
管理头脑:以队列为单元举行管理(每个消费者订阅的都是指定队列的消息,消费者对消息举行确认也是以队列举行确认,更关键的是:当指定队列中有消息了,必然是向订阅了这个队列的消费者举行消息推送)。
消费者管理结构:
数据信息:消费者链表——生存当前队列的全部消费者信息(RR轮转,每次取出下一个消费者举行消息推送)
(留意:一条消息在推送时,并不会发送给全部订阅该队列的客户端,而是只需要其中一个客户端发布即可,所以消费者信息接纳链表存储,每次发布信息时从链表中依次选取消费者,可以达到负载均衡的效果)
管理操作:


  • 1)向指定队列新增消费者
  • 2)RR轮转获取指定队列消费者
  • 3)删除指定队列消费者
  • 4)获取指定队列消费者数目
  • 5)判断指定队列中消费者数目是否为空
  • 6)初始化队列消费者结构
  • 7)删除队列消费者结构

7.1.5 信道管理模块

网络通信时必然都是通过网络通信毗连来完成,为了能够更加充分的使用资源,因此对通信毗连又举行了进一步的细化,细化出了通信信道。
一个通信毗连可以创建多个通信通道,每个通信信道之间,在用户眼中是相互独立的,而本质的底层它们使用的是同一个通信毗连举行网络通信,一旦某个客户端要关闭通信,关闭的不是毗连,而是本身对应的通信通道,关闭信道我们就需要将客户端的订阅给取消。
信道是用户眼中的一个通信通道,所以全部的网络通佩服务都是由信道提供的。
信道提供的服务操作:


  • 1)声明 / 删除交换机
  • 2)声明 / 删除队列
  • 3)绑定 / 解绑定队列与交换机
  • 4)发布消息 / 队列消息确认
  • 5)订阅队列消息 /  取消队列订阅
信道要管理的数据:


  • 1)信道ID:信道的唯一标识
  • 2)信道关联的虚拟机句柄
  • 3)信道关联的消费者句柄:当信道关闭时,全部关联的消费者订阅都要取消,相当于删除全部的相干消费者。
  • 4)工作线程池句柄:信道举行消息发布到指定队列操作后,从指定队列中获取一个消费者,对这条消息举行消费(也就是将消息推送给客户端的操作交给线程池实行)。
留意:并非每个信道都有一个线程池,而是整个服务器就一个线程池,全部的信道都是通过同一个线程池举行异步操作。
信道的管理:


  • 1)创建一个信道
  • 2)关闭一个信道
  • 3)获取指定信道句柄

7.1.6 毗连受理模块

就是一个网络通信对应的毗连,因此当一个毗连要关闭时,就应该把毗连关联的信道全部关闭。
   

  • 在网络通信模块中,我们使用muduo库来实现底层通信,muduo库中本身就有Connection毗连的概念和对象类。但是在我们的毗连中,还有一个上层通信信道的概念,这个概念在muduo库中是没有的。
  • 因此我们需要在用户层面,对这个muduo库中的Connection毗连举行二次封装,形成我们本身所需的毗连受理。
  管理数据:


  • 1)muduo库的通信毗连
  • 2)当前毗连关联的通信管理句柄
毗连提供的操作:


  • 1)创建信道
  • 2)关闭信道
管理的操作:


  • 1)新增毗连
  • 2)关闭毗连
  • 3)获取指定毗连信息

7.1.7 Broker 服务器模块

整合以上全部模块,并搭建网络通佩服务器,实现与客户端网络通信,能够识别客户端哀求,并提供客户端哀求的处理服务。
管理信息:


  • 1)虚拟机管理模块句柄
  • 2)消费者管理模块句柄
  • 3)毗连受理模块句柄
  • 4)工作线程池句柄
  • 5)muduo 库通信所需元素
留意:


  • 1)一个服务器有一个工作线程池,其他全部的信道操作都是同一个线程池
  • 2)一个服务器有一个虚拟机,其他全部交换机,队列,消息的操作都是针对这个虚拟机举行的




7.2 客户端模块

7.2.1 消费者管理 

当订阅客户端订阅一个队列消息时,就相当于创建了一个消费者。
管理的数据:


  • 1)消费者标识
  • 2)订阅的队列名称
  • 3)主动确认标志
  • 4)消息回调处理函数指针
当当前消费者订阅了一个队列的消息,这个队列有了消息之后,就会将这个消息推送给客户端,这时候收到了消息则使用消息回调函数举行处理,处理完毕后根据确认标志决定是否举行消息确认。
管理的操作:


  • 1)新增消费者
  • 2)删除消费者
  • 3)查找消费者

7.2.2 信道管理模块

全部提供的操作与服务端雷同,由于客户端给用户提供什么服务,服务器就要给客户端提供什么活动。 
管理信息:


  • 1)信道ID
  • 2)消费者管理句柄:每个信道都有本身相干的消费者
  • 3)线程池句柄:对推送过来的消息举行回调处理,处理过程通过工作线程来举行
  • 4)信道关联的毗连
信道提供的服务:


  • 1)声明 / 删除交换机
  • 2)声明 / 删除队列
  • 3)绑定 / 解绑定队列与交换机
  • 4)发布消息 / 队列消息确认
  • 5)订阅队列消息 /  取消队列订阅
  • 6)创建 / 关闭信道
信道的管理:


  • 1)新增一个信道
  • 2)删除一个信道
  • 3)查找指定ID的信道

7.2.3 毗连受理模块

全部的服务都是通过信道来完成的(而不是毗连),信道在用户的角度就是一个通信通道,因此全部的哀求都是通过信道来完成的,毗连的管理就包含了客户端资源的整合。
面对用户,不需要有客户端的概念,毗连对于用户来说就是客户端,通过毗连创建信道,通过信道完成所需服务。
管理操作:


  • 1)毗连服务器
  • 2)创建信道
  • 3)关闭信道
  • 4)关闭毗连
管理的资源:


  • 1)工作线程池
  • 2)毗连关联的信道管理句柄

7.2.4 异步工作池模块

muduo库中的TcpClient只有通信毗连,没有事件监控,它不知道什么时候有消息到来,所以TcpClient模块需要一个EventLoopThread模块举行IO事件监控。
当收到推送消息后,需要对推送的消息举行处理,因此需要一个线程池来帮我们完成消息处理的过程。
留意:全部的毗连用的都是一个EventLoopThread举行IO事件监控,全部的推送消息处理也只需要有一个线程池就够了,并不需要每个毗连都有一个EventLoop,也不需要每个信道的消息处理都有本身的线程池。

7.3 项目模块关系图



8. 服务端核心模块实现

8.1 项目目录结构

Linux 机器上创建 mq 项目, 并且规划开发目录, 使用 Makefile 构造项目。
  1. root@hcss-ecs-918d:~/work/rabbitmq# tree rabbitmq/
  2. rabbitmq/
  3. |-- demo
  4. |-- mqclient
  5. |-- mqcommon
  6. |-- mqserver
  7. |-- mqtest
  8. |-- third
复制代码


  • demo:编写一些功能用例时地点的目录(前面第三方库先容时所写代码都放在该目录下)
  • mqcommon: 公共模块代码(线程池,数据库访问,文件访问,日志打印, pb 相干,以及其他的一些噜苏功能模块代码)
  • mqclient: 客户端模块代码
  • mqserver: 服务器模块代码
  • mqtest: 单元测试
  • third: 用到的第三方库存放目录
在创建完目录结构后,我们需要将muduo库中的include和lib移动到third目录下。

良好的目录结构可以资助我们更好的查找代码,项目团体更加清楚明白。

8.2 工具类模块实现

在项目开始前,我们需要实现一些工具模块,有了这些工具,可以更好的帮我们实现整个项目,正所谓磨刀不误砍柴工,接下来让我们一起实现吧。
8.2.1 日志打印工具

为了便于编写项目中能够快速定位程序的错误位置,因此编写一个日志打印类,举行简单的日志打印。
   目标:封装一个日志宏,通过日志宏举行日志打印,在打印的信息中带有系统时间以及文件名和行号。
  1.文件名和行号可以通过下面两个宏来实现


  • __FILE__:表现文件名
  • __LINE__:表现实行代码地点行的行号。

2.表现当前时间可以通过strftime函数实现

其中tm是当前时间的结构体,format是以什么格式来转换,s是生存转换完后的字符串。
tm结构体内容如下所示。

而调用localtime函数可以帮我们生成一个tm结构体

3.代码演示:
  1. #include <iostream>
  2. #include <ctime>
  3. int main()
  4. {
  5.     time_t t = time(nullptr);
  6.     struct tm* ptm = localtime(&t);
  7.     char time_str[32];
  8.     strftime(time_str, 31, "%Y-%m-%d %H:%M:%S", ptm);
  9.     printf("[%s][%s:%d] Hello World!\n", time_str, __FILE__, __LINE__);
  10.     return 0;
  11. }
复制代码
实行结果:

接下来我们需要将上面的代码封装成宏。
  1. #include <iostream>
  2. #include <ctime>
  3. #define DBG_LEVEL 0
  4. #define INF_LEVEL 1
  5. #define ERR_LEVEL 2
  6. #define DEFAULT_LEVEL DBG_LEVEL //默认日志等级,控制哪些日志能输出,哪些不能
  7. #define LOG(level, format, ...) {\
  8.     if (level >= DEFAULT_LEVEL) {\
  9.         time_t t = time(nullptr);\
  10.         struct tm* ptm = localtime(&t);\
  11.         char time_str[32];\
  12.         strftime(time_str, 31, "%Y-%m-%d %H:%M:%S", ptm);\
  13.         printf("[%s][%s:%d]" format "\n", time_str, __FILE__, __LINE__, ##__VA_ARGS__);\
  14.     }\
  15. }
  16. int main()
  17. {
  18.     LOG(DBG_LEVEL, "Hello %s--%d", "World", 5);
  19.     return 0;
  20. }
复制代码
留意:


  • 宏必须写在同一行,所以宏函数的每一行最后都需要添加 \ 举行转义
  • LOG宏函数的第三个参数是不定参,需要使用__VA_ARGS__表示
  • 如果format是单纯的字符串,没有不定参,这种情况下会报错,办理方法就是在__VA_ARGS__宏前面添加两个#。
我们还可以给每个等级额外添加一个宏函数,并且在日志中打印出日志等级。
  1. #include <iostream>
  2. #include <unordered_map>
  3. #include <ctime>
  4. #define DBG_LEVEL 0
  5. #define INF_LEVEL 1
  6. #define ERR_LEVEL 2
  7. #define DEFAULT_LEVEL DBG_LEVEL //默认日志等级,控制哪些日志能输出,哪些不能
  8. std::unordered_map<int, std::string> hash_level = {
  9.     {DBG_LEVEL, "Debug"},
  10.     {INF_LEVEL, "Info "},
  11.     {ERR_LEVEL, "Error"}
  12. };
  13. #define LOG(level, format, ...) {\
  14.     if (level >= DEFAULT_LEVEL) {\
  15.         time_t t = time(nullptr);\
  16.         struct tm* ptm = localtime(&t);\
  17.         char time_str[32];\
  18.         strftime(time_str, 31, "%Y-%m-%d %H:%M:%S", ptm);\
  19.         printf("[%s][%s][%s:%d]   " format "\n", bitmq::hash_level[level].c_str(), time_str, __FILE__, __LINE__, ##__VA_ARGS__);\
  20.     }\
  21. }
  22. #define DLOG(format, ...) LOG(DBG_LEVEL, format, ##__VA_ARGS__);
  23. #define ILOG(format, ...) LOG(INF_LEVEL, format, ##__VA_ARGS__);
  24. #define ELOG(format, ...) LOG(ERR_LEVEL, format, ##__VA_ARGS__);
  25. int main()
  26. {
  27.     LOG(ERR_LEVEL, "Hello %s--%d", "World", 5);
  28.     DLOG("Hello %s--%d", "World", 5);
  29.     ILOG("Hello %s--%d", "World", 5);
  30.     ELOG("Hello %s--%d", "World", 5);
  31.     return 0;
  32. }
复制代码
实行结果:

测试完毕后,代码没有问题,我们可以将宏函数放到mqcommon文件夹下。

8.2.2 使用Helper工具

Helper 工具类中要完成的是项目中需要的一些辅助零碎的功能代码实现,其中包括文件的基础操作,字符串的额外操作等在项目中用到的零碎功能。
8.2.2.1 sqlite基础操作类

sqlite类在认识第三方库章节已经实现过了,所以我们直接将之前的代码复制回来即可,但是需要留意的是,我们之前打印错误信息使用的是cout,而现在我们已经实现了本身的日志打印,所以我们使用本身写的LOG宏函数来完成日志打印工作。
  1. #include <iostream>
  2. #include <string>
  3. #include <vector>
  4. #include <sqlite3.h>
  5. #include "logger.hpp"
  6. namespace cola
  7. {
  8. class SqliteHelper
  9. {
  10.     typedef int (*sqliteCallback)(void*, int, char**, char**);
  11. public:
  12.     SqliteHelper(const std::string& dbfile)
  13.         : _dbfile(dbfile)
  14.         , _handler(nullptr)
  15.     {}
  16.     bool open(int flag = SQLITE_OPEN_FULLMUTEX) //默认为串行化
  17.     {
  18.         //不存在则创建 | 以可读可写方式
  19.         int ret = sqlite3_open_v2(_dbfile.c_str(), &_handler, SQLITE_OPEN_CREATE | SQLITE_OPEN_READWRITE  | flag, nullptr);
  20.         if (ret != SQLITE_OK)
  21.         {
  22.             ELOG("创建/打开sqlite数据库失败: %s", sqlite3_errmsg(_handler));
  23.             return false;
  24.         }
  25.         return true;
  26.     }
  27.     bool exec(const std::string& sql, sqliteCallback cb, void* arg)
  28.     {
  29.         int ret = sqlite3_exec(_handler, sql.c_str(), cb, arg, nullptr);
  30.         if (ret != SQLITE_OK)
  31.         {
  32.             ELOG("%s 执行语句失败: %s",sql.c_str(), sqlite3_errmsg(_handler));
  33.             return false;
  34.         }
  35.         return true;
  36.     }
  37.     void close()
  38.     {
  39.         if (_handler)
  40.             sqlite3_close_v2(_handler);
  41.     }
  42. private:
  43.     std::string _dbfile;
  44.     sqlite3* _handler;
  45. };
  46. }
复制代码

8.2.2.2 字符串操作类

在这个类我们需要实现字符串分割功能,给定一个str,以sep为分隔符,将str举行分割分割后的结果放入res数组当中。
  1. #include <iostream>
  2. #include <vector>
  3. class StringHelper
  4. {
  5. public:
  6.     static size_t splite(const std::string& str, const std::string& sep,
  7.             std::vector<std::string>& res)
  8.     {
  9.         int index = 0, pos = 0;
  10.         while (index < str.size())
  11.         {
  12.             pos = str.find(sep, index);
  13.             if (pos == std::string::npos)
  14.             {
  15.                 res.push_back(str.substr(index));
  16.                 break;
  17.             }
  18.             if (index != pos)
  19.             {
  20.                 res.push_back(str.substr(index, pos - index));
  21.             }
  22.             index = pos + sep.size();
  23.         }
  24.         return res.size();
  25.     }
  26. };
  27. int main()
  28. {
  29.     std::string str = "...news....music...#.pop...";
  30.     std::vector<std::string> array;
  31.     StringHelper::splite(str, ".", array);
  32.     for (auto& str : array)
  33.     {
  34.         std::cout << str << std::endl;
  35.     }
  36.     return 0;
  37. }
复制代码
运行结果:


8.2.2.3 UUID 生成器类

UUID(Universally Unique Identifier), 也叫通用唯一识别码,通常由 32 位 16 进制数字字符组成。
UUID 的标准型式包含 32 个 16 进制数字字符,以连字号分为五段,情势为 8-4-4-4-12的 32 个字符,如: 550e8400-e29b-41d4-a716-446655440000。
   uuid 生成头脑:
  

  • 1.生成8个0~255之间的随机数
  • 2.取出一个8字节的序号
  通过以上数据,组成16字节的数据,转换成32个16进制字符。
  我们生成随机数的方法是通过一个机器随机数作为生成伪随机数的种子。 (不能直接使用机器随机数来生成,由于机器随机数服从较低)


  • 生成机器随机数可使用std::random_device
  • 伪随机数生成使用std::mt19937_64
  1. #include <iostream>
  2. #include <random>
  3. int main()
  4. {
  5.     std::random_device rd;
  6.     std::mt19937_64 gernator(rd());
  7.     //限制数字区间
  8.     std::uniform_int_distribution<int> distribution(0, 255);
  9.     std::cout << distribution(gernator) << std::endl;
  10.     return 0;
  11. }
复制代码

接下来我们需要将十进制转换成16进制
  1. int main()
  2. {
  3.     std::random_device rd;
  4.     std::mt19937_64 gernator(rd());
  5.     //限制数字区间
  6.     std::uniform_int_distribution<int> distribution(0, 255);
  7.     auto randNum = distribution(gernator);
  8.     std::cout << randNum << "  ->  ";
  9.     //将生成的数字转换为16进制数字字符
  10.     std::stringstream ss;
  11.     ss << std::setw(2) << std::setfill('0') << std::hex << randNum;
  12.     std::cout << ss.str() << std::endl;
  13.     return 0;
  14. }
复制代码
可以通过std::hex,但是如果随机数是小于16,则需要在前面补0,所以我们使用setw限定位数为2位,使用setfill填充0。

现在我们可以直接生成8个随机数,并转化成16进制。
  1. int main()
  2. {
  3.     std::random_device rd;
  4.     std::mt19937_64 gernator(rd());
  5.     //限制数字区间
  6.     std::uniform_int_distribution<int> distribution(0, 255);
  7.     //将生成的数字转换为16进制数字字符
  8.     std::stringstream ss;
  9.     for (int i = 0; i < 8; i++)
  10.     {
  11.         ss << std::setw(2) << std::setfill('0') << std::hex << distribution(gernator);
  12.         if (i == 3 || i == 5 || i == 7)
  13.             ss << "-";
  14.     }
  15.     std::cout << ss.str() << std::endl;
  16.     return 0;
  17. }
复制代码

不要忘记uuid的格式(8-4-4-4-12),需要在对应位置添加 '-'。
现在已经办理了第一步了,唯一性已经比力强了,接下来我们还要给uuid添加编号,初始值为1,每次创建都会增加编号值,所以编号的范例必须为static。
  1. int main()
  2. {
  3.     std::random_device rd;
  4.     std::mt19937_64 gernator(rd());
  5.     //限制数字区间
  6.     std::uniform_int_distribution<int> distribution(0, 255);
  7.     //将生成的数字转换为16进制数字字符
  8.     std::stringstream ss;
  9.     for (int i = 0; i < 8; i++)
  10.     {
  11.         ss << std::setw(2) << std::setfill('0') << std::hex << distribution(gernator);
  12.         if (i == 3 || i == 5 || i == 7)
  13.             ss << "-";
  14.     }
  15.     //定义一个原子类型整形,初始值为1
  16.     static std::atomic<size_t> seq(1);
  17.     size_t num = seq.fetch_add(1);
  18.     for (int i = 7; i >= 0; i--)
  19.     {
  20.         ss << std::setw(2) << std::setfill('0') << std::hex << ((num >> (i * 8)) & 0xff);
  21.         if (i == 6)
  22.             ss << "-";
  23.     }
  24.     std::cout << ss.str() << std::endl;
  25.     return 0;
  26. }
复制代码

到这里,uuid的生成就完成了,接下来我们需要对其举行封装。
  1. class UUIDHelper
  2. {
  3. public:
  4.     static std::string uuid()
  5.     {
  6.         std::random_device rd;
  7.         std::mt19937_64 gernator(rd());
  8.         //限制数字区间
  9.         std::uniform_int_distribution<int> distribution(0, 255);
  10.         //将生成的数字转换为16进制数字字符
  11.         std::stringstream ss;
  12.         for (int i = 0; i < 8; i++)
  13.         {
  14.             ss << std::setw(2) << std::setfill('0') << std::hex << distribution(gernator);
  15.             if (i == 3 || i == 5 || i == 7)
  16.                 ss << "-";
  17.         }
  18.    
  19.         //定义一个原子类型整形,初始值为1
  20.         static std::atomic<size_t> seq(1);
  21.         size_t num = seq.fetch_add(1);
  22.         for (int i = 7; i >= 0; i--)
  23.         {
  24.             ss << std::setw(2) << std::setfill('0') << std::hex << ((num >> (i * 8)) & 0xff);
  25.             if (i == 6)
  26.                 ss << "-";
  27.         }
  28.         return ss.str();
  29.     }
  30. };
复制代码

8.2.2.4 文件基础操作

这个类中我们需要实现以下功能


  • 文件是否存在判断
  • 文件大小获取
  • 文件读/写
  • 文件创建/删除
  • 目录创建/删除
文件操作类模板:
  1. class FileHelper
  2. {
  3. public:
  4.     FileHelper(const std::string& filename)
  5.         : _filename(filename)
  6.     {}
  7.     bool exists();  //判断是否存在
  8.     size_t size();  //获取文件大小
  9.     bool read(std::string& buffer);  //读取文件中所有内容到buffer中
  10.     bool read(char* buffer, size_t offset, size_t len);  //从offset位置读取len个字符
  11.     bool write(const std::string& buffer);   //将buffer写入文件当中
  12.     bool write(char* buffer, size_t offset, size_t len);  //将buffer写入指定位置
  13.     static bool createFile(const std::string& filename)  //创建文件
  14.     static bool removeFile(const std::string& filename)  //删除文件
  15.     static bool createDirectory(const std::string& path) //创建目录
  16.     static bool removeDirectory(const std::string& path) //删除目录
  17.     static std::string parentDirectory(const std::string& filename) //获取文件路径
  18.     bool renameFile(const std::string& newName);  //修改文件名称
  19. private:
  20.     std::string _filename;
  21. };
复制代码
团体代码:
  1. class FileHelper
  2. {
  3. public:
  4.     FileHelper(const std::string& filename)
  5.         : _filename(filename)
  6.     {}
  7.     bool exists()  //判断是否存在
  8.     {
  9.         //使用stat获取文件状态,获取失败则表示文件不存在
  10.         struct stat st;
  11.         return stat(_filename.c_str(), &st) == 0;//成功返回0,不成功返回-1
  12.     }
  13.     size_t size()  //获取文件大小
  14.     {
  15.         struct stat st;
  16.         int ret = stat(_filename.c_str(), &st);
  17.         if (ret < 0)
  18.             return 0;
  19.         return st.st_size;
  20.     }
  21.     bool read(std::string& buffer)  //读取文件中所有内容到buffer中
  22.     {
  23.         //获取文件大小,根据文件大小调整buffer的空间
  24.         size_t fsize = size();
  25.         buffer.resize(fsize);
  26.         return read(&buffer[0], 0, fsize);
  27.     }
  28.     bool read(char* buffer, size_t offset, size_t len)  //从offset位置读取len个字符
  29.     {
  30.         //1.打开文件
  31.         std::ifstream ifs(_filename, std::ios::binary | std::ios::in);
  32.         if (ifs.is_open() == false)
  33.         {
  34.             ELOG("%s 文件打开失败", _filename.c_str());
  35.             return false;
  36.         }
  37.         //2.跳转文件读写位置
  38.         ifs.seekg(offset, std::ios::beg);
  39.         //3.读取文件数据
  40.         ifs.read(buffer, len);
  41.         if (ifs.good() == false)
  42.         {
  43.             ELOG("% 文件读取数据失败", _filename.c_str());
  44.             ifs.close();
  45.             return false;
  46.         }
  47.         //4.关闭文件
  48.         ifs.close();
  49.         return true;
  50.     }
  51.     bool write(const std::string& buffer)   //将buffer写入文件当中
  52.     {   
  53.         return write(buffer.c_str(), 0, buffer.size());
  54.     }
  55.     bool write(const char* buffer, size_t offset, size_t len)  //将buffer写入指定位置
  56.     {
  57.         //1.打开文件
  58.         std::fstream ofs(_filename, std::ios::binary | std::ios::out | std::ios::in); //跳转位置需要读权限
  59.         if (ofs.is_open() == false)
  60.         {
  61.             ELOG("%s 文件打开失败, 失败原因:%s", _filename.c_str(), strerror(errno));
  62.             return false;           
  63.         }
  64.         //2.跳转到文件指定位置
  65.         ofs.seekp(offset, std::ios::beg);
  66.         //3.写入数据
  67.         ofs.write(buffer, len);
  68.         if (ofs.good() == false)
  69.         {
  70.             ELOG("% 文件写入数据失败", _filename.c_str());
  71.             ofs.close();
  72.             return false;   
  73.         }
  74.         //4.关闭文件
  75.         ofs.close();
  76.         return true;
  77.     }
  78.     bool renameFile(const std::string& newName)  //修改文件名称
  79.     {
  80.         return ::rename(_filename.c_str(), newName.c_str()) == 0;
  81.     }
  82.     static bool createFile(const std::string& filename)  //创建文件
  83.     {
  84.         std::fstream ofs(filename, std::ios::binary | std::ios::out);
  85.         if (ofs.is_open() == false)
  86.         {
  87.             ELOG("%s 文件打开失败", filename.c_str());
  88.             return false;           
  89.         }
  90.         ofs.close();
  91.         return true;
  92.     }
  93.     static bool removeFile(const std::string& filename)  //删除文件
  94.     {
  95.         return ::remove(filename.c_str()) == 0;
  96.     }
  97.     static bool createDirectory(const std::string& path) //创建目录
  98.     {
  99.         //多级路径创建中,需要从第一个父级目录开始创建
  100.         size_t pos = 0, index = 0;
  101.         while (index < path.size())
  102.         {
  103.             pos = path.find('/', index);
  104.             if (pos == std::string::npos)
  105.             {
  106.                 return mkdir(path.c_str(), 0775) == 0;
  107.             }
  108.             std::string subpath = path.substr(0, pos);
  109.             int ret = mkdir(subpath.c_str(), 0775);
  110.             if (ret != 0 && errno != EEXIST)
  111.             {
  112.                 ELOG("创建目录 %s 失败, 失败原因:%s", subpath.c_str(), strerror(errno));
  113.                 return false;
  114.             }
  115.             index = pos + 1;
  116.         }
  117.         return true;
  118.     }
  119.     static bool removeDirectory(const std::string& path) //删除目录
  120.     {
  121.         std::string cmd = "rm -rf " + path;
  122.         return system(cmd.c_str()) != -1;
  123.     }
  124.    
  125.     static std::string parentDirectory(const std::string& filename) //获取文件路径
  126.     {
  127.         size_t pos = filename.rfind('/');
  128.         if (pos == std::string::npos)
  129.         {
  130.             //文件名没有/,返回当前目录
  131.             return "./";
  132.         }
  133.         std::string path = filename.substr(0, pos);
  134.         return path;
  135.     }
  136. private:
  137.     std::string _filename;
  138. };
复制代码
测试代码:
  1. #include "helper.hpp"
  2. #include "logger.hpp"
  3. int main()
  4. {
  5.     bitmq::FileHelper helper("copy.hpp");
  6.     DLOG("是否存在: %d", helper.exists());
  7.     DLOG("文件大小: %ld", helper.size());
  8.     bitmq::FileHelper temp("./aaa/bbb/ccc/temp.hpp");
  9.     if (temp.exists() == false)
  10.     {
  11.         std::string path = bitmq::FileHelper::parentDirectory("./aaa/bbb/ccc/temp.hpp"); //获取文件父路径
  12.         if (bitmq::FileHelper(path).exists() == false) //如果父路径不存在则创建
  13.         {
  14.             bitmq::FileHelper::createDirectory(path);
  15.         }
  16.         bitmq::FileHelper::createFile("./aaa/bbb/ccc/temp.hpp");  //在路径下创建文件
  17.     }
  18.     //读取/写入整个文件
  19.     std::string buffer;
  20.     helper.read(buffer);
  21.     DLOG("%s", buffer.c_str());
  22.     temp.write(buffer);
  23.    
  24.     //从指定位置读取/写入
  25.     char str[16] = { 0 };
  26.     temp.read(str, 8, 4);
  27.     DLOG("%s", str);
  28.     temp.write("123456789", 8, 11);
  29.     //修改名称
  30.     temp.renameFile("./aaa/bbb/ccc/test.hpp");
  31.     //删除文件
  32.     bitmq::FileHelper::removeFile("./aaa/bbb/ccc/test.hpp");
  33.     //删除目录
  34.     bitmq::FileHelper::removeDirectory("./aaa");
  35.     return 0;
  36. }
复制代码
代码肯定要测试,如果测试成功,将来堕落就阐明错误不是出在工具类的代码上,如许可以进步查错服从。

8.2.2.5 团体代码

  1. #pragma once
  2. #include <iostream>
  3. #include <string>
  4. #include <vector>
  5. #include <random>
  6. #include <sstream>
  7. #include <iomanip>
  8. #include <atomic>
  9. #include <fstream>
  10. #include <cstdio>
  11. #include <cstdlib>
  12. #include <cstring>
  13. #include <cerrno>
  14. #include <sys/stat.h>
  15. #include <sys/types.h>
  16. #include <unistd.h>
  17. #include <sqlite3.h>
  18. #include "mq_logger.hpp"
  19. namespace bitmq
  20. {
  21.     class SqliteHelper
  22.     {
  23.         typedef int (*sqliteCallback)(void*, int, char**, char**);
  24.     public:
  25.         SqliteHelper(const std::string& dbfile)
  26.             : _dbfile(dbfile)
  27.             , _handler(nullptr)
  28.         {}
  29.         bool open(int flag = SQLITE_OPEN_FULLMUTEX) //默认为串行化
  30.         {
  31.             //不存在则创建 | 以可读可写方式
  32.             int ret = sqlite3_open_v2(_dbfile.c_str(), &_handler, SQLITE_OPEN_CREATE | SQLITE_OPEN_READWRITE  | flag, nullptr);
  33.             if (ret != SQLITE_OK)
  34.             {
  35.                 ELOG("创建/打开sqlite数据库失败: %s", sqlite3_errmsg(_handler));
  36.                 return false;
  37.             }
  38.             return true;
  39.         }
  40.         bool exec(const std::string& sql, sqliteCallback cb, void* arg)
  41.         {
  42.             int ret = sqlite3_exec(_handler, sql.c_str(), cb, arg, nullptr);
  43.             if (ret != SQLITE_OK)
  44.             {
  45.                 ELOG("%s 执行语句失败: %s",sql.c_str(), sqlite3_errmsg(_handler));
  46.                 return false;
  47.             }
  48.             return true;
  49.         }
  50.         void close()
  51.         {
  52.             if (_handler)
  53.                 sqlite3_close_v2(_handler);
  54.         }
  55.     private:
  56.         std::string _dbfile;
  57.         sqlite3* _handler;
  58.     };
  59.     class StringHelper
  60.     {
  61.     public:
  62.         static size_t splite(const std::string& str, const std::string& sep,
  63.                 std::vector<std::string>& res)
  64.         {
  65.             int index = 0, pos = 0;
  66.             while (index < str.size())
  67.             {
  68.                 pos = str.find(sep, index);
  69.                 if (pos == std::string::npos)
  70.                 {
  71.                     res.push_back(str.substr(index));
  72.                     break;
  73.                 }
  74.                 if (index != pos)
  75.                 {
  76.                     res.push_back(str.substr(index, pos - index));
  77.                 }
  78.                 index = pos + sep.size();
  79.             }
  80.             return res.size();
  81.         }
  82.     };
  83.     class UUIDHelper
  84.     {
  85.     public:
  86.         static std::string uuid()
  87.         {
  88.             std::random_device rd;
  89.             std::mt19937_64 gernator(rd());
  90.             //限制数字区间
  91.             std::uniform_int_distribution<int> distribution(0, 255);
  92.             //将生成的数字转换为16进制数字字符
  93.             std::stringstream ss;
  94.             for (int i = 0; i < 8; i++)
  95.             {
  96.                 ss << std::setw(2) << std::setfill('0') << std::hex << distribution(gernator);
  97.                 if (i == 3 || i == 5 || i == 7)
  98.                     ss << "-";
  99.             }
  100.         
  101.             //定义一个原子类型整形,初始值为1
  102.             static std::atomic<size_t> seq(1);
  103.             size_t num = seq.fetch_add(1);
  104.             for (int i = 7; i >= 0; i--)
  105.             {
  106.                 ss << std::setw(2) << std::setfill('0') << std::hex << ((num >> (i * 8)) & 0xff);
  107.                 if (i == 6)
  108.                     ss << "-";
  109.             }
  110.             return ss.str();
  111.         }
  112.     };
  113.     class FileHelper
  114.     {
  115.     public:
  116.         FileHelper(const std::string& filename)
  117.             : _filename(filename)
  118.         {}
  119.         bool exists()  //判断是否存在
  120.         {
  121.             //使用stat获取文件状态,获取失败则表示文件不存在
  122.             struct stat st;
  123.             return stat(_filename.c_str(), &st) == 0;//成功返回0,不成功返回-1
  124.         }
  125.         size_t size()  //获取文件大小
  126.         {
  127.             struct stat st;
  128.             int ret = stat(_filename.c_str(), &st);
  129.             if (ret < 0)
  130.                 return 0;
  131.             return st.st_size;
  132.         }
  133.         bool read(std::string& buffer)  //读取文件中所有内容到buffer中
  134.         {
  135.             //获取文件大小,根据文件大小调整buffer的空间
  136.             size_t fsize = size();
  137.             buffer.resize(fsize);
  138.             return read(&buffer[0], 0, fsize);
  139.         }
  140.         bool read(char* buffer, size_t offset, size_t len)  //从offset位置读取len个字符
  141.         {
  142.             //1.打开文件
  143.             std::ifstream ifs(_filename, std::ios::binary | std::ios::in);
  144.             if (ifs.is_open() == false)
  145.             {
  146.                 ELOG("%s 文件打开失败", _filename.c_str());
  147.                 return false;
  148.             }
  149.             //2.跳转文件读写位置
  150.             ifs.seekg(offset, std::ios::beg);
  151.             //3.读取文件数据
  152.             ifs.read(buffer, len);
  153.             if (ifs.good() == false)
  154.             {
  155.                 ELOG("% 文件读取数据失败", _filename.c_str());
  156.                 ifs.close();
  157.                 return false;
  158.             }
  159.             //4.关闭文件
  160.             ifs.close();
  161.             return true;
  162.         }
  163.         bool write(const std::string& buffer)   //将buffer写入文件当中
  164.         {   
  165.             return write(buffer.c_str(), 0, buffer.size());
  166.         }
  167.         bool write(const char* buffer, size_t offset, size_t len)  //将buffer写入指定位置
  168.         {
  169.             //1.打开文件
  170.             std::fstream ofs(_filename, std::ios::binary | std::ios::out | std::ios::in); //跳转位置需要读权限
  171.             if (ofs.is_open() == false)
  172.             {
  173.                 ELOG("%s 文件打开失败, 失败原因:%s", _filename.c_str(), strerror(errno));
  174.                 return false;           
  175.             }
  176.             //2.跳转到文件指定位置
  177.             ofs.seekp(offset, std::ios::beg);
  178.             //3.写入数据
  179.             ofs.write(buffer, len);
  180.             if (ofs.good() == false)
  181.             {
  182.                 ELOG("% 文件写入数据失败", _filename.c_str());
  183.                 ofs.close();
  184.                 return false;   
  185.             }
  186.             //4.关闭文件
  187.             ofs.close();
  188.             return true;
  189.         }
  190.         bool renameFile(const std::string& newName)  //修改文件名称
  191.         {
  192.             return ::rename(_filename.c_str(), newName.c_str()) == 0;
  193.         }
  194.         static bool createFile(const std::string& filename)  //创建文件
  195.         {
  196.             std::fstream ofs(filename, std::ios::binary | std::ios::out);
  197.             if (ofs.is_open() == false)
  198.             {
  199.                 ELOG("%s 文件打开失败", filename.c_str());
  200.                 return false;           
  201.             }
  202.             ofs.close();
  203.             return true;
  204.         }
  205.         static bool removeFile(const std::string& filename)  //删除文件
  206.         {
  207.             return ::remove(filename.c_str()) == 0;
  208.         }
  209.         static bool createDirectory(const std::string& path) //创建目录
  210.         {
  211.             //多级路径创建中,需要从第一个父级目录开始创建
  212.             size_t pos = 0, index = 0;
  213.             while (index < path.size())
  214.             {
  215.                 pos = path.find('/', index);
  216.                 if (pos == std::string::npos)
  217.                 {
  218.                     return mkdir(path.c_str(), 0775) == 0;
  219.                 }
  220.                 std::string subpath = path.substr(0, pos);
  221.                 int ret = mkdir(subpath.c_str(), 0775);
  222.                 if (ret != 0 && errno != EEXIST)
  223.                 {
  224.                     ELOG("创建目录 %s 失败, 失败原因:%s", subpath.c_str(), strerror(errno));
  225.                     return false;
  226.                 }
  227.                 index = pos + 1;
  228.             }
  229.             return true;
  230.         }
  231.         static bool removeDirectory(const std::string& path) //删除目录
  232.         {
  233.             std::string cmd = "rm -rf " + path;
  234.             return system(cmd.c_str()) != -1;
  235.         }
  236.         
  237.         static std::string parentDirectory(const std::string& filename) //获取文件路径
  238.         {
  239.             size_t pos = filename.rfind('/');
  240.             if (pos == std::string::npos)
  241.             {
  242.                 //文件名没有/,返回当前目录
  243.                 return "./";
  244.             }
  245.             std::string path = filename.substr(0, pos);
  246.             return path;
  247.         }
  248.     private:
  249.         std::string _filename;
  250.     };
  251. }
复制代码

8.3 消息范例定义&交换机范例定义

在开始正式项目功能模块代码编写之前,我们需要先提前做一件事情,就是将消息范例定义出来。
而消息最终是需要举行长期化存储的,因此涉及到数据的序列化和反序列化,因此消息的范例定义我们使用 protobuf 来举行生成。
因此定义消息范例,其实就是定义一个消息范例的 proto 文件,并生成相干代码。
1.消息所需要素:


  • 1.消息本身要素:

    • 1)消息属性:消息属性中包含有以下内容

      • i. 消息 ID
      • ii. 消息投递模式:非长期化模式/长期化模式
      • iii. 消息的 routing_key

    • 2)消息有效载荷内容

  • 2.消息额外存储所需要素:

    • 1)消息的存储位置
    • 2)消息的长度
    • 3)消息是否有效:留意这里并不使用 bool 范例,而是使用字符的 0/1,由于bool 范例在长期化的时候所占长度差别,会导致,修改文件中消息有效位后消息长度发生变化,因此不消 bool 范例。
       

由于客户端与服务端都会用到交换机的一些相干信息,比如交换机范例,还有就是消息的长期化模式,因此我们将交换机范例的枚举,与消息投递模式的枚举也趁便同时定义到 proto 文件中。
2.交换机范例


  • 1)DIRECT
  • 2)FANOUT
  • 3)TOPIC
3.消息投递模式


  • UNDURABLE:在 RabbitMQ 中,此模式的值为 1,咱们也效仿
  • DURABLE :值为 2.
编写的proto文件内容如下:


8.4 交换机数据管理

从这里开始,这个项目正式开始,我们首先需要创建交换机,队列,绑定,虚拟机等管理类,先从交换机开始逐个实现。
交换机数据管理主要分为下面三个类。
1. 定义交换机数据类


  • 1)交换机名称
  • 2)交换机范例
  • 3)是否长期化标志
  • 4)是否主动删除标志
  • 5)其他参数

2. 定义交换机数据长期化类(数据长期化的 sqlite3 数据库中)


  • 1)创建/删除交换机数据表
  • 2)新增交换机数据
  • 3)移除交换机数据
  • 4)查询全部交换机数据

3. 定义交换机数据管理类


  • 1)声明交换机,并添加管理(存在则 OK,不存在则创建)
  • 2)删除交换机
  • 3)获取指定交换机对象
  • 4)判断交换机是否存在
  • 5)销毁全部交换机数据
该类是对外提供的团体数据管理类,包括数据长期化,以及内存出数据的管理。
   声明交换机数据类
  1. // 1. 定义交换机数据类
  2. struct Exchange
  3. {
  4.     using ptr = std::shared_ptr<Exchange>;
  5.    
  6.     Exchange(const std::string& ename, ExchangeType& etype,
  7.         bool edurable, bool eauto_delete,
  8.         std::unordered_map<std::string, std::string>& eargs)
  9.             : name(ename)
  10.             , type(etype)
  11.             , durable(edurable)
  12.             , auto_delete(eauto_delete)
  13.             , args(eargs)
  14.     { }
  15.     //解析str_args字符串,将结果存储到成员中(反序列化)
  16.     void setArgs(const std::string& str_args);
  17.     std::string getArgs();  //将args中的内容进行序列化,返回字符串
  18.     std::string name;          // 1)交换机名称
  19.     bitmq::ExchangeType type;  // 2)交换机类型
  20.     bool durable;              // 3)是否持久化标志
  21.     bool auto_delete;          // 4)是否自动删除标志
  22.     std::unordered_map<std::string, std::string> args; // 5)其他参数
  23.     //args存储键值对,在存储数据库时,会组织成一个格式字符串存储:key=val&key=val&...
  24. };
复制代码


  • 在其他两个类获取交换机对象时,我们期望使用获取的是智能指针,相较于直接获取对象大概指针,他更加安全高效,所以在内部声明ptr为交换机类的智能指针对象。
  • 其他范例选择使用哈希表来存储,将来存储至数据库时,会根据key和value组成一个格式字符串(key=value&key=value&....)存储,而成员函数setArgs用于将上面的格式字符串转换成key和value并存储至哈希表中,getArgs用于将哈希表中的内容序列化成字符串。
   2. 声明交换机数据长期化类(数据长期化的 sqlite3 数据库中)
  1. // 2. 定义交换机数据持久化类(数据持久化的 sqlite3 数据库中)
  2. class ExchangeMapper
  3. {
  4. public:
  5.     ExchangeMapper(const std::string& dbfile)
  6.     {
  7.     }
  8.     void createTable();  // 1)创建交换机数据表
  9.     void removeTable(); //  2) 删除交换机数据表
  10.     void insert(Exchange::ptr& exchange);  // 3)新增交换机数据
  11.     void remove(const std::string& name);  // 4)移除交换机数据
  12.     using ExchangeMap = std::unordered_map<std::string, Exchange::ptr>;
  13.     ExchangeMap recovery()  // 5)查询所有交换机数据
  14. private:
  15.     bitmap::SqliteHelper _sql_helper;
  16. };
复制代码
该类的功能是对交换机的增删查,并完成交换机数据的长期化(将交换机数据写入数据库中),该类并不会暴露给外部使用,而是用于内部。
   3. 声明交换机数据管理类
  1. // 3. 定义交换机数据管理类
  2. class ExchangeManager
  3. {
  4. public:
  5.     ExchangeManager(const std::string& dbfile);
  6.     // 1)声明交换机,并添加管理(存在则 OK,不存在则创建)
  7.     void declareExchange(const std::string& name, bitmq::ExchangeType type,
  8.         bool durable, bool auto_delete, std::unordered_map<std::string, std::string> args);
  9.     // 2)删除交换机
  10.     void deleteExchange(const std::string& name);
  11.     // 3)获取指定交换机对象
  12.     Exchange::ptr selectExchange(const std::string& name);
  13.     // 3)判断交换机是否存在
  14.     bool exists(const std::string& name);
  15.     // 4)销毁所有交换机数据
  16.     void clear();
  17. private:
  18.     std::mutex _mutex;
  19.     ExchangeMapper _mapper;
  20.     std::unordered_map<std::string, Exchange::ptr> _exchanges;
  21. };
复制代码
该类是交换机数据管理类,_exchanges中会生存全部交换机名称与交换机对象的映射,并可以通过_mapper对象对交换机举行操作,该类是真正暴露给外部使用的类,将来会有多个线程使用该类,所需需要添加锁来保护线程安全。


团体框架搭建好了,接下来就是细节实现了。
   定义交换机数据类
  1. // 1. 定义交换机数据类
  2. struct Exchange
  3. {
  4.     using ptr = std::shared_ptr<Exchange>;
  5.    
  6.     Exchange()
  7.     {}
  8.     Exchange(const std::string& ename, ExchangeType& etype,
  9.         bool edurable, bool eauto_delete,
  10.         std::unordered_map<std::string, std::string>& eargs)
  11.             : name(ename)
  12.             , type(etype)
  13.             , durable(edurable)
  14.             , auto_delete(eauto_delete)
  15.             , args(eargs)
  16.     { }
  17.     //解析str_args字符串,将结果存储到成员中(反序列化)
  18.     void setArgs(const std::string& str_args)
  19.     {
  20.         std::vector<std::string> sub_args;
  21.         size_t ret = bitmq::StringHelper::splite(str_args, "&", sub_args);
  22.         for (auto& str : sub_args)
  23.         {
  24.             size_t pos = str.find('=');
  25.             std::string key = str.substr(0, pos);
  26.             std::string value = str.substr(pos+1);
  27.             args.insert({key, value});
  28.         }
  29.     }
  30.     //将args中的内容进行序列化,返回字符串
  31.     std::string getArgs()
  32.     {
  33.         std::string ret;
  34.         for (auto& [k, v] : args)
  35.         {
  36.             ret += k + '=' + v;
  37.             ret += '&';
  38.         }
  39.         if (ret.size() != 0)
  40.             ret.pop_back();
  41.         return ret;
  42.     }
  43.     std::string name;          // 1)交换机名称
  44.     bitmq::ExchangeType type;  // 2)交换机类型
  45.     bool durable;              // 3)是否持久化标志
  46.     bool auto_delete;          // 4)是否自动删除标志
  47.     std::unordered_map<std::string, std::string> args; // 5)其他参数
  48.     //args存储键值对,在存储数据库时,会组织成一个格式字符串存储:key=val&key=val
  49. };
复制代码
Exchange类较为简单,只需实现getArgs和setArgs函数。


  • setArgs:将传递进来的字符串以&举行分割放入字符串数组当中,然后依次去数组中每一个成员,=左边的就的就是key,=右边的就是value。
  • getArgs:将哈希表中的key和value组成格式字符串,以&作为分隔符。
   2. 定义交换机数据长期化类(数据长期化的 sqlite3 数据库中)
  1. // 2. 定义交换机数据持久化类(数据持久化的 sqlite3 数据库中)
  2. class ExchangeMapper
  3. {
  4. public:
  5.     ExchangeMapper(const std::string& dbfile)
  6.         : _sql_helper(dbfile)
  7.     {
  8.         //创建目录
  9.         std::string path = bitmq::FileHelper::parentDirectory(dbfile);
  10.         bitmq::FileHelper::createDirectory(path);
  11.         assert(_sql_helper.open());
  12.         createTable();
  13.     }
  14.     void createTable()  // 1)创建交换机数据表
  15.     {
  16.         #define CREATE_TABLE "create table if not exists exchange_table( \
  17.             name varchar(32) primary key, \
  18.             type int, \
  19.             durable int, \
  20.             auto_delete int, \
  21.             args varchar(128));"
  22.         bool ret = _sql_helper.exec(CREATE_TABLE, nullptr, nullptr);
  23.         if (ret == false)
  24.         {
  25.             DLOG("创建交换机数据库表失败!!");
  26.             abort();  //直接异常退出程序
  27.         }
  28.     }
  29.     void removeTable() //  2) 删除交换机数据表
  30.     {
  31.         #define DROP_TABLE "drop table if exists exchange_table;"
  32.         bool ret = _sql_helper.exec(DROP_TABLE, nullptr, nullptr);
  33.         if (ret == false)
  34.         {
  35.             DLOG("删除交换机数据库表失败!!");
  36.             abort();  //直接异常退出程序
  37.         }
  38.     }
  39.     void insert(Exchange::ptr& exchange)  // 3)新增交换机数据
  40.     {
  41.         #define INSERT_SQL "insert into exchange_table values('%s', %d, %d, %d, '%s');"
  42.         char sql_str[4096] = { 0 };
  43.         std::string args_str = exchange->getArgs();
  44.         sprintf(sql_str, INSERT_SQL, exchange->name.c_str(), exchange->type, exchange->durable,
  45.             exchange->auto_delete, args_str.c_str());
  46.         bool ret = _sql_helper.exec(sql_str, nullptr, nullptr);
  47.         if (ret == false)
  48.         {
  49.             DLOG("新增交换机数据失败!!");
  50.         }
  51.     }
  52.     void remove(const std::string& name)  // 4)移除交换机数据
  53.     {
  54.         std::string delete_sql = "delete from exchange_table where name = '";
  55.         delete_sql += name + "';";
  56.         bool ret = _sql_helper.exec(delete_sql, nullptr, nullptr);
  57.         if (ret == false)
  58.         {
  59.             DLOG("删除交换机数据失败!!");
  60.         }
  61.     }
  62.     using ExchangeMap = std::unordered_map<std::string, Exchange::ptr>;
  63.     ExchangeMap recovery()  // 5)查询所有交换机数据
  64.     {
  65.         ExchangeMap result;
  66.         std::string sql = "select name, type, durable, auto_delete, args from exchange_table;";
  67.         _sql_helper.exec(sql, selectAllCallback, &result);
  68.         return result;
  69.     }
  70. private:
  71.     static int selectAllCallback(void* arg, int numCol, char** row, char** fields)
  72.     {
  73.         ExchangeMap* result = (ExchangeMap*)arg;
  74.         auto exp = std::make_shared<Exchange>();
  75.         exp->name = row[0];
  76.         exp->type = (bitmq::ExchangeType)std::stoi(row[1]);
  77.         exp->durable = (bool)std::stoi(row[2]);
  78.         exp->auto_delete = (bool)std::stoi(row[3]);
  79.         if (row[4])
  80.             exp->setArgs(row[4]);
  81.         result->insert({exp->name, exp});
  82.         return 0;
  83.     }
  84. private:
  85.     bitmq::SqliteHelper _sql_helper;
  86. };
复制代码


  • ExchangeMapper类主要是完成访问数据库的功能,所以全部的成员函数都是围绕sql语句举行的,需要留意的是,增删功能并不需要知道结果,而查需要,在调用sql实行语句时需要传递一个回调函数,每次回调函数都会返回数据库的一行数据。
  • ExchangeMapper的构造函数是一个文件路径,该路径就是交换机数据库地点路径,首先会根据路径创建父目录,然后在父目录下创建数据库文件。
  • recovery函数的主要作用是重启服务器时将数据库中的数据恢复到内存中,所以该函数固然功能是查询全部交换机数据,但主要是为恢复数据提供服务(其他地方用不到),所以定名为recovery(恢复)
   3. 定义交换机数据管理类
  1. // 3. 定义交换机数据管理类
  2. class ExchangeManager
  3. {
  4. public:
  5.     using ptr = std::shared_ptr<ExchangeManager>;
  6.     using ExchangeMap = std::unordered_map<std::string, Exchange::ptr>;
  7.     ExchangeManager(const std::string& dbfile)
  8.         : _mapper(dbfile)
  9.     {
  10.         //恢复所有数据
  11.         _exchanges = _mapper.recovery();
  12.     }
  13.     // 1)声明交换机,并添加管理(存在则 OK,不存在则创建)
  14.     void declareExchange(const std::string& name, bitmq::ExchangeType type,
  15.         bool durable, bool auto_delete, std::unordered_map<std::string, std::string> args)
  16.     {
  17.         //需要持久化存储才会存储到磁盘中
  18.         std::unique_lock<std::mutex> lock(_mutex);
  19.         auto it = _exchanges.find(name);
  20.         //交换机已经存在
  21.         if (it != _exchanges.end())
  22.             return;
  23.         auto exp = std::make_shared<Exchange>(name, type, durable, auto_delete, args);
  24.         if (durable == true)
  25.         {
  26.             _mapper.insert(exp);
  27.         }
  28.         _exchanges.insert({name, exp});
  29.     }
  30.     // 2)删除交换机
  31.     void deleteExchange(const std::string& name)
  32.     {
  33.         std::unique_lock<std::mutex> lock(_mutex);
  34.         auto it = _exchanges.find(name);
  35.         if (it == _exchanges.end())
  36.             return;
  37.         //只有持久化存储的交换机才需要去数据库中删除数据
  38.         if (it->second->durable == true)
  39.             _mapper.remove(name);
  40.         _exchanges.erase(name);
  41.     }
  42.     // 3)获取指定交换机对象
  43.     Exchange::ptr selectExchange(const std::string& name)
  44.     {
  45.         std::unique_lock<std::mutex> lock(_mutex);
  46.         auto it = _exchanges.find(name);
  47.         if (it == _exchanges.end())
  48.             return {};
  49.         return it->second;
  50.     }
  51.     // 3)判断交换机是否存在
  52.     bool exists(const std::string& name)
  53.     {
  54.         std::unique_lock<std::mutex> lock(_mutex);
  55.         auto it = _exchanges.find(name);
  56.         if (it == _exchanges.end())
  57.             return false;
  58.         return true;
  59.     }
  60.     // 4)销毁所有交换机数据
  61.     void clear()
  62.     {
  63.         std::unique_lock<std::mutex> lock(_mutex);
  64.         _mapper.removeTable();
  65.         _exchanges.clear();
  66.     }
  67.     // 5)返回交换机的数量
  68.     size_t size()
  69.     {
  70.         std::unique_lock<std::mutex> lock(_mutex);
  71.         return _exchanges.size();
  72.     }
  73. private:
  74.     std::mutex _mutex;
  75.     ExchangeMapper _mapper;
  76.     ExchangeMap _exchanges;
  77. };
复制代码


  • ExchangeManager中的_exchanges可以看成是内存中的交换机数据,_mapper是数据库中数据管理者,ExchangeManager的构造函数会将数据库中的数据全部导入_exchanges。
  • 对ExchangeManager中的_mapper和_exchanges举行操作时需要留意添加锁,由于该类将来只会创建一个,并且不止一个线程会访问该类,不加锁就会出现线程安全问题。
  • 声明交换机 / 删除交换机时应该留意该交换机是否长期化了,只有长期化的交换机才需要访问数据库,淘汰对数据库的访问可以有效进步服从。


单元测试:
在编写完上述代码后,我们可以举行单元测试,测试我们的代码是否能正常实行大概存在小bug,我们使用gtest库来帮我们完成测试使命。
   测试插入功能
  1. #include "../../mqserver/mq_exchange.hpp"
  2. #include <gtest/gtest.h>
  3. bitmq::ExchangeManager::ptr emp;
  4. class ExchangeTest : public testing::Environment
  5. {
  6. public:
  7.     virtual void SetUp() override
  8.     {
  9.         emp = std::make_shared<bitmq::ExchangeManager>("./data/meta.db");
  10.     }
  11.     virtual void TearDown() override
  12.     {
  13.         //emp->clear();
  14.     }
  15. };
  16. TEST(exchange_test, insert_test)
  17. {
  18.     std::unordered_map<std::string, std::string> map1;
  19.     std::unordered_map<std::string, std::string> map2 = {{"k1", "v1"}, {"k2", "v2"}};
  20.     emp->declareExchange("exchange1", bitmq::ExchangeType::DIRECT, true, false, map1);
  21.     emp->declareExchange("exchange2", bitmq::ExchangeType::DIRECT, true, false, map1);
  22.     emp->declareExchange("exchange3", bitmq::ExchangeType::DIRECT, true, false, map1);
  23.     emp->declareExchange("exchange4", bitmq::ExchangeType::DIRECT, true, false, map1);
  24.     emp->declareExchange("exchange5", bitmq::ExchangeType::DIRECT, true, false, map2);
  25.     emp->declareExchange("exchange6", bitmq::ExchangeType::DIRECT, true, false, map2);
  26.     ASSERT_EQ(emp->size(), 6);
  27. }
  28. int main(int argc, char* argv[])
  29. {
  30.     testing::InitGoogleTest(&argc, argv);
  31.     testing::AddGlobalTestEnvironment(new ExchangeTest);
  32.     RUN_ALL_TESTS();
  33.     return 0;
  34. }
复制代码
我们声明白六个交换机,前四个的args为空,后两个args不为空。
测试结果:

再来观察一下数据库

可见插入功能没有问题。
   测试删除功能
  1. TEST(exchange_test, remove_test)
  2. {
  3.     emp->deleteExchange("exchange2");
  4.     bitmq::Exchange::ptr exp = emp->selectExchange("exchange2");
  5.     ASSERT_EQ(exp.get(), nullptr);
  6.     ASSERT_EQ(emp->exists("exchange2"), false);
  7. }
复制代码
这段代码,我们删除名为exchange2的交换机。
实行结果:

实行结果表现没有问题,我们再来看一下数据库

   测试查找功能
  1. TEST(exchange_test, select_test)
  2. {
  3.     bitmq::Exchange::ptr exp1 = emp->selectExchange("exchange3");
  4.     ASSERT_EQ(exp1->name, "exchange3");
  5.     ASSERT_EQ(exp1->type, bitmq::ExchangeType::DIRECT);
  6.     ASSERT_EQ(exp1->durable, true);
  7.     ASSERT_EQ(exp1->auto_delete, false);
  8.     ASSERT_EQ(exp1->getArgs(), "");
  9.     bitmq::Exchange::ptr exp2 = emp->selectExchange("exchange5");
  10.     ASSERT_EQ(exp2->name, "exchange5");
  11.     ASSERT_EQ(exp2->type, bitmq::ExchangeType::DIRECT);
  12.     ASSERT_EQ(exp2->durable, true);
  13.     ASSERT_EQ(exp2->auto_delete, false);
  14.     ASSERT_EQ(exp2->getArgs(), "k2=v2&k1=v1");
  15. }
复制代码
我们查找exchange3和exchange5,并且比对每一个属性是否正确。

运行结果也是没有问题的。

8.5 队列数据管理

当前队列数据的管理,本质上是队列描述信息的管理,描述当前服务器上有哪些队列。
1. 定义队列描述数据类


  • 1)队列名称
  • 2)是否长期化标志
  • 3)是否独占标志
  • 4)是否主动删除标志
  • 5)其他参数

2. 定义队列数据长期化类(数据长期化的 sqlite3 数据库中)


  • 1)创建/删除队列数据表
  • 2)新增队列数据
  • 3)移除队列数据
  • 4)查询全部队列数据

3. 定义队列数据管理类


  • 1)创建队列,并添加管理(存在则 OK,不存在则创建)
  • 2)删除队列
  • 3)获取指定队列
  • 4)获取全部队列
  • 5)判断指定队列是否存在
  • 6)获取队列数目
  • 7)销毁全部队列数据
该类是对外提供的团体数据管理类,包括数据长期化,以及内存出数据的管理。
   声明队列描述数据类
  1. // 1. 定义队列描述数据类
  2. struct MsgQueue
  3. {
  4.     MsgQueue()
  5.     {}
  6.     MsgQueue(const std::string& qname, bool qdurable,
  7.         bool qexclusive, bool qauto_delete,
  8.         std::unordered_map<std::string, std::string>& qargs)
  9.             : name(qname)
  10.             , durable(qdurable)
  11.             , exclusive(qexclusive)
  12.             , auto_delete(qauto_delete)
  13.             , args(qargs)
  14.     {}
  15.    
  16.     //解析str_args字符串,将结果存储到成员中(反序列化)
  17.     void setArgs(const std::string& str_args);
  18.     //将args中的内容进行序列化,返回字符串
  19.     std::string getArgs();
  20.     std::string name;  // 1)队列名称
  21.     bool durable;      // 2)是否持久化标志
  22.     bool exclusive;    // 3)是否独占标志
  23.     bool auto_delete;  // 4)是否自动删除标志
  24.     std::unordered_map<std::string, std::string> args;   // 5)其他参数
  25. };
复制代码
队列和交换机很多地方基本是一样的,这里就不外多赘述了。
   声明队列数据长期化类(数据长期化的 sqlite3 数据库中)
  1. // 2. 定义队列数据持久化类(数据持久化的 sqlite3 数据库中)
  2. class MsgQueueMapper
  3. {
  4. public:
  5.     MsgQueueMapper(const std::string& dbfile)
  6.         : _sql_helper(dbfile)
  7.     {}
  8.     void createTable();   // 1)创建队列数据表
  9.     void removeTable();   // 2)删除队列数据表
  10.     void insert(MsgQueue::ptr& queue);   // 3)新增队列数据
  11.     void remove(const std::string& name); // 4)移除队列数据
  12.     using QueueMap = std::unordered_map<std::string, MsgQueue::ptr>;
  13.     QueueMap recovery();   // 5)查询所有队列数据
  14. private:
  15.     bitmq::SqliteHelper _sql_helper;
  16. };
复制代码
队列的数据长期化类也和交换机数据长期类基本一样。
   3. 声明队列数据管理类
  1. // 3. 定义队列数据管理类
  2. class MsgQueueManager
  3. {
  4. public:
  5.     using QueueMap = std::unordered_map<std::string, MsgQueue::ptr>;
  6.     // 1)创建队列,并添加管理(存在则 OK,不存在则创建)
  7.     void declareQueue(const std::string& name, bool durable, bool exclusive,
  8.         bool auto_delete, std::unordered_map<std::string, std::string> args);
  9.     // 2)删除队列
  10.     void deleteQueue(const std::string& name);
  11.     // 3)获取指定队列
  12.     MsgQueue::ptr selectQueue(const std::string& name);
  13.     // 4)获取所有队列
  14.     QueueMap getAllQueues();
  15.     // 5)判断指定队列是否存在
  16.     bool exists(const std::string& name);
  17.     // 6)获取队列数量
  18.     size_t size();
  19.     // 7)销毁所有队列数据
  20.     void clear();
  21. private:
  22.     std::mutex _mutex;
  23.     MsgQueueMapper _mapper;
  24.     QueueMap _msg_queues;
  25. };
复制代码


在实现了队列管理类的框架后,我们需要开始实现每个类的细节了,由于队列和交换机的代码基本上一样,这里就不外多赘述了。
   定义队列描述数据类
  1. // 1. 定义队列描述数据类
  2. struct MsgQueue
  3. {
  4.     using ptr = std::shared_ptr<MsgQueue>;
  5.     MsgQueue()
  6.     {}
  7.     MsgQueue(const std::string& qname, bool qdurable,
  8.         bool qexclusive, bool qauto_delete,
  9.         std::unordered_map<std::string, std::string>& qargs)
  10.             : name(qname)
  11.             , durable(qdurable)
  12.             , exclusive(qexclusive)
  13.             , auto_delete(qauto_delete)
  14.             , args(qargs)
  15.     {}
  16.    
  17.     //解析str_args字符串,将结果存储到成员中(反序列化)
  18.     void setArgs(const std::string& str_args)
  19.     {
  20.         std::vector<std::string> sub_args;
  21.         size_t ret = bitmq::StringHelper::splite(str_args, "&", sub_args);
  22.         for (auto& str : sub_args)
  23.         {
  24.             size_t pos = str.find('=');
  25.             std::string key = str.substr(0, pos);
  26.             std::string value = str.substr(pos+1);
  27.             args.insert({key, value});
  28.         }
  29.     }
  30.     //将args中的内容进行序列化,返回字符串
  31.     std::string getArgs()
  32.     {
  33.         std::string ret;
  34.         for (auto& [k, v] : args)
  35.         {
  36.             ret += k + '=' + v;
  37.             ret += '&';
  38.         }
  39.         if (ret.size() != 0)
  40.             ret.pop_back();
  41.         return ret;
  42.     }
  43.     std::string name;  // 1)队列名称
  44.     bool durable;      // 2)是否持久化标志
  45.     bool exclusive;    // 3)是否独占标志
  46.     bool auto_delete;  // 4)是否自动删除标志
  47.     std::unordered_map<std::string, std::string> args;   // 5)其他参数
  48. };
复制代码
  定义队列数据长期化类(数据长期化的 sqlite3 数据库中)
  1. // 2. 定义队列数据持久化类(数据持久化的 sqlite3 数据库中)
  2. class MsgQueueMapper
  3. {
  4. public:
  5.     MsgQueueMapper(const std::string& dbfile)
  6.         : _sql_helper(dbfile)
  7.     {
  8.         std::string path = bitmq::FileHelper::parentDirectory(dbfile);
  9.         bitmq::FileHelper::createDirectory(path);
  10.         assert(_sql_helper.open());
  11.         createTable();
  12.     }
  13.     void createTable()   // 1)创建队列数据表
  14.     {
  15.         std::string sql = "create table if not exists queue_table(name varchar(32) primary key, durable int, \
  16.             exclusive int, auto_delete int, args varchar(128));";
  17.         assert(_sql_helper.exec(sql, nullptr, nullptr));
  18.     }
  19.     void removeTable()   // 2)删除队列数据表
  20.     {
  21.         std::string sql = "drop table if exists queue_table";
  22.         assert(_sql_helper.exec(sql, nullptr, nullptr));
  23.     }
  24.     void insert(MsgQueue::ptr& queue)   // 3)新增队列数据
  25.     {
  26.         std::stringstream sql;
  27.         sql << "insert into queue_table values(";
  28.         sql << "'" << queue->name << "', ";
  29.         sql << queue->durable << ", ";
  30.         sql << queue->exclusive << ", ";
  31.         sql << queue->auto_delete << ", ";
  32.         sql <<  "'" << queue->getArgs() << "');";
  33.         _sql_helper.exec(sql.str(), nullptr, nullptr);
  34.     }
  35.     void remove(const std::string& name) // 4)移除队列数据
  36.     {
  37.         std::string sql = "delete from queue_table where name = '";
  38.         sql += name + "';";
  39.         _sql_helper.exec(sql, nullptr, nullptr);
  40.     }
  41.     using QueueMap = std::unordered_map<std::string, MsgQueue::ptr>;
  42.     QueueMap recovery()   // 5)查询所有队列数据
  43.     {
  44.         std::string sql = "select name, durable, exclusive, auto_delete, args from queue_table";
  45.         QueueMap result;
  46.         _sql_helper.exec(sql, selectAllCallback, &result);
  47.         return result;
  48.     }
  49. private:
  50.     static int selectAllCallback(void* arg, int numCol, char** row, char** fields)
  51.     {
  52.         QueueMap* result = (QueueMap*)arg;
  53.         auto exp = std::make_shared<MsgQueue>();
  54.         exp->name = row[0];
  55.         exp->durable = (bool)std::stoi(row[1]);
  56.         exp->exclusive = (bool)std::stoi(row[2]);
  57.         exp->auto_delete = (bool)std::stoi(row[3]);
  58.         if (row[4])
  59.             exp->setArgs(row[4]);
  60.         result->insert({exp->name, exp});
  61.         return 0;
  62.     }
复制代码
  定义队列数据管理类
  1. // 3. 定义队列数据管理类
  2. class MsgQueueManager
  3. {
  4. public:
  5.     using ptr = std::shared_ptr<MsgQueueManager>;
  6.     using QueueMap = std::unordered_map<std::string, MsgQueue::ptr>;
  7.     MsgQueueManager(const std::string& dbfile)
  8.     : _mapper(dbfile)
  9.     {
  10.         //恢复所有数据
  11.         _msg_queues = _mapper.recovery();
  12.     }
  13.     // 1)创建队列,并添加管理(存在则 OK,不存在则创建)
  14.     void declareQueue(const std::string& name, bool durable, bool exclusive,
  15.         bool auto_delete, std::unordered_map<std::string, std::string> args)
  16.     {
  17.         std::unique_lock<std::mutex> lock(_mutex);
  18.         auto it = _msg_queues.find(name);
  19.         if (it == _msg_queues.end())
  20.             return;
  21.         MsgQueue::ptr mqp = std::make_shared<MsgQueue>();
  22.         mqp->name = name;
  23.         mqp->durable = durable;
  24.         mqp->exclusive = exclusive;
  25.         mqp->auto_delete = auto_delete;
  26.         mqp->args = args;
  27.         if (durable == true)
  28.             _mapper.insert(mqp);
  29.         _msg_queues.insert({name, mqp});
  30.     }
  31.     // 2)删除队列
  32.     void deleteQueue(const std::string& name)
  33.     {
  34.         std::unique_lock<std::mutex> lock(_mutex);
  35.         auto it = _msg_queues.find(name);
  36.         if (it == _msg_queues.end())
  37.             return;
  38.         if (it->second->durable == true)
  39.             _mapper.remove(name);
  40.         _msg_queues.erase(name);
  41.     }
  42.     // 3)获取指定队列
  43.     MsgQueue::ptr selectQueue(const std::string& name)
  44.     {
  45.         std::unique_lock<std::mutex> lock(_mutex);
  46.         auto it = _msg_queues.find(name);
  47.         if (it == _msg_queues.end())
  48.             return {};
  49.         return it->second;      
  50.     }
  51.     // 4)获取所有队列
  52.     QueueMap getAllQueues()
  53.     {
  54.         std::unique_lock<std::mutex> lock(_mutex);
  55.         return _msg_queues;
  56.     }
  57.     // 5)判断指定队列是否存在
  58.     bool exists(const std::string& name)
  59.     {
  60.         std::unique_lock<std::mutex> lock(_mutex);
  61.         auto it = _msg_queues.find(name);
  62.         if (it == _msg_queues.end())
  63.             return false;
  64.         return true;  
  65.     }
  66.     // 6)获取队列数量
  67.     size_t size()
  68.     {
  69.         std::unique_lock<std::mutex> lock(_mutex);
  70.         return _msg_queues.size();
  71.     }
  72.     // 7)销毁所有队列数据
  73.     void clear()
  74.     {
  75.         std::unique_lock<std::mutex> lock(_mutex);
  76.         _mapper.removeTable();
  77.         _msg_queues.clear();
  78.     }
  79. private:
  80.     std::mutex _mutex;
  81.     MsgQueueMapper _mapper;
  82.     QueueMap _msg_queues;
  83. };
复制代码


单元测试:
由于队列和交换机基本相似,所以交换机的测试代码队列也可以使用,所以我们就直接使用交换机的测试代码举行测试。
   测试插入功能
  1. #include "../../mqserver/mq_queue.hpp"
  2. #include <gtest/gtest.h>
  3. bitmq::MsgQueueManager::ptr mqmp;
  4. class QueueTest: public testing::Environment
  5. {
  6. public:
  7.     virtual void SetUp() override
  8.     {
  9.         mqmp = std::make_shared<bitmq::MsgQueueManager>("./data/meta.db");
  10.     }
  11.     virtual void TearDown() override
  12.     {
  13.         //mqmp->clear();
  14.     }
  15. };
  16. TEST(queue_test, insert_test)
  17. {
  18.     std::unordered_map<std::string, std::string> map1;
  19.     std::unordered_map<std::string, std::string> map2 = {{"k1", "v1"}, {"k2", "v2"}};
  20.     mqmp->declareQueue("queue1", true, false, false, map1);
  21.     mqmp->declareQueue("queue2", true, false, false, map1);
  22.     mqmp->declareQueue("queue3", true, false, false, map1);
  23.     mqmp->declareQueue("queue4", true, false, false, map1);
  24.     mqmp->declareQueue("queue5", true, false, false, map2);
  25.     mqmp->declareQueue("queue6", true, false, false, map2);
  26.     ASSERT_EQ(mqmp->size(), 6);
  27. }
  28. int main(int argc, char* argv[])
  29. {
  30.     testing::InitGoogleTest(&argc, argv);
  31.     testing::AddGlobalTestEnvironment(new QueueTest);
  32.     RUN_ALL_TESTS();
  33.     return 0;
  34. }
复制代码
运行结果:


数据被成功插入了数据库中。
   测试删除功能
  1. TEST(queue_test, remove_test)
  2. {
  3.     mqmp->deleteQueue("queue2");
  4.     bitmq::MsgQueue::ptr mqp = mqmp->selectQueue("queue2");
  5.     ASSERT_EQ(mqp.get(), nullptr);
  6. }
复制代码
运行结果:


   测试查找功能
  在直接测试查找功能前我们可以趁便测试一下恢复功能,我们讲插入测试单元函数屏蔽,也就是说队列数据管理类不会通过函数调用获取数据,而是在初始化时从数据库中读取数据,而在上一次测试结束后,数据库中除了queue2被删除,其他队列应该都存在,所以我们可以通过测试其他队列存在,而queue2不存在来判断数据能否成功被恢复。
  1. TEST(queue_test, select_test)
  2. {
  3.     ASSERT_EQ(mqmp->exists("queue1"), true);
  4.     ASSERT_EQ(mqmp->exists("queue2"), false);
  5.     ASSERT_EQ(mqmp->exists("queue3"), true);
  6.     ASSERT_EQ(mqmp->exists("queue4"), true);
  7.     ASSERT_EQ(mqmp->exists("queue5"), true);
  8.     ASSERT_EQ(mqmp->exists("queue6"), true);
  9.     bitmq::MsgQueue::ptr mqp1 = mqmp->selectQueue("queue3");
  10.     ASSERT_EQ(mqp1->name, "queue3");
  11.     ASSERT_EQ(mqp1->durable, true);
  12.     ASSERT_EQ(mqp1->exclusive, false);
  13.     ASSERT_EQ(mqp1->auto_delete, false);
  14.     ASSERT_EQ(mqp1->getArgs(), "");
  15.     bitmq::MsgQueue::ptr mqp2 = mqmp->selectQueue("queue5");
  16.     ASSERT_EQ(mqp2->name, "queue5");
  17.     ASSERT_EQ(mqp2->durable, true);
  18.     ASSERT_EQ(mqp2->exclusive, false);
  19.     ASSERT_EQ(mqp2->auto_delete, false);
  20.     ASSERT_EQ(mqp2->getArgs(), "k1=v1&k2=v2");
  21. }
复制代码
运行结果:

测试结果没有问题,阐明恢复功能是正确的。

8.6 绑定信息(交换机-队列)管理

绑定信息,本质上就是一个交换机关联了哪些队列的描述。
1. 定义绑定信息类


  • 1)交换机名称
  • 2)队列名称
  • 3)binding_key(分发匹配规则-决定了哪些数据能被交换机放入队列)
  • 4)长期化标志

2. 定义绑定信息数据长期化类(数据长期化的 sqlite3 数据库中)


  • 1)创建/删除绑定信息数据表
  • 2)新增绑定信息数据
  • 3)移除指定绑定信息数据
  • 4)移除指定交换机相干绑定信息数据:移除交换机的时候会被调用
  • 5)移除指定队列相干绑定信息数据:移除队列的时候会被调用
  • 6)查询全部绑定信息数据:用于重启服务器时举行历史数据恢复

3. 定义绑定信息数据管理类


  • 1)创建绑定信息,并添加管理(存在则 OK,不存在则创建)
  • 2)清除指定的绑定信息
  • 3)删除指定队列的全部绑定信息
  • 4)删除交换机相干的全部绑定信息
  • 5)获取交换机相干的全部绑定信息:交换机收到消息后,需要分发给本身关联的队列
  • 6)判断指定绑定信息是否存在
  • 7)获取当前绑定信息数目
  • 8)销毁全部绑定信息数据
   定义绑定信息类
  1. // 1. 定义绑定信息类
  2. struct Binding
  3. {
  4.     using ptr = std::shared_ptr<Binding>;
  5.     Binding(const std::string& ename, const std::string& qname, const std::string& key)
  6.         : exchange_name(ename)
  7.         , msgqueue_name(qname)
  8.         , binding_key(key)
  9.     {}
  10.     std::string exchange_name;  // 1)交换机名称
  11.     std::string msgqueue_name;  // 2)队列名称
  12.     std::string binding_key;    // 3)binding_key(分发匹配规则-决定了哪些数据能被交换机放入队列)
  13.     bool durable;               // 4)是否需要持久化
  14. };
复制代码
  声明绑定信息数据长期化类(数据长期化的 sqlite3 数据库中)
  1. // 2. 定义绑定信息数据持久化类(数据持久化的 sqlite3 数据库中)
  2. class BindingMapper
  3. {
  4. public:
  5.     //队列和绑定信息是一一对应的
  6.     using MsgQueueBindingMap = std::unordered_map<std::string, Binding::ptr>;
  7.     //一个交换机可以绑定多个队列,所以key为交换机,value为队列和绑定信息表
  8.     using BindingMap = std::unordered_map<std::string, MsgQueueBindingMap>;
  9. public:
  10.     BindingMapper(const std::string& dbfile)
  11.         : _sql_helper(dbfile)
  12.     {}
  13.     // 1)创建绑定信息数据表
  14.     void createTable();
  15.     // 2)删除绑定信息数据表
  16.     void removeTable();
  17.     // 2)新增绑定信息数据
  18.     bool insert(Binding::ptr& binding);
  19.     // 3)移除指定绑定信息数据
  20.     void remove(const std::string& ename, const std::string& qname);
  21.     // 4)移除指定交换机相关绑定信息数据:移除交换机的时候会被调用  
  22.     void removeExchangeBinding(const std::string& ename);
  23.     // 5)移除指定队列相关绑定信息数据:移除队列的时候会被调用
  24.     void removeQueueBinding(const std::string& qname);
  25.     // 6)查询所有绑定信息数据:用于重启服务器时进行历史数据恢复
  26.     BindingMap recovery();
  27. private:
  28.     SqliteHelper _sql_helper;
  29. };
复制代码
留意:队列与绑定信息是一一对应的(由于是给某个交换机绑定队列,因此一个交换机可能会有多个队列的绑定信息),所以需要先定义一个队列名与绑定信息的映射关系,这是为了方便通过队列名查找绑定信息
  1. using MsgQueueBindingMap = std::unordered_map<std::string, Binding::ptr>;
复制代码
然后定义一个交换机名称与队列绑定信息的映射关系,这个map中包含了全部的绑定信息,并且以交换机为单元举行了区分。
  1. using BindingMap = std::unordered_map<std::string, MsgQueueBindingMap>;
复制代码
  声明绑定信息数据管理类
  1. // 3. 定义绑定信息数据管理类class BindingManager{public:    //队列和绑定信息是一一对应的    using MsgQueueBindingMap = std::unordered_map<std::string, Binding::ptr>;    //一个交换机可以绑定多个队列,所以key为交换机,value为队列和绑定信息表    using BindingMap = std::unordered_map<std::string, MsgQueueBindingMap>;public:    BindingManager(const std::string& dbfile)        : _mapper(dbfile)    {}    // 1)创建绑定信息,并添加管理(存在则 OK,不存在则创建)    bool bind(const std::string& ename, const std::string& qname, const std::string& key);    // 2)清除指定的绑定信息    void unBind(const std::string& ename, const std::string& qname);    // 3)删除交换机相干的全部绑定信息    void removeExchangeBindings(const std::string& ename);    // 4)删除指定队列的全部绑定信息    void removeMsgQueueBindings(const std::string& qname);    // 5)获取交换机相干的全部绑定信息:交换机收到消息后,需要分发给本身关联的队列    MsgQueueBindingMap getExchangeBindings(const std::string& ename);    // 6)获取指定绑定信息    Binding::ptr getBinding(const std::string& ename, const std::string& qname);    // 7)判断指定绑定信息是否存在    bool exists(const std::string& ename, const std::string& qname);    // 8)获取当前绑定信息数目    size_t size();    // 9)销毁全部绑定信息数据    void clear();private:    std::mutex _mutex;    BindingMapper _mapper;    BindingMap _bindings;};
复制代码
BindingMap的结构图如下:BindMap是一个哈希表,kye值是交换机名称,value是一个哈希表BindingMapper,BindingMapper的key值是队列名称,value是绑定信息。
如许设计的利益在于,当删除指定队列的全部绑定信息时,只需遍历BindingMap,获取value,通过value(BindingMapper),通过哈希表的erase函数就可以完成,不消遍历全部的绑定信息,进步了查找速率。



在看完备体框架后,需要实现具体细节,由于Binding并不需要额外功能,全部需要的内容在声明时就已经确定好了,所以我们直接从绑定信息长期化类来看。
   定义绑定信息数据长期化类(数据长期化的 sqlite3 数据库中)
  1. // 2. 定义绑定信息数据长期化类(数据长期化的 sqlite3 数据库中)class BindingMapper{public:    //队列和绑定信息是一一对应的    using MsgQueueBindingMap = std::unordered_map<std::string, Binding::ptr>;    //一个交换机可以绑定多个队列,所以key为交换机,value为队列和绑定信息表    using BindingMap = std::unordered_map<std::string, MsgQueueBindingMap>;public:    BindingMapper(const std::string& dbfile)        : _sql_helper(dbfile)    {        std::string path = bitmq::FileHelper::parentDirectory(dbfile);        bitmq::FileHelper::createDirectory(path);        assert(_sql_helper.open());        createTable();    }    // 1)创建绑定信息数据表    void createTable()    {        std::string sql = "create table if not exists binding_table(exchange_name varchar(32), \            msgqueue_name varchar(32),  binding_key varchar(128), durable int);";        assert(_sql_helper.exec(sql, nullptr, nullptr));    }    // 2)删除绑定信息数据表     void removeTable()    {        std::string sql = "drop table if exists binding_table";        assert(_sql_helper.exec(sql, nullptr, nullptr));    }    // 2)新增绑定信息数据    bool insert(Binding::ptr& binding)    {        std::stringstream ss;        ss << "insert into binding_table values(";        ss << "'" << binding->exchange_name << "', ";        ss << "'" << binding->msgqueue_name << "', ";        ss << "'" << binding->binding_key << "', ";        ss << binding->durable << ");";        return _sql_helper.exec(ss.str(), nullptr, nullptr);    }    // 3)移除指定绑定信息数据    void remove(const std::string& ename, const std::string& qname)    {        std::stringstream ss;        ss << "delete from binding_table where ";         ss << "exchange_name = '" << ename << "' and ";        ss << "msgqueue_name = '" << qname << "';";        _sql_helper.exec(ss.str(), nullptr, nullptr);    }    // 4)移除指定交换机相干绑定信息数据:移除交换机的时候会被调用      void removeExchangeBinding(const std::string& ename)    {        std::stringstream ss;        ss << "delete from binding_table where ";         ss << "exchange_name = '" << ename << "';";        _sql_helper.exec(ss.str(), nullptr, nullptr);    }    // 5)移除指定队列相干绑定信息数据:移除队列的时候会被调用    void removeQueueBinding(const std::string& qname)    {        std::stringstream ss;        ss << "delete from binding_table where ";         ss << "msgqueue_name = '" << qname << "';";        _sql_helper.exec(ss.str(), nullptr, nullptr);    }    // 6)查询全部绑定信息数据:用于重启服务器时举行历史数据恢复    BindingMap recovery()    {        std::string sql = "select exchange_name, msgqueue_name, binding_key, durable from binding_table";        BindingMap result;        _sql_helper.exec(sql, selectAllCallback, &result);        return result;    }private:    static int selectAllCallback(void* arg, int numCol, char** row, char** fields)    {        BindingMap* result = (BindingMap*)arg;        auto bp = std::make_shared<Binding>();        bp->exchange_name = row[0];        bp->msgqueue_name = row[1];        bp->binding_key = row[2];        bp->durable = (bool)std::stoi(row[3]);        //获取交换机对应的队列绑定映射        MsgQueueBindingMap& qmap = (*result)[bp->exchange_name];        //向队列绑定映射中他添加信息        qmap.insert({bp->msgqueue_name, bp});        return 0;    }private:    SqliteHelper _sql_helper;};
复制代码
在selectAllCallback回调函数中使用如下两句话来实现将binding插入对应的表中。
  1. //获取交换机对应的队列绑定映射
  2. MsgQueueBindingMap& qmap = (*result)[bp->exchange_name];
  3. //向队列绑定映射中他添加信息
  4. qmap.insert({bp->msgqueue_name, bp});
复制代码
上面使用的方法是获取交换机对应的队列绑定映射,然后直接向该映射中插入数据,而不是直接向交换机插入绑定映射(下面这种写法)
  1. MsgQueueBindingMap qmap;
  2. qmap.insert({bp->msgqueue_name, bp});
  3. result->insert({bp->exchange_name, qmap});
复制代码
这是为了防止交换机相干的绑定信息已经存在,不能直接创建队列映射举行添加,如许会覆盖历史数据,因此得先获取交换机对应得映射对象,再往里面添加数据,但是,如果交换机对应得映射信息为空,则还是无法添加成功,所以需要添加引用,如许可以保证不存在主动创建)
   定义绑定信息数据管理类
  1. // 3. 定义绑定信息数据管理类class BindingManager{public:    //队列和绑定信息是一一对应的    using MsgQueueBindingMap = std::unordered_map<std::string, Binding::ptr>;    //一个交换机可以绑定多个队列,所以key为交换机,value为队列和绑定信息表    using BindingMap = std::unordered_map<std::string, MsgQueueBindingMap>;    using ptr = std::shared_ptr<BindingManager>;public:    BindingManager(const std::string& dbfile)        : _mapper(dbfile)    {        //恢复历史消息        _bindings = _mapper.recovery();    }    // 1)创建绑定信息,并添加管理(存在则 OK,不存在则创建)    bool bind(const std::string& ename, const std::string& qname, const std::string& key, bool durable)    {        std::unique_lock<std::mutex> lock(_mutex);        auto it = _bindings.find(ename);        if (it != _bindings.end() && it->second.find(qname) != it->second.end())            return true;        Binding::ptr bp = std::make_shared<Binding>(ename, qname, key, durable);        if (durable == true)        {            if (_mapper.insert(bp) == false)                return false;        }        auto& qbmp = _bindings[ename];        qbmp.insert({qname, bp});        return true;    }    // 2)清除指定的绑定信息    void unBind(const std::string& ename, const std::string& qname)    {        std::unique_lock<std::mutex> lock(_mutex);        auto it = _bindings.find(ename);        if (it == _bindings.end())   //没有交换机相干信息            return;        if (it->second.find(qname) == it->second.end())  //交换机没有队列相干绑定信息            return;        if (it->second[qname]->durable == true)            _mapper.remove(ename, qname);        it->second.erase(qname);    }    // 3)删除交换机相干的全部绑定信息    void removeExchangeBindings(const std::string& ename)    {        std::unique_lock<std::mutex> lock(_mutex);        _mapper.removeExchangeBinding(ename);        _bindings.erase(ename);    }    // 4)删除指定队列的全部绑定信息    void removeMsgQueueBindings(const std::string& qname)    {        std::unique_lock<std::mutex> lock(_mutex);        _mapper.removeQueueBinding(qname);        //遍历每个交换机,移除全部指定 队列相干信息        for (auto& it : _bindings)        {            it.second.erase(qname);        }    }    // 5)获取交换机相干的全部绑定信息:交换机收到消息后,需要分发给本身关联的队列    MsgQueueBindingMap getExchangeBindings(const std::string& ename)    {        std::unique_lock<std::mutex> lock(_mutex);        auto it = _bindings.find(ename);        if (it == _bindings.end())            return {};        return it->second;    }    // 6)获取指定绑定信息    Binding::ptr getBinding(const std::string& ename, const std::string& qname)    {        std::unique_lock<std::mutex> lock(_mutex);        auto it = _bindings.find(ename);        if (it == _bindings.end())            return {};         auto qit = it->second.find(qname);        if (qit == it->second.end())            return {};        return qit->second;    }    // 7)判断指定绑定信息是否存在    bool exists(const std::string& ename, const std::string& qname)    {        std::unique_lock<std::mutex> lock(_mutex);        auto it = _bindings.find(ename);        if (it == _bindings.end())            return false;         auto qit = it->second.find(qname);        if (qit == it->second.end())            return false;        return true;    }    // 8)获取当前绑定信息数目    size_t size()    {        std::unique_lock<std::mutex> lock(_mutex);        int total_size = 0;        for (auto it : _bindings)        {            total_size += it.second.size();        }        return total_size;    }    // 9)销毁全部绑定信息数据    void clear()    {        std::unique_lock<std::mutex> lock(_mutex);        _mapper.removeTable();        _bindings.clear();    }private:    std::mutex _mutex;    BindingMapper _mapper;    BindingMap _bindings;};
复制代码


单元测试:
   测试插入功能
  1. #include "../../mqserver/mq_binding.hpp"
  2. #include <gtest/gtest.h>
  3. bitmq::BindingManager::ptr bmp;
  4. class BindingTest : public testing::Environment
  5. {
  6. public:
  7.     virtual void SetUp() override
  8.     {
  9.         bmp = std::make_shared<bitmq::BindingManager>("./data/meta.db");
  10.     }
  11.     virtual void TearDown() override
  12.     {
  13.         //bmp->clear();
  14.     }
  15. };
  16. TEST(binding_test, insert_test)
  17. {
  18.     bmp->bind("exchange1", "queue1", "news.music.#", true);
  19.     bmp->bind("exchange1", "queue2", "news.sport.#", true);
  20.     bmp->bind("exchange1", "queue3", "news.gossip.#", true);
  21.     bmp->bind("exchange2", "queue1", "news.music.pop", true);
  22.     bmp->bind("exchange2", "queue2", "news.sport.football", true);
  23.     bmp->bind("exchange2", "queue3", "news.gossip.zhangsan", true);
  24.     ASSERT_EQ(bmp->size(), 6);
  25. }
  26. int main(int argc, char* argv[])
  27. {
  28.     testing::InitGoogleTest(&argc, argv);
  29.     testing::AddGlobalTestEnvironment(new BindingTest);
  30.     RUN_ALL_TESTS();
  31.     return 0;
  32. }
复制代码
实行结果:

数据库:

绑定信息插入成功。
   测试查找功能
  1. TEST(binding_test, select_test)
  2. {
  3.     ASSERT_EQ(bmp->exists("exchange1", "queue1"), true);
  4.     ASSERT_EQ(bmp->exists("exchange1", "queue2"), true);
  5.     ASSERT_EQ(bmp->exists("exchange1", "queue3"), true);
  6.     ASSERT_EQ(bmp->exists("exchange2", "queue1"), true);
  7.     ASSERT_EQ(bmp->exists("exchange2", "queue2"), true);
  8.     ASSERT_EQ(bmp->exists("exchange2", "queue3"), true);
  9.     ASSERT_EQ(bmp->exists("exchange2", "queue4"), false);
  10.     bitmq::Binding::ptr bxp1 = bmp->getBinding("exchange1", "queue1");
  11.     ASSERT_NE(bxp1.get(), nullptr);
  12.     ASSERT_EQ(bxp1->exchange_name, "exchange1");
  13.     ASSERT_EQ(bxp1->msgqueue_name, "queue1");
  14.     ASSERT_EQ(bxp1->binding_key, "news.music.#");   
  15.     ASSERT_EQ(bxp1->durable, true);   
  16. }
复制代码
运行结果:

   测试查找指定交换机
  1. TEST(binding_test, select_exchange_test)
  2. {
  3.     bitmq::BindingManager::MsgQueueBindingMap mqbm = bmp->getExchangeBindings("exchange1");
  4.     ASSERT_EQ(mqbm.size(), 3);
  5.     ASSERT_NE(mqbm.find("queue1"), mqbm.end());
  6.     ASSERT_NE(mqbm.find("queue3"), mqbm.end());
  7. }
复制代码
运行结果:

   测试删除指定队列功能
  1. TEST(binding_test, remove_queue_test)
  2. {
  3.     bmp->removeMsgQueueBindings("queue1");
  4.     ASSERT_EQ(bmp->exists("exchange1", "queue1"), false);
  5.     ASSERT_EQ(bmp->exists("exchange2", "queue1"), false);
  6. }
复制代码
运行结果:

数据库:

   测试删除指定交换机功能
  1. TEST(binding_test, remove_exchange_test)
  2. {
  3.     bmp->removeExchangeBindings("exchange1");
  4.     ASSERT_EQ(bmp->exists("exchange1", "queue1"), false);
  5.     ASSERT_EQ(bmp->exists("exchange1", "queue2"), false);
  6.     ASSERT_EQ(bmp->exists("exchange1", "queue3"), false);
  7. }
复制代码
运行结果:

数据库:

   测试删除指定绑定信息
  1. TEST(binding_test, remove_single_test)
  2. {
  3.     ASSERT_EQ(bmp->exists("exchange2", "queue2"), true);
  4.     bmp->unBind("exchange2", "queue2");
  5.     ASSERT_EQ(bmp->exists("exchange2", "queue2"), false);
  6.     ASSERT_EQ(bmp->exists("exchange2", "queue3"), true);
  7. }
复制代码
运行结果:

数据库:

   恢复历史消息功能
  颠末前面的操作,数据库中只剩下了exchange2和queue3的绑定了,我们屏蔽掉其他操作,只实行下面这段代码,如果实行成功,则可以阐明恢复功能没有问题。
  1. TEST(binding_test, recovery_test)
  2. {
  3.     ASSERT_EQ(bmp->exists("exchange2", "queue3"), true);
  4.     ASSERT_EQ(bmp->exists("exchange1", "queue1"), false);
  5.     ASSERT_EQ(bmp->exists("exchange1", "queue2"), false);
  6.     ASSERT_EQ(bmp->exists("exchange1", "queue3"), false);
  7.     ASSERT_EQ(bmp->exists("exchange2", "queue1"), false);
  8.     ASSERT_EQ(bmp->exists("exchange2", "queue2"), false);
  9. }
复制代码
运行结果:


8.7 队列消息管理

由于消息数据需要在网络中举行传输,因此消息的范例定义使用 protobuf 举行,由于protobuf 中自带了序列化和反序列化功能,因此操作起来会简便一些。
需要特殊阐明的是,消息的存储并没有使用数据库,由于消息长度通常不定,且有些消息可能会非常庞大,因此并不得当存储在数据库中,因此我们的处理方式(包括RabbitMQ)是直接将消息存储在文件中举行管理,而内存中管理的消息只需要记载好本身在文件中的地点位置和长度即可。
为了便于管理,消息管理以队列为单元举行管理,因此每个队列都会有本身独立的数据存储文件。


1.消息的要素


  • 1.网络传输的消息要素:

    • 1)消息属性:消息id消息routing_key长期化标志
    • 2)消息的实际内容:数据

  • 2.服务器上的消息管理所需的额外要素(主要是为了长期化管理)

    • 1)消息有效标志:这个字段是需要随着消息的长期化内容一起举行长期化,每一条消息都有可能要举行长期化存储,比及推送给客户端就会删撤除,然而每次删除一条消息就重写一次文件,服从太低下,如果设置了有效标志位,每次只需要将这个有效标志位对应的数据给修改成无效即可。
    • 2)消息的实际存储位置(相对于文件起始位置的偏移量):当要删除某条消息时,需要重写覆盖这条消息在文件的对应位置(将有效标志位置设置为无效),这时候就需要能够找到这条消息。
    • 3)消息的长度:当恢复历史消息以及读取消息内容时,需要办理粘包问题


2. 消息的长期化管理


  • 1)不使用数据库:有些消息庞大,不得当数据库,其次消息的长期化主要是为了备份,而不是为了查询,因此直接使用文件举行存储。
  • 2)以队列为单元举行消息的长期化管理:每个队列都有一个本身的数据文件,当消息文件垃圾接纳时,需要重写加载全部有效消息,重新生成新的数据文件。但是,生成新的数据文件后,消息的存储位置就发生了改变,这时候需要更新内存中的数据。
  • 3)数据存储在文件中,必然要有数据格式的要求:
    通过4字节长度,描述消息实际存储长度可以办理粘包问题。
a. 管理数据


  • 1)队列名
  • 2)队列消息的存储文件名
  • 3)队列消息的临时交换文件名
b. 管理操作


  • 2)队列消息文件创建/删除功能
  • 3)提供队列消息的新增长期化/删除长期化
  • 4)提供长期化内容的垃圾接纳(其实就是重新加载出全部有效消息返回,并重新生成新的消息存储文件)
   什么时候需要垃圾接纳
  由于每次删除数据都不是真正的删除,因此文件中的数据会越来越多,但是也不是每次删除都需要接纳,当文件中有效消息超过2000条,且其中有效消息比例低于50%时才会举行垃圾接纳。
   接纳头脑
  加载文件中全部有效消息,先写入到一个临时文件中,然后再去删除源文件,将临时文件名称改为源文件名称,最后返回全部的有效消息。

3. 消息的管理(以队列为单元举行管理)
a. 队列消息管理数据


  • 1)队列名称
  • 2)待推送消息链表(尾插头删模仿队列)
  • 3)长期化消息 hash:垃圾接纳后需要更新消息数据,hash O(1)时间即可找到对应消息
  • 4)待确认消息 hash:一条消息被推送给客户端,并不会立刻删除,而是比及被确认后才会删除。一条消息被推送给客户端后,取出待推送消息链表,参加到待确认结构中,等确认后再删除。
  • 5)有效消息数目
  • 6)已经长期化消息总量:可以和有效消息数目计算出是否需要垃圾接纳
  • 7)长期化管理句柄
b. 队列管理操作


  • 1)新增消息
  • 2)获取队首消息(获取的同时将消息参加待确认队列)
  • 3)移除指定消息
  • 4)获取队列待消费消息数目
  • 5)获取队列待确认消息数目
  • 6)获取长期化消息数目
  • 7)恢复队列历史消息(构造时)。
  • 8)销毁队列全部消息
  • 9)判断队列消息是否为空

4. 消息的总体对外管理
a.管理的成员


  • 互斥锁
  • 每个队列的消息管理句柄:队列名称和队列消息管理句柄的hash表
b.提供的操作


  • 1)初始化新建队列的消息管理句柄,并创建消息存储文件
  • 2)删除队列的消息管理句柄,以及消息存储文件
  • 3)向指定队列新增消息
  • 4)获取指定队列队首消息
  • 5)确认指定队列待确认消息
  • 6)获取指定队列消息数目(待发送消息数目,长期化消息数目,待确认消息数目,总的消息数目)
  • 7)恢复队列历史消息


   声明消息的要素类
  在8.3时,我们就使用protobuf完成了消息的要素类。

为什么要使用protobuf编写Message类:
由于Message需要颠末网络传输,即需要序列化与反序列化工作,而我们本身手写序列化和反序列化较为贫苦,所以使用protobuf可以变得更加简单高效。
Message中的valid字段为什么要设置为string而不是bool:
protobuf中的bool范例颠末编码后可能会导致长度差别等的问题,所以我们使用string来保证长度同等,"1"表示有效,"0"表示无效。
   声明消息的长期化管理类
  1. #define DATAFILE_SUBFIX ".mqd"
  2. #define TEMPFILE_SUBFIX ".mqd.temp"
  3. using MessagePtr = std::shared_ptr<bitmq::Message>;
  4. class MessageMapper
  5. {
  6. public:
  7.     MessageMapper(std::string& basedir, const std::string& qname)
  8.     { }
  9.     //1)创建队列消息文件
  10.     void createMsgFile();
  11.     //2)删除队列消息文件
  12.     void removeMsgFile();
  13.     //3)队列消息的新增持久化
  14.     void insert(MessagePtr& msg);
  15.     //4)队列消息的删除持久化
  16.     void remove(const MessagePtr& msg);
  17.     //5)提供持久化内容的垃圾回收
  18.     std::list<MessagePtr> gc();
  19. private:   
  20.     std::string _qname;     // 1)队列名
  21.     std::string _datafile;  // 2)队列消息的存储文件名
  22.     std::string _tempfile;  // 3)队列消息的临时交换文件名
复制代码
该类是数据长期化类,主要功能就是完成向文件中写入数据和删除数据的功能以及举行垃圾接纳,垃圾接纳的思绪是将有效数据先写入临时文件当中,再将源文件删除,最后将临时文件改名为源文件。
   声明队列消息管理类
  1. //队列消息管理
  2. class QueueMessage
  3. {
  4. public:
  5.     QueueMessage(std::string& basedir, const std::string& qname)
  6.     {}
  7.     // 1)新增消息
  8.     bool insert(const BasicProperties* bp, const std::string& body);
  9.     // 2)移除指定消息
  10.     bool remove(const std::string& msg_id);
  11.     // 3)获取队首消息(获取的同时将消息加入待确认队列)
  12.     MessagePtr front();
  13.     // 4)获取队列待消费消息数量
  14.     size_t push_count();
  15.     // 5)获取队列待确认消息数量
  16.     size_t waitack_count();
  17.     // 6)获取持久化消息数量
  18.     size_t durable_count();
  19.     // 7)总的消息数量
  20.     size_t total_count();
  21.     // 8)销毁队列所有消息
  22.     void clear();
  23. private:
  24.     std::string _qname;   // 1)队列名称
  25.     size_t _valid_count;  // 2)有效消息数量
  26.     size_t _total_count;  // 3)已经持久化消息总量
  27.     MessageMapper _mapper;    // 4)持久化管理句柄
  28.     std::list<MessagePtr> _msgs;   // 5)待推送消息链表(头插尾删模拟队列)
  29.     std::unordered_map<std::string, MessagePtr> _durable_msgs;  // 6)持久化消息 hash
  30.     std::unordered_map<std::string, MessagePtr> _waitack_msgs;  // 7)待确认消息 hash
  31. };
复制代码
该类需要完成对消息的管理工作,负责消息的增删查功能。
   声明消息总体对外管理类
  1. class MessageManager
  2. {
  3. public:
  4.     MessageManager(const std::string& basedir) //目录
  5.     {}
  6.     //1)初始化新建队列的消息管理句柄,并创建消息存储文件
  7.     void initQueueMessage(const std::string& qname);
  8.     // 2)删除队列的消息管理句柄,以及消息存储文件
  9.     void destroyQueueMessage(const std::string& qname);
  10.     // 3)向指定队列新增消息
  11.     bool insert(const std::string& qname, const BasicProperties* bp, const std::string& body, DeliveryMode delivery_mode);
  12.     // 4)获取指定队列队首消息
  13.     MessagePtr front(const std::string& qname);
  14.     // 5)确认指定队列待确认消息
  15.     void ack(const std::string& qname, const std::string msg_id);
  16.     // 4)获取队列待消费消息数量
  17.     size_t getable_count(const std::string& qname);
  18.     // 5)获取队列待确认消息数量
  19.     size_t waitack_count(const std::string& qname);
  20.     // 6)获取持久化消息数量
  21.     size_t durable_count(const std::string& qname);
  22.     // 7)总的消息数量
  23.     size_t total_count(const std::string& qname);
  24. private:
  25.     std::mutex _mutex;
  26.     std::string _basedir;
  27.     std::unordered_map<std::string, QueueMessage::ptr> _queue_msgs;
  28. };
复制代码
MessageManager是总的管理类,他会管理多个队列消息管理类,所以该类的全部成员函数都包含qname字段(队列名称),只有知道是哪个队列才能实行具体操作。


以上是消息管理的框架部分,接下来我们需要完成具体实现。
   定义消息长期化类
  1. #define DATAFILE_SUBFIX ".mqd"
  2. #define TEMPFILE_SUBFIX ".mqd.temp"
  3. using MessagePtr = std::shared_ptr<bitmq::Message>;
  4. class MessageMapper
  5. {
  6. public:
  7.     MessageMapper()
  8.     {}
  9.    
  10.     MessageMapper(std::string& basedir, const std::string& qname)
  11.         : _qname(qname)
  12.     {
  13.         if (basedir.back() != '/')
  14.             basedir += '/';
  15.         _datafile = basedir + qname + DATAFILE_SUBFIX;
  16.         _tempfile = basedir + qname + TEMPFILE_SUBFIX;
  17.         if (FileHelper(basedir).exists() == false)
  18.             assert(FileHelper::createDirectory(basedir));
  19.         createMsgFile();
  20.     }
  21.     //1)创建队列消息文件
  22.     bool createMsgFile()
  23.     {
  24.         //已经存在则不需要创建
  25.         if (FileHelper(_datafile).exists() == true)
  26.             return true;
  27.         bool ret = FileHelper::createFile(_datafile);
  28.         if (ret == false)
  29.         {
  30.             DLOG("创建队列数据文件 %s 失败", _datafile.c_str());
  31.             return false;
  32.         }
  33.         return true;
  34.     }
  35.     //2)删除队列消息文件
  36.     void removeMsgFile()
  37.     {
  38.         FileHelper::removeFile(_datafile);
  39.         FileHelper::removeFile(_tempfile);
  40.     }
  41.     //3)队列消息的新增持久化
  42.     bool insert(MessagePtr& msg)
  43.     {
  44.         return insert(_datafile, msg);
  45.     }
  46.     //4)队列消息的删除持久化
  47.     bool remove(const MessagePtr& msg)
  48.     {
  49.         //1.将msg中的valid修改成'0'(注意这里的valid是string类型)
  50.         msg->mutable_payload()->set_valid("0");
  51.         //2.将msg进行序列化
  52.         std::string body = msg->payload().SerializeAsString();
  53.         if (body.size() != msg->length())
  54.         {
  55.             DLOG("不能修改文件中的数据信息,因为新生成的数据与原数据长度不一致");
  56.             return false;
  57.         }
  58.         //3.将序列化的消息,写入到数据在文件中的指定位置
  59.         FileHelper helper(_datafile);
  60.         bool ret = helper.write(body.c_str(), msg->offset(), body.size());
  61.         if (ret == false)
  62.         {
  63.             DLOG("向队列数据文件写入数据失败!");
  64.             return false;
  65.         }
  66.         return true;
  67.     }
  68.     //5)提供持久化内容的垃圾回收
  69.     std::list<MessagePtr> gc()
  70.     {
  71.         //1.加载出文件中所有的有效数据
  72.         std::list<MessagePtr> result = load();   
  73.         DLOG("垃圾回收得到的有效消息数量:%d", result.size());
  74.         //2.将有效数据,进行序列化存储到临时文件中
  75.         FileHelper::createFile(_tempfile);
  76.         for (auto& msg : result)
  77.         {
  78.             if (insert(_tempfile, msg) == false)
  79.             {
  80.                 DLOG("向临时文件写入消息数据失败!");
  81.                 return result;
  82.             }
  83.         }
  84.         DLOG("垃圾回收后,向临时文件写入数据完毕,临时文件大小:%d", FileHelper(_tempfile).size());
  85.         //3.删除源文件
  86.         if (FileHelper::removeFile(_datafile) == false)
  87.         {
  88.             DLOG("删除源文件失败!");
  89.             return result;
  90.         }
  91.         //4.修改临时文件名,为源文件名称
  92.         if (FileHelper(_tempfile).renameFile(_datafile) == false)
  93.         {
  94.             DLOG("修改文件名失败!");
  95.             return result;
  96.         }
  97.         //5.返回新的有效数据
  98.         return result;
  99.     }
  100.     std::list<MessagePtr> load()
  101.     {
  102.         std::list<MessagePtr> result;
  103.         //1.加载出文件中所有的有效数据
  104.         FileHelper helper(_datafile);
  105.         size_t offset = 0, msg_size = 0;
  106.         size_t fsize = helper.size();
  107.         DLOG("准备开始持久化数据,当前文件大小:%d", FileHelper(_datafile).size());
  108.         while (offset < fsize)
  109.         {
  110.             if (helper.read((char*)&msg_size, offset, sizeof(msg_size)) == false)
  111.             {
  112.                 DLOG("读取消息长度失败!!");
  113.                 return {};
  114.             }
  115.             offset += sizeof(msg_size);
  116.             std::string body(msg_size, '\0');
  117.             if (helper.read(&body[0], offset, msg_size) == false)
  118.             {
  119.                 DLOG("读取消息长度失败!!");
  120.                 return {};
  121.             }
  122.             offset += msg_size;
  123.             //将body反序列化成对象
  124.             auto nmp = std::make_shared<Message>();
  125.             nmp->mutable_payload()->ParseFromString(body);
  126.             //如果该消息无效,则不添加,直接处理下一个
  127.             if (nmp->payload().valid() == "0")
  128.                 continue;
  129.             //将有效数据保存至list中
  130.             result.push_back(nmp);
  131.         }
  132.         return result;
  133.     }
  134. private:
  135.     //3)队列消息的新增持久化
  136.     bool insert(const std::string& filename, MessagePtr& msg)
  137.     {
  138.         //新增数据都是添加在文件末尾
  139.         //1.消息的序列化,得到格式化后的消息
  140.         std::string body = msg->payload().SerializeAsString(); //只需要序列化有效载荷部分
  141.         //2.获取文件长度
  142.         FileHelper helper(filename);
  143.         size_t fsize = helper.size();
  144.         size_t msize = body.size();
  145.         //3.先向文件中写入数据长度
  146.         bool ret = helper.write((char*)&msize, fsize, sizeof(msize));
  147.         fsize += sizeof(msize);
  148.         //4.将数据写入文件指定位置
  149.         ret = helper.write(body.c_str(), fsize, body.size());
  150.         if (ret == false)
  151.         {
  152.             DLOG("向队列数据文件写入数据失败!");
  153.             return false;
  154.         }
  155.         //5.更新msg中的实际存储信息
  156.         msg->set_offset(fsize);
  157.         msg->set_length(body.size());
  158.         return true;
  159.     }
  160. private:   
  161.     std::string _qname;     // 1)队列名
  162.     std::string _datafile;  // 2)队列消息的存储文件名
  163.     std::string _tempfile;  // 3)队列消息的临时交换文件名
  164. };
复制代码


  • 构造函数:构造函数需要传递一个基础目录地址,以及一个队列名称,将来长期化的数据文件将会生存至该目录下,长期化数据文件是以队列名称举行定名的。在构造函数部分会完成目录和文件的创建
  • insert:将传递进来的Message对象写入长期化文件当中,需要留意的是,并不是整个Message对象都需要长期化,只需要长期化其中的Payload部分。还需要留意我们的存储格式,前4个字节存储有效载荷的大小,反面才是真正的有效载荷部分。

  • remove:该函数是要删除文件中的数据,但这个删除并不是真正的删除,而是将对应的数据中的valid标志位设置成0,在垃圾接纳时会过滤到无效信息。而想要将valid标志位置0,只能重新构造一个对象,然后将序列化的数据覆盖回源数据。
  • load:将文件中的有效信息读取出来,其实也就是文件中的全部字节流数据反序列化回对象,然后根据对象中的valid标志判断该对象是否是有效信息,如果有就生存起来,没有则丢弃。
  • gc:垃圾接纳机制,通过load函数获取全部有效信息,然后将有效信息写入临时文件,再删除源文件,将临时文件重新定名为源文件。

   定义队列消息管理类
  1. //队列消息管理
  2. class QueueMessage
  3. {
  4. public:
  5.     using ptr = std::shared_ptr<QueueMessage>;
  6.     QueueMessage(std::string& basedir, const std::string& qname)
  7.         : _mapper(basedir, qname)
  8.         , _qname(qname)
  9.         , _valid_count(0)
  10.         , _total_count(0)
  11.     {
  12.     }
  13.     void recovery()
  14.     {
  15.         std::unique_lock<std::mutex> lock(_mutex);
  16.         _msgs = _mapper.gc();
  17.         for (auto& msg : _msgs)
  18.         {
  19.             _durable_msgs.insert({msg->payload().properties().id(), msg});
  20.         }
  21.         _valid_count = _total_count = _durable_msgs.size();
  22.     }
  23.     // 1)新增消息
  24.     bool insert(const BasicProperties* bp, const std::string& body, DeliveryMode delivery_mode)
  25.     {
  26.         //1.构造对象
  27.         MessagePtr msg = std::make_shared<Message>();
  28.         msg->mutable_payload()->set_body(body);
  29.         if (bp != nullptr)
  30.         {
  31.             msg->mutable_payload()->mutable_properties()->set_id(bp->id());
  32.             msg->mutable_payload()->mutable_properties()->set_delivery_mode(bp->delivery_mode());
  33.             msg->mutable_payload()->mutable_properties()->set_routing_key(bp->routing_key());
  34.         }
  35.         else  
  36.         {
  37.             msg->mutable_payload()->mutable_properties()->set_id(UUIDHelper::uuid());
  38.             msg->mutable_payload()->mutable_properties()->set_delivery_mode(delivery_mode);
  39.             msg->mutable_payload()->mutable_properties()->set_routing_key("");
  40.         }
  41.         std::unique_lock<std::mutex> lock(_mutex);
  42.         //2.判断消息是否需要持久化存储
  43.         if (msg->payload().properties().delivery_mode() == DeliveryMode::DURABLE)
  44.         {
  45.             msg->mutable_payload()->set_valid("1");
  46.             //3.进行持久化存储
  47.             if (_mapper.insert(msg) == false)
  48.             {
  49.                 DLOG("持久化消息 %s 失败", body.c_str());
  50.                 return false;
  51.             }
  52.             _valid_count += 1;
  53.             _total_count += 1;
  54.             _durable_msgs.insert({msg->payload().properties().id(), msg});
  55.         }
  56.         //4.内存的管理
  57.         _msgs.push_back(msg);
  58.         return true;
  59.     }
  60.     // 2)移除指定消息(用于收到确认消息后对消息删除)
  61.     bool remove(const std::string& msg_id)
  62.     {
  63.         std::unique_lock<std::mutex> lock(_mutex);
  64.         //1.从待确认队列中查找消息
  65.         auto it = _waitack_msgs.find(msg_id);
  66.         if (it == _waitack_msgs.end())
  67.         {
  68.             DLOG("没有找到要删除的消息");
  69.             return true;
  70.         }
  71.         //2.根据消息的持久化模式,决定是否需要删除持久化信息
  72.         if (it->second->payload().properties().delivery_mode() == DeliveryMode::DURABLE)
  73.         {
  74.             //3.删除持久化信息
  75.             _mapper.remove(it->second);
  76.             _durable_msgs.erase(msg_id);
  77.             _valid_count -= 1;
  78.             //4.判断是否需要垃圾回收
  79.             if (_total_count >= 2000 && _valid_count * 1.0 / _total_count <= 0.5)
  80.             {
  81.                 gc();
  82.             }
  83.         }
  84.         //5.删除内存中的信息
  85.         _waitack_msgs.erase(msg_id);
  86.         return true;
  87.     }
  88.     // 3)获取队首消息(获取的同时将消息加入待确认队列)
  89.     MessagePtr front()
  90.     {
  91.         std::unique_lock<std::mutex> lock(_mutex);
  92.         //从带推送消息链表中获取一条队首消息
  93.         if (_msgs.empty())
  94.         {
  95.             DLOG("待推送消息队列中没有消息!");
  96.             return {};
  97.         }
  98.         MessagePtr msg = _msgs.front();
  99.         _msgs.pop_front();
  100.         if (msg.get() == nullptr)
  101.             return {};
  102.         //将该消息添加至待确认hash表中,等到消息得到确认后再删除。
  103.         _waitack_msgs.insert({msg->payload().properties().id(), msg});
  104.         return msg;
  105.     }
  106.     // 4)获取队列待消费消息数量
  107.     size_t getable_count()
  108.     {
  109.         std::unique_lock<std::mutex> lock(_mutex);
  110.         return _msgs.size();
  111.     }
  112.     // 5)获取队列待确认消息数量
  113.     size_t waitack_count()
  114.     {
  115.         std::unique_lock<std::mutex> lock(_mutex);
  116.         return _waitack_msgs.size();
  117.     }
  118.     // 6)获取持久化消息数量
  119.     size_t durable_count()
  120.     {
  121.         std::unique_lock<std::mutex> lock(_mutex);
  122.         return _durable_msgs.size();
  123.     }
  124.     // 7)总的消息数量
  125.     size_t total_count()
  126.     {
  127.         std::unique_lock<std::mutex> lock(_mutex);
  128.         return _total_count;  
  129.     }
  130.     // 8)销毁队列所有消息
  131.     void clear()
  132.     {
  133.         std::unique_lock<std::mutex> lock(_mutex);
  134.         _mapper.removeMsgFile();
  135.         _msgs.clear();
  136.         _durable_msgs.clear();
  137.         _waitack_msgs.clear();
  138.         _valid_count = 0;
  139.         _total_count = 0;
  140.     }
  141. private:
  142.     void gc()
  143.     {
  144.         //1.进行垃圾回收,获取垃圾回收后,有效消息链表
  145.         std::list<MessagePtr> msgs = _mapper.gc();
  146.         for (auto& msg : msgs)
  147.         {
  148.             auto it = _durable_msgs.find(msg->payload().properties().id());
  149.             if (it == _durable_msgs.end())
  150.             {
  151.                 DLOG("垃圾回收后,有一条持久化消息,在内存中没有进行管理!");
  152.                 _durable_msgs.insert({msg->payload().properties().id(), msg});
  153.                 _msgs.push_back(msg); //重新添加到推送链表
  154.             }
  155.             //2.更新每一条消息的实际存储位置
  156.             it->second->set_offset(msg->offset());
  157.             it->second->set_length(msg->length());
  158.         }
  159.         //3.更新当前的有效消息数量和总的持久化消息数量
  160.         _valid_count = _total_count = msgs.size();
  161.     }
  162. private:
  163.     std::mutex _mutex;
  164.     std::string _qname;   // 1)队列名称
  165.     size_t _valid_count;  // 2)有效消息数量
  166.     size_t _total_count;  // 3)已经持久化消息总量
  167.     MessageMapper _mapper;    // 4)持久化管理句柄
  168.     std::list<MessagePtr> _msgs;   // 5)待推送消息链表(头插尾删模拟队列)
  169.     std::unordered_map<std::string, MessagePtr> _durable_msgs;  // 6)持久化消息 hash
  170.     std::unordered_map<std::string, MessagePtr> _waitack_msgs;  // 7)待确认消息 hash
  171. };
复制代码


  • _msgs对象是待推送消息链表,他是负责内存消息的管理,也就是说新增的消息不管是否长期化都会在_msgs中生存一份,将来获取消息时,也是直接从_msgs对象中获取。
  • _durable_msgs是长期化消息hash表,他主要负责文件消息的管理,也就是说它生存了全部长期化的消息,,我们可以通过该结构查看哪些消息被长期化了。
  • _waitack_msgs是待确认消息hash表,当一条消息发送后,就会进入待确认消息hash表中,直到收到了确认消息才会将该消息删除(同时也会删除文件中长期化的消息)
  • insert:三个参数其实就是一条消息的有效载荷部分,在新增消息时如果该消息是要长期化的不要忘记修改_valid_count和_total_count变量,这两个变量是决定是否需要垃圾接纳的。
  • front:从待推送消息链表队首获取一条消息,也就是说这条消息被推送给了用户,所以需要将该消息参加待确认消息hash表中,比及消息得到确认后再删除。
  • remove:根据指定的消息id删除对应的消息,如果消息被长期化了,就需要删除长期化信息。
   定义队列管理类
  1. class MessageManager
  2. {
  3. public:
  4.     using ptr = std::shared_ptr<MessageManager>;
  5.     MessageManager(const std::string& basedir) //目录
  6.         : _basedir(basedir)
  7.     {
  8.         //该类在重启时应该将队列管理信息数据从磁盘中读取到内存。
  9.         //但是需要所有的队列名称
  10.         //而队列名称获取可以通过mq_queue.hpp中MsgQueueManager的getAll获取
  11.         //但是这样做会将两个模块耦合在一起,所以在这里不用恢复,而是将该工作放到虚拟机部分完成
  12.     }
  13.     void clear()
  14.     {
  15.         std::unique_lock<std::mutex> lock(_mutex);
  16.         for (auto& qmsg : _queue_msgs)
  17.             qmsg.second->clear();
  18.     }
  19.     //1)初始化新建队列的消息管理句柄,并创建消息存储文件
  20.     void initQueueMessage(const std::string& qname)
  21.     {
  22.         QueueMessage::ptr qmp;
  23.         {
  24.             std::unique_lock<std::mutex> lock(_mutex);
  25.             auto it = _queue_msgs.find(qname);
  26.             if (it != _queue_msgs.end())
  27.                 return;
  28.             qmp = std::make_shared<QueueMessage>(_basedir, qname);
  29.             _queue_msgs.insert({qname, qmp});
  30.         }
  31.         qmp->recovery();
  32.     }
  33.     // 2)删除队列的消息管理句柄,以及消息存储文件
  34.     void destroyQueueMessage(const std::string& qname)
  35.     {
  36.         QueueMessage::ptr qmp;
  37.         {
  38.             std::unique_lock<std::mutex> lock(_mutex);
  39.             auto it = _queue_msgs.find(qname);
  40.             if (it == _queue_msgs.end())
  41.                 return;
  42.             qmp = it->second;
  43.             _queue_msgs.erase(qname);
  44.         }
  45.         qmp->clear();
  46.     }
  47.     // 3)向指定队列新增消息
  48.     bool insert(const std::string& qname, const BasicProperties* bp, const std::string& body, DeliveryMode delivery_mode)
  49.     {
  50.         QueueMessage::ptr qmp;
  51.         {
  52.             std::unique_lock<std::mutex> lock(_mutex);
  53.             auto it = _queue_msgs.find(qname);
  54.             if (it == _queue_msgs.end())
  55.             {
  56.                 DLOG("向队列%s新增消息失败:没有找到消息句柄!", qname.c_str());
  57.                 return false;
  58.             }
  59.             qmp = it->second;
  60.         }
  61.         qmp->insert(bp, body, delivery_mode);
  62.         return true;
  63.     }
  64.    
  65.     // 4)获取指定队列队首消息
  66.     MessagePtr front(const std::string& qname)
  67.     {
  68.         QueueMessage::ptr qmp;
  69.         {
  70.             std::unique_lock<std::mutex> lock(_mutex);
  71.             auto it = _queue_msgs.find(qname);
  72.             if (it == _queue_msgs.end())
  73.             {
  74.                 DLOG("获取队列%s首消息失败:没有找到消息句柄!", qname.c_str());
  75.                 return {};
  76.             }
  77.             qmp = it->second;
  78.         }
  79.         return qmp->front();
  80.     }
  81.     // 5)确认指定队列待确认消息
  82.     void ack(const std::string& qname, const std::string msg_id)
  83.     {
  84.         QueueMessage::ptr qmp;
  85.         {
  86.             std::unique_lock<std::mutex> lock(_mutex);
  87.             auto it = _queue_msgs.find(qname);
  88.             if (it == _queue_msgs.end())
  89.             {
  90.                 DLOG("确认队列%s中%s消息失败:没有找到消息句柄!", qname.c_str(), msg_id.c_str());
  91.                 return;
  92.             }
  93.             qmp = it->second;
  94.         }
  95.         qmp->remove(msg_id);
  96.         return;
  97.     }
  98.     // 4)获取队列待消费消息数量
  99.     size_t getable_count(const std::string& qname)
  100.     {
  101.         QueueMessage::ptr qmp;
  102.         {
  103.             std::unique_lock<std::mutex> lock(_mutex);
  104.             auto it = _queue_msgs.find(qname);
  105.             if (it == _queue_msgs.end())
  106.             {
  107.                 DLOG("获取队列%s中待推送消息失败:没有找到消息句柄!", qname.c_str());
  108.                 return 0;
  109.             }
  110.             qmp = it->second;
  111.         }
  112.         return qmp->getable_count();
  113.     }
  114.     // 5)获取队列待确认消息数量
  115.     size_t waitack_count(const std::string& qname)
  116.     {
  117.         QueueMessage::ptr qmp;
  118.         {
  119.             std::unique_lock<std::mutex> lock(_mutex);
  120.             auto it = _queue_msgs.find(qname);
  121.             if (it == _queue_msgs.end())
  122.             {
  123.                 DLOG("获取队列%s中待确认消息失败:没有找到消息句柄!", qname.c_str());
  124.                 return 0;
  125.             }
  126.             qmp = it->second;
  127.         }
  128.         return qmp->waitack_count();
  129.     }
  130.     // 6)获取持久化消息数量
  131.     size_t durable_count(const std::string& qname)
  132.     {
  133.         QueueMessage::ptr qmp;
  134.         {
  135.             std::unique_lock<std::mutex> lock(_mutex);
  136.             auto it = _queue_msgs.find(qname);
  137.             if (it == _queue_msgs.end())
  138.             {
  139.                 DLOG("获取队列%s中持久化u消息失败:没有找到消息句柄!", qname.c_str());
  140.                 return 0;
  141.             }
  142.             qmp = it->second;
  143.         }
  144.         return qmp->durable_count();
  145.     }
  146.     // 7)总的消息数量
  147.     size_t total_count(const std::string& qname)
  148.     {
  149.         QueueMessage::ptr qmp;
  150.         {
  151.             std::unique_lock<std::mutex> lock(_mutex);
  152.             auto it = _queue_msgs.find(qname);
  153.             if (it == _queue_msgs.end())
  154.             {
  155.                 DLOG("获取队列%s中总消息数量失败:没有找到消息句柄!", qname.c_str());
  156.                 return 0;
  157.             }
  158.             qmp = it->second;
  159.         }
  160.         return qmp->total_count();
  161.     }
  162. private:
  163.     std::mutex _mutex;
  164.     std::string _basedir;
  165.     std::unordered_map<std::string, QueueMessage::ptr> _queue_msgs;
  166. };
复制代码
值得阐明的是,该类的构造函数理论上来说需要从恢复全部的长期化队列消息管理类,通过QueueMessage中的recovevry函数就可以恢复,但是想要做到这一点就需要队列的名称,也就是说我们需要全部队列的名称才可以恢复数据,而全部队列的名称信息在mq_queue.hpp中的getAllQueues函数中获取。

如果如许做会导致模块与模块间的耦合性较强,不利于封装头脑,所以我们并不是在这个地方完成数据恢复功能,而是在虚拟机管理处手动调用initQueueMessage举行恢复。
   为什么MessageManager类全部成员函数都是下面的写法二而不是写法一
  写法一:
  1. //1)初始化新建队列的消息管理句柄,并创建消息存储文件
  2. void initQueueMessage(const std::string& qname)
  3. {
  4.     std::unique_lock<std::mutex> lock(_mutex);
  5.     auto it = _queue_msgs.find(qname);
  6.     if (it != _queue_msgs.end())
  7.         return;
  8.     QueueMessage::ptr qmp = std::make_shared<QueueMessage>(_basedir, qname);
  9.     _queue_msgs.insert({qname, qmp});
  10.     qmp->recovery();
  11. }
复制代码
前面我们写的全部需要加锁的类险些都是如许写的(纵然用锁锁住整个函数,当前函数调用完才会释放锁),而MessageManager类却不能如许写。
写法二:
  1. //1)初始化新建队列的消息管理句柄,并创建消息存储文件
  2. void initQueueMessage(const std::string& qname)
  3. {
  4.     QueueMessage::ptr qmp;
  5.     {
  6.         std::unique_lock<std::mutex> lock(_mutex);
  7.         auto it = _queue_msgs.find(qname);
  8.         if (it != _queue_msgs.end())
  9.             return;
  10.         qmp = std::make_shared<QueueMessage>(_basedir, qname);
  11.         _queue_msgs.insert({qname, qmp});
  12.     }
  13.     qmp->recovery();
  14. }
复制代码
可以看到两者唯一的区别就是qmp->recovery()这句话是否被锁住了,下面这种写法更好的原因在于QueueMessage类内部就有一把锁,已经可以保证线程安全了,如果在将这句话也锁住,会导致锁冲突问题,而recovery的恢复数据的速率较慢,会影响其他线程的操作,所以这句话可以不被锁管理,大大进步了多进程并发服从。


单元测试:
   测试插入消息功能
  1. #include "../../mqserver/mq_message.hpp"
  2. #include <gtest/gtest.h>
  3. bitmq::MessageManager::ptr msgp;
  4. class MessageTest : public testing::Environment
  5. {
  6. public:
  7.     virtual void SetUp() override
  8.     {
  9.         msgp = std::make_shared<bitmq::MessageManager>("./data/message/");
  10.         msgp->initQueueMessage("queue1");
  11.     }
  12.     virtual void TearDown() override
  13.     {
  14.         //msgp->clear();
  15.     }
  16. };
  17. TEST(message_test, insert_test)
  18. {
  19.     bitmq::BasicProperties bp;
  20.     bp.set_id(bitmq::UUIDHelper::uuid());
  21.     bp.set_delivery_mode(bitmq::DeliveryMode::DURABLE);
  22.     bp.set_routing_key("news.music.pop");
  23.     msgp->insert("queue1", &bp, "Hello World-1", bitmq::DeliveryMode::DURABLE);
  24.     msgp->insert("queue1", nullptr, "Hello World-2", bitmq::DeliveryMode::DURABLE);
  25.     msgp->insert("queue1", nullptr, "Hello World-3", bitmq::DeliveryMode::DURABLE);
  26.     msgp->insert("queue1", nullptr, "Hello World-4", bitmq::DeliveryMode::UNDURABLE);
  27.     msgp->insert("queue1", nullptr, "Hello World-5", bitmq::DeliveryMode::DURABLE);
  28.     msgp->insert("queue1", nullptr, "Hello World-6", bitmq::DeliveryMode::DURABLE);
  29.     ASSERT_EQ(msgp->total_count("queue1"), 5);
  30.     ASSERT_EQ(msgp->durable_count("queue1"), 5);
  31.     ASSERT_EQ(msgp->getable_count("queue1"), 6);
  32.     ASSERT_EQ(msgp->waitack_count("queue1"), 0);
  33. }
  34. int main(int argc, char* argv[])
  35. {
  36.     testing::InitGoogleTest(&argc, argv);
  37.     testing::AddGlobalTestEnvironment(new MessageTest);
  38.     RUN_ALL_TESTS();
  39.     return 0;
  40. }
复制代码
在该测试中我们插入6条消息,其中5条是长期化的,1条是非长期化的。
实行结果:

实行结果没有问题,我们再来看一下文件大小

大小为356,阐明数据被成功写入文件中了。
   测试消息读取功能
  1. TEST(message_test, insert_test)
  2. {
  3.     bitmq::BasicProperties bp;
  4.     bp.set_id(bitmq::UUIDHelper::uuid());
  5.     bp.set_delivery_mode(bitmq::DeliveryMode::DURABLE);
  6.     bp.set_routing_key("news.music.pop");
  7.     msgp->insert("queue1", &bp, "Hello World-1", bitmq::DeliveryMode::DURABLE);
  8.     msgp->insert("queue1", nullptr, "Hello World-2", bitmq::DeliveryMode::DURABLE);
  9.     msgp->insert("queue1", nullptr, "Hello World-3", bitmq::DeliveryMode::DURABLE);
  10.     msgp->insert("queue1", nullptr, "Hello World-4", bitmq::DeliveryMode::UNDURABLE);
  11.     msgp->insert("queue1", nullptr, "Hello World-5", bitmq::DeliveryMode::DURABLE);
  12.     msgp->insert("queue1", nullptr, "Hello World-6", bitmq::DeliveryMode::DURABLE);
  13.     ASSERT_EQ(msgp->total_count("queue1"), 5);
  14.     ASSERT_EQ(msgp->durable_count("queue1"), 5);
  15.     ASSERT_EQ(msgp->getable_count("queue1"), 6);
  16.     ASSERT_EQ(msgp->waitack_count("queue1"), 0);
  17. }
  18. TEST(message_test, select_test)
  19. {
  20.     bitmq::MessagePtr msg1 = msgp->front("queue1");
  21.     ASSERT_NE(msg1.get(), nullptr);
  22.     ASSERT_EQ(msg1->payload().body(), std::string("Hello World-1"));
  23.     ASSERT_EQ(msgp->getable_count("queue1"), 5);
  24.     ASSERT_EQ(msgp->waitack_count("queue1"), 1);
  25.     bitmq::MessagePtr msg2 = msgp->front("queue1");
  26.     ASSERT_NE(msg2.get(), nullptr);
  27.     ASSERT_EQ(msg2->payload().body(), std::string("Hello World-2"));
  28.     ASSERT_EQ(msgp->getable_count("queue1"), 4);
  29.     ASSERT_EQ(msgp->waitack_count("queue1"), 2);
  30.    
  31.     bitmq::MessagePtr msg3 = msgp->front("queue1");
  32.     ASSERT_NE(msg3.get(), nullptr);
  33.     ASSERT_EQ(msg3->payload().body(), std::string("Hello World-3"));
  34.     ASSERT_EQ(msgp->getable_count("queue1"), 3);
  35.     ASSERT_EQ(msgp->waitack_count("queue1"), 3);
  36.    
  37.     bitmq::MessagePtr msg4 = msgp->front("queue1");
  38.     ASSERT_NE(msg4.get(), nullptr);
  39.     ASSERT_EQ(msg4->payload().body(), std::string("Hello World-4"));
  40.     ASSERT_EQ(msgp->getable_count("queue1"), 2);
  41.     ASSERT_EQ(msgp->waitack_count("queue1"), 4);
  42.    
  43.     bitmq::MessagePtr msg5 = msgp->front("queue1");
  44.     ASSERT_NE(msg5.get(), nullptr);
  45.     ASSERT_EQ(msg5->payload().body(), std::string("Hello World-5"));
  46.     ASSERT_EQ(msgp->getable_count("queue1"), 1);
  47.     ASSERT_EQ(msgp->waitack_count("queue1"), 5);
  48.    
  49.     bitmq::MessagePtr msg6 = msgp->front("queue1");
  50.     ASSERT_NE(msg6.get(), nullptr);
  51.     ASSERT_EQ(msg6->payload().body(), std::string("Hello World-6"));
  52.     ASSERT_EQ(msgp->getable_count("queue1"), 0);
  53.     ASSERT_EQ(msgp->waitack_count("queue1"), 6);
  54.     bitmq::MessagePtr msg7 = msgp->front("queue1");
  55.     ASSERT_EQ(msg7.get(), nullptr);
  56. }
复制代码
删除数据文件(上一次实行完后,文件中应该生存5条消息,而再次实行insert_test后,又会新增6条消息,造成结果偏差,所以我们就以第一次插入来测试查询功能),重新实行上面的内容。
运行结果:

查询功能没有问题,符合预期结果。
   测试历史消息恢复功能
  1. TEST(message_test, recovery_test)
  2. {
  3.     bitmq::MessagePtr msg1 = msgp->front("queue1");
  4.     ASSERT_NE(msg1.get(), nullptr);
  5.     ASSERT_EQ(msg1->payload().body(), std::string("Hello World-1"));
  6.     //只持久化了五个数据,重启系统后,可推送消息只有5个。
  7.     DLOG("msg1的uuid为: %s   body: %s   valid: %s  routing_key: %s", msg1->payload().properties().id().c_str(), msg1->payload().body().c_str(), msg1->payload().valid().c_str(), msg1->payload().properties().routing_key().c_str());
  8.     ASSERT_EQ(msgp->getable_count("queue1"), 4);
  9.     ASSERT_EQ(msgp->waitack_count("queue1"), 1);
  10.     bitmq::MessagePtr msg2 = msgp->front("queue1");
  11.     ASSERT_NE(msg2.get(), nullptr);
  12.     ASSERT_EQ(msg2->payload().body(), std::string("Hello World-2"));
  13.     DLOG("msg1的uuid为: %s   body: %s   valid: %s  routing_key: %s", msg2->payload().properties().id().c_str(), msg2->payload().body().c_str(), msg2->payload().valid().c_str(), msg2->payload().properties().routing_key().c_str());
  14.     ASSERT_EQ(msgp->getable_count("queue1"), 3);
  15.     ASSERT_EQ(msgp->waitack_count("queue1"), 2);
  16.    
  17.     bitmq::MessagePtr msg3 = msgp->front("queue1");
  18.     ASSERT_NE(msg3.get(), nullptr);
  19.     ASSERT_EQ(msg3->payload().body(), std::string("Hello World-3"));
  20.     ASSERT_EQ(msgp->getable_count("queue1"), 2);
  21.     ASSERT_EQ(msgp->waitack_count("queue1"), 3);
  22.    
  23.     bitmq::MessagePtr msg4 = msgp->front("queue1");
  24.     ASSERT_NE(msg4.get(), nullptr);
  25.     ASSERT_EQ(msg4->payload().body(), std::string("Hello World-5"));
  26.     ASSERT_EQ(msgp->getable_count("queue1"), 1);
  27.     ASSERT_EQ(msgp->waitack_count("queue1"), 4);
  28.    
  29.     bitmq::MessagePtr msg5 = msgp->front("queue1");
  30.     ASSERT_NE(msg5.get(), nullptr);
  31.     ASSERT_EQ(msg5->payload().body(), std::string("Hello World-6"));
  32.     ASSERT_EQ(msgp->getable_count("queue1"), 0);
  33.     ASSERT_EQ(msgp->waitack_count("queue1"), 5);
  34.    
  35.     bitmq::MessagePtr msg6 = msgp->front("queue1");
  36.     ASSERT_EQ(msg6.get(), nullptr);
  37. }
复制代码
前面的代码实行完后,文件中生存了5条消息,那么直接实行上面的代码,会恢复历史数据,我们依次读取消息,判断读取的消息是否完备,数据是否符合预期。

由于恢复历史消息会主动实行一次垃圾接纳,所以可以看到会创建临时文件,并向其中写入数据。
颠末测试可以发现消息恢复功能也没有问题。
   测试删除消息功能
  1. TEST(message_test, remove_test)
  2. {
  3.     bitmq::MessagePtr msg1 = msgp->front("queue1");
  4.     ASSERT_NE(msg1.get(), nullptr);
  5.     ASSERT_EQ(msg1->payload().body(), std::string("Hello World-1"));
  6.     ASSERT_EQ(msgp->getable_count("queue1"), 4);
  7.     ASSERT_EQ(msgp->waitack_count("queue1"), 1);
  8.     msgp->ack("queue1", msg1->payload().properties().id());
  9.     ASSERT_EQ(msgp->waitack_count("queue1"), 0);
  10.     ASSERT_EQ(msgp->durable_count("queue1"), 4);
  11.     ASSERT_EQ(msgp->total_count("queue1"), 4);
  12. }
复制代码
实行结果:

我们再来测试一下删除后重启服务器时,该消息会不会真正被删除(重启服务器会举行一次垃圾接纳)
  1. TEST(message_test, gc_test)
  2. {
  3.     ASSERT_EQ(msgp->getable_count("queue1"), 4);
  4.     ASSERT_EQ(msgp->waitack_count("queue1"), 0);
  5.     bitmq::MessagePtr msg1 = msgp->front("queue1");
  6.     ASSERT_NE(msg1.get(), nullptr);
  7.     ASSERT_EQ(msg1->payload().body(), std::string("Hello World-2"));
  8.     //只持久化了五个数据,重启系统后,可推送消息只有5个。
  9.     ASSERT_EQ(msgp->getable_count("queue1"), 3);
  10.     ASSERT_EQ(msgp->waitack_count("queue1"), 1);
  11. }
复制代码
实行结果:

实行结果成功,并且源文件和临时文件的大小差别,阐明消息被成功删除了。


总结:
消息模块的编写难度上是比力大的,本人在测试时也遇到了不少的问题,大家在遇到困难时不要畏惧和焦虑,而是耐下心来一步步的调试找错,这个过程也是很锻炼我们的本领,世上无难事,只怕故意人,下一个模块不见不散。

8.8 虚拟机管理

虚拟机模块是对上述三个数据管理模块的整合,并基于数据之间的关联关系举行团结操作。
1. 定义虚拟机类包含以下成员:


  • 1)交换机数据管理模块句柄
  • 2)队列数据管理模块句柄
  • 3)绑定数据管理模块句柄
  • 4)消息数据管理模块句柄
2. 虚拟机包含操作:


  • 1)提供声明交换机的功能(存在则 OK,不存在则创建)
  • 2)提供删除交换机的功能(删除交换机的同时删除关联绑定信息)
  • 3)提供声明队列的功能(存在则 OK,不存在则创建,创建的同时创建队列关联消息管理对象)
  • 4)提供删除队列的功能(删除队列的同时删除关联绑定信息,删除关联消息管理对象及队列全部消息)
  • 5)提供交换机-队列绑定的功能
  • 6)提供交换机-队列解绑的功能
  • 7)提供获取交换机相干的全部绑定信息功能
  • 8)提供新增消息的功能
  • 9)提供获取指定队列队首消息的功能
  • 10)提供消息确认删除的功能
3. 虚拟机管理操作:


  • 增删查
留意:本项目为了简化只有一个虚拟机,所以虚拟机的增删查功能就不实现了,想要实现也比力简单,雷同交换机/队列/绑定,添加一个数据库,然后创建一个虚拟机长期化管理类负责对虚拟机数据举行长期化,再创建一个虚拟机负责对外提供总的虚拟机管理操作。


   声明交换机管理类
  1. class VirtualHost
  2. {
  3. public:
  4.     VirtualHost(const std::string& basedir, const std::string& dbfile);
  5.     // 1)提供声明交换机的功能(存在则 OK,不存在则创建)
  6.     bool declareExchange(const std::string& name, bitmq::ExchangeType type,
  7.         bool durable, bool auto_delete, std::unordered_map<std::string, std::string> args);
  8.     // 2)提供删除交换机的功能(删除交换机的同时删除关联绑定信息)  
  9.     void deleteExchange(const std::string& name);
  10.     // 3)提供声明队列的功能(存在则 OK,不存在则创建,创建的同时创建队列关联消息管理对象)
  11.     bool declareQueue(const std::string& name, bool durable, bool exclusive,
  12.         bool auto_delete, std::unordered_map<std::string, std::string> args);
  13.     // 4)提供删除队列的功能(删除队列的同时删除关联绑定信息,删除关联消息管理对象及队列所有消息)  
  14.     void deleteQueue(const std::string& name);
  15.     // 5)提供交换机-队列绑定的功能
  16.     void Bind(const std::string& ename, const std::string& qname, const std::string& key, bool durable);
  17.     // 6)提供交换机-队列解绑的功能
  18.     void unBind(const std::string& ename, const std::string& qname);
  19.     // 7)提供获取交换机相关的所有绑定信息功能
  20.     MsgQueueBindingMap exchangeBindings(const std::string& ename);
  21.     // 8)提供新增消息的功能
  22.     bool basicPublish(const std::string& qname, const BasicProperties* bp, const std::string& body, DeliveryMode delivery_mode);
  23.     // 9)提供获取指定队列队首消息的功能   
  24.     MessagePtr basicConsume(const std::string& qname);
  25.     // 10)提供消息确认删除的功能
  26.     bool basicAck(const std::string& ename, const std::string& qname);
  27. private:
  28.     ExchangeManager::ptr _emp;
  29.     MsgQueueManager::ptr _mqmp;
  30.     BindingManager::ptr _bmp;
  31.     MessageManager::ptr _mmp;
  32. };
复制代码
  定义交换机管理类
  1. class VirtualHost
  2. {
  3. public:
  4.     using ptr = std::shared_ptr<VirtualHost>;
  5.     VirtualHost(const std::string& hostname, const std::string& basedir, const std::string& dbfile)
  6.         : _host_name(hostname)
  7.         , _emp(std::make_shared<ExchangeManager>(dbfile))
  8.         , _mqmp(std::make_shared<MsgQueueManager>(dbfile))
  9.         , _bmp(std::make_shared<BindingManager>(dbfile))
  10.         , _mmp(std::make_shared<MessageManager>(basedir))
  11.     {
  12.         //交换机/队列/绑定管理类会在初始化时从数据库中恢复数据
  13.         //但是消息管理类不会进行该操作,所以我们需要手动完成消息的历史消息恢复
  14.         auto mq = _mqmp->getAllQueues();
  15.         for (auto& [qname, msgqueue] : mq)
  16.         {
  17.             _mmp->initQueueMessage(qname);
  18.         }
  19.     }
  20.     // 1)提供声明交换机的功能(存在则 OK,不存在则创建)
  21.     bool declareExchange(const std::string& name, bitmq::ExchangeType type,
  22.         bool durable, bool auto_delete, std::unordered_map<std::string, std::string> args)
  23.     {
  24.         return _emp->declareExchange(name, type, durable, auto_delete, args);
  25.     }
  26.     // 2)提供删除交换机的功能(删除交换机的同时删除关联绑定信息)  
  27.     void deleteExchange(const std::string& name)
  28.     {
  29.         //1.删除绑定交换机
  30.         _emp->deleteExchange(name);
  31.         //2.删除绑定信息
  32.         _bmp->removeExchangeBindings(name);
  33.     }
  34.     // 3)判断交换机是否存在
  35.     bool existsExchange(const std::string& ename)
  36.     {
  37.         return _emp->exists(ename);
  38.     }
  39.     // 4)提供声明队列的功能(存在则 OK,不存在则创建,创建的同时创建队列关联消息管理对象)
  40.     bool declareQueue(const std::string& qname, bool durable, bool exclusive,
  41.         bool auto_delete, std::unordered_map<std::string, std::string> args)
  42.     {
  43.         //初始化队列消息句柄(消息的存储管理)
  44.         _mmp->initQueueMessage(qname);
  45.         //创建队列
  46.         return _mqmp->declareQueue(qname, durable, exclusive, auto_delete, args);
  47.     }
  48.     // 5)提供删除队列的功能(删除队列的同时删除关联绑定信息,删除关联消息管理对象及队列所有消息)  
  49.     void deleteQueue(const std::string& qname)
  50.     {
  51.         //删除队列消息管理句柄
  52.         _mmp->destroyQueueMessage(qname);
  53.         //删除队列相关的绑定信息
  54.         _bmp->removeMsgQueueBindings(qname);
  55.         return _mqmp->deleteQueue(qname);
  56.     }
  57.     // 6)判断队列是否存在
  58.     bool existsQueue(const std::string& qname)
  59.     {
  60.         return _mqmp->exists(qname);
  61.     }
  62.     // 7)提供交换机-队列绑定的功能
  63.     bool bind(const std::string& ename, const std::string& qname, const std::string& key)
  64.     {
  65.         //绑定条件:交换机和队列必须存在)
  66.         Exchange::ptr ep = _emp->selectExchange(ename);
  67.         if (ep.get() == nullptr)
  68.         {
  69.             DLOG("进行队列绑定失败,交换机%s不存在", ename.c_str());
  70.             return false;
  71.         }
  72.         MsgQueue::ptr qp = _mqmp->selectQueue(qname);
  73.         if (qp.get() == nullptr)
  74.         {
  75.             DLOG("进行队列绑定失败,队列%s不存在", qname.c_str());
  76.             return false;
  77.         }
  78.         //交换机是否需要持久化取决于交换机和队列是否持久化
  79.         _bmp->bind(ename, qname, key, ep->durable && qp->durable);
  80.     }
  81.     // 8)提供交换机-队列解绑的功能
  82.     void unBind(const std::string& ename, const std::string& qname)
  83.     {
  84.         return _bmp->unBind(ename, qname);
  85.     }
  86.     // 9)判断绑定是否存在
  87.     bool existsBinding(const std::string& ename, const std::string& qname)
  88.     {
  89.         return _bmp->exists(ename, qname);
  90.     }
  91.    
  92.     // 10)提供获取交换机相关的所有绑定信息功能
  93.     MsgQueueBindingMap exchangeBindings(const std::string& ename)
  94.     {
  95.         return _bmp->getExchangeBindings(ename);
  96.     }
  97.     // 11)提供新增消息的功能
  98.     bool basicPublish(const std::string& qname, const BasicProperties* bp, const std::string& body)
  99.     {
  100.         MsgQueue::ptr qp = _mqmp->selectQueue(qname);
  101.         if (qp.get() == nullptr)
  102.         {
  103.             DLOG("进行队列绑定失败,队列%s不存在", qname.c_str());
  104.             return false;
  105.         }
  106.         return _mmp->insert(qname, bp, body, qp->durable);
  107.     }
  108.     // 12)提供获取指定队列队首消息的功能   
  109.     MessagePtr basicConsume(const std::string& qname)
  110.     {
  111.         return _mmp->front(qname);
  112.     }
  113.     // 13)提供消息确认删除的功能
  114.     void basicAck(const std::string& qname, const std::string msg_id)
  115.     {
  116.         return _mmp->ack(qname, msg_id);
  117.     }
  118.     // 14)清除
  119.     void clear()
  120.     {
  121.         _emp->clear();
  122.         _mqmp->clear();
  123.         _bmp->clear();
  124.         _mmp->clear();
  125.     }
  126. private:
  127.     std::string _host_name;
  128.     ExchangeManager::ptr _emp;
  129.     MsgQueueManager::ptr _mqmp;
  130.     BindingManager::ptr _bmp;
  131.     MessageManager::ptr _mmp;
  132. };
复制代码
该类写起来还是比力简单的,由于全部的功能前面都已经实现过了,这里只是将他们举行整合。


单元测试:
在前面我们完成了每个模块的单元测试,所以到这里基本上不会出现什么问题了,为了保险起见,我们还是举行简单的测试。
  1. #include "../../mqserver/mq_virtualhost.hpp"
  2. #include <gtest/gtest.h>
  3. using empty_map = std::unordered_map<std::string, std::string>;
  4. class HostTest : public testing::Test
  5. {
  6. public:
  7.     virtual void SetUp() override
  8.     {
  9.         _host = std::make_shared<bitmq::VirtualHost>("host1", "./data/host1/message", "./data/host1/host1.db");
  10.         _host->declareExchange("exchange1", bitmq::ExchangeType::DIRECT, true, false,  empty_map());
  11.         _host->declareExchange("exchange2", bitmq::ExchangeType::DIRECT, true, false,  empty_map());
  12.         _host->declareExchange("exchange3", bitmq::ExchangeType::DIRECT, true, false,  empty_map());
  13.         _host->declareQueue("queue1", true, false, false, empty_map());
  14.         _host->declareQueue("queue2", true, false, false, empty_map());
  15.         _host->declareQueue("queue3", true, false, false, empty_map());
  16.         _host->bind("exchange1", "queue1", "new.music.#");
  17.         _host->bind("exchange1", "queue2", "new.music.#");
  18.         _host->bind("exchange1", "queue3", "new.music.#");
  19.         _host->bind("exchange2", "queue1", "new.music.#");
  20.         _host->bind("exchange2", "queue2", "new.music.#");
  21.         _host->bind("exchange2", "queue3", "new.music.#");
  22.         _host->bind("exchange3", "queue1", "new.music.#");
  23.         _host->bind("exchange3", "queue2", "new.music.#");
  24.         _host->bind("exchange3", "queue3", "new.music.#");
  25.         _host->basicPublish("queue1", nullptr, "Hello World-1");
  26.         _host->basicPublish("queue1", nullptr, "Hello World-2");
  27.         _host->basicPublish("queue1", nullptr, "Hello World-3");
  28.         _host->basicPublish("queue2", nullptr, "Hello World-1");
  29.         _host->basicPublish("queue2", nullptr, "Hello World-2");
  30.         _host->basicPublish("queue2", nullptr, "Hello World-3");
  31.         _host->basicPublish("queue3", nullptr, "Hello World-1");
  32.         _host->basicPublish("queue3", nullptr, "Hello World-2");
  33.         _host->basicPublish("queue3", nullptr, "Hello World-3");
  34.     }
  35.     virtual void TearDown() override
  36.     {
  37.         _host->clear();
  38.     }
  39. public:
  40.     bitmq::VirtualHost::ptr _host;
  41. };
  42. TEST_F(HostTest, init_test)
  43. {
  44.     ASSERT_EQ(_host->existsExchange("exchange1"), true);
  45.     ASSERT_EQ(_host->existsExchange("exchange2"), true);
  46.     ASSERT_EQ(_host->existsExchange("exchange3"), true);
  47.     ASSERT_EQ(_host->existsQueue("queue1"), true);
  48.     ASSERT_EQ(_host->existsQueue("queue2"), true);
  49.     ASSERT_EQ(_host->existsQueue("queue3"), true);
  50.     ASSERT_EQ(_host->existsBinding("exchange1", "queue1"), true);
  51.     ASSERT_EQ(_host->existsBinding("exchange1", "queue2"), true);
  52.     ASSERT_EQ(_host->existsBinding("exchange1", "queue3"), true);
  53.    
  54.     ASSERT_EQ(_host->existsBinding("exchange2", "queue1"), true);
  55.     ASSERT_EQ(_host->existsBinding("exchange2", "queue2"), true);
  56.     ASSERT_EQ(_host->existsBinding("exchange2", "queue3"), true);
  57.     ASSERT_EQ(_host->existsBinding("exchange3", "queue1"), true);
  58.     ASSERT_EQ(_host->existsBinding("exchange3", "queue2"), true);
  59.     ASSERT_EQ(_host->existsBinding("exchange3", "queue3"), true);
  60.     bitmq::MessagePtr msg1 = _host->basicConsume("queue1");
  61.     ASSERT_EQ(msg1->payload().body(), std::string("Hello World-1"));
  62.     bitmq::MessagePtr msg2 = _host->basicConsume("queue1");
  63.     ASSERT_EQ(msg2->payload().body(), std::string("Hello World-2"));
  64.     bitmq::MessagePtr msg3 = _host->basicConsume("queue1");
  65.     ASSERT_EQ(msg3->payload().body(), std::string("Hello World-3"));
  66.     bitmq::MessagePtr msg4 = _host->basicConsume("queue1");
  67.     ASSERT_EQ(msg4.get(), nullptr);
  68. }
  69. TEST_F(HostTest, remove_exchange)
  70. {
  71.     _host->deleteExchange("exchange1");
  72.     ASSERT_EQ(_host->existsBinding("exchange1", "queue1"), false);
  73.     ASSERT_EQ(_host->existsBinding("exchange1", "queue2"), false);
  74.     ASSERT_EQ(_host->existsBinding("exchange1", "queue3"), false);
  75. }
  76. TEST_F(HostTest, remove_queue)
  77. {
  78.     _host->deleteQueue("queue1");
  79.     ASSERT_EQ(_host->existsBinding("exchange1", "queue1"), false);
  80.     ASSERT_EQ(_host->existsBinding("exchange2", "queue1"), false);
  81.     ASSERT_EQ(_host->existsBinding("exchange3", "queue1"), false);
  82.     bitmq::MessagePtr msg1 = _host->basicConsume("queue1");
  83.     ASSERT_EQ(msg1.get(), nullptr);
  84. }
  85. TEST_F(HostTest, ack_message)
  86. {
  87.     bitmq::MessagePtr msg1 = _host->basicConsume("queue1");
  88.     ASSERT_EQ(msg1->payload().body(), std::string("Hello World-1"));
  89.     _host->basicAck(std::string("queue1"), msg1->payload().properties().id());
  90.     bitmq::MessagePtr msg2 = _host->basicConsume("queue1");
  91.     ASSERT_EQ(msg2->payload().body(), std::string("Hello World-2"));
  92.     _host->basicAck(std::string("queue1"), msg2->payload().properties().id());
  93.     bitmq::MessagePtr msg3 = _host->basicConsume("queue1");
  94.     ASSERT_EQ(msg3->payload().body(), std::string("Hello World-3"));
  95.     _host->basicAck(std::string("queue1"), msg3->payload().properties().id());
  96. }
  97. int main(int argc, char* argv[])
  98. {
  99.     testing::InitGoogleTest(&argc, argv);
  100.     RUN_ALL_TESTS();
  101.     return 0;
  102. }
复制代码
上面的测试用例包含了:插入查找,删除功能的测试。
测试结果:


8.9 交换机路由管理

客户端将消息发布到指定的交换机,交换机这时候要考虑这条数据该放入到哪些与本身绑定的队列中,而这个考量是通过交换机范例以及匹配规则来决定的:

交换机范例:


  • 1. 广播交换:直接将消息交给全部绑定的队列,无需匹配
  • 2. 直接交换:队列绑定信息中的 binding_key 与消息中的 routing_key 同等则匹配成功,否则失败。
  • 3. 主题交换:按照肯定的匹配规则举行匹配
其中广播交换和直接交换,都非常简单,唯一较为难以理解的是主题交换。
在这里我们需要先对 binding_key 和 routing_key 作以了解:
   binding_key
  是由数字字母下划线构成的, 并且使用 . 分成多少部分,并支持 * 和 # 通配符。
比方: news.music.#,这用于表示交换机绑定的当前队列是一个用于发布音乐消息的队列。


  • 支持 * 和 # 两种通配符, 但是 * # 只能作为 . 切分出来的独立部分, 不能和其他数字字母混用,

    • 比如 a.*.b 是合法的, a.*a.b 是不合法的
    • * 可以匹配任意一个单词(留意是单词不是字母)
    • # 可以匹配零个大概多个任意单词(留意是单词不是字母)

  • 一个单词中不能既出现 * 又出现 #, 也就是,一个单词中只能有一个通配符,且必须独立存在
  • # 通配符两边不能出现其他通配符,由于 # 可以匹配任意多个任意单词,因此一连出现是没有意义的。
   routing_key
  是由数据、字母和下划线构成, 并且可以使用 . 划分成多少部分。
比方: news.music.pop,这用于表示当前发布的消息是一个流行音乐的消息.
比如,在举行队列绑定时,某队列的 binding_key 约定为: news.music.#表示这个队列用于发布音乐消息。而这时候客户端发布了一条消息,其中 routing_key 为: news.music.pop 则可以匹配成功,而如果发布消息的 routing_key 为: news.sport.football,这时候就会匹配失败。
   匹配算法
  定义一个二维数组来标志每次匹配的结果,通过最终数组末尾位置的结果来查看是否团体匹配成功。
使用 routing_key 中的每个单词,与 binding_key 中的单词举行逐个匹配,根据匹配结果来标志数组内容,最终以数组中的末尾标志来确定是否匹配成功。
该动态规划的核心主要在推导递推公式, 下面我们通过几个示例来推导递推公式。

示例 1:
binding_key = "bbb.ddd"; routing_key = "aaa.ddd"
定义:dp[2][2]

拿routing_key和binding_key每个单词举行比力,如果单词相同,则对应位置置1。
这个例子中固然结尾标志为1,但是很明显匹配不成功,我们需要理解一个关键点:当一个routing_key单词与binding_key单词匹配成功,则应该继承上一个单词(上一行和上一列)的匹配结果,需要考虑父级单词是否匹配成功,只有父级匹配成功了,本次匹配才有意义。

示例 2:
binding_key = "aaa.ddd"; routing_key = "aaa.ddd"
定义:dp[2][2]

这个例子中,匹配就是成功的,因此我们可以得到第一个公式:
单词匹配成功: dp[j] = dp[i - 1][j - 1]
但是,在将头脑转换为代码时,我们考虑当 aaa 匹配成功时,从左上继承结果,但是这时候是没有左上位置的,因此对于代码的逻辑就出现了一个例外的点(代码处理额外增加了难度)。
因此,为了便于将头脑转换为代码,因此我们的数组大小定义行列分别额外多申请一行一列,并将 dp[0][0]位置置 1

如许初始将 dp[0][0] 位置置 1, 其他数组位置全部置 0; 如许只要单词匹配成功,则从左上位置继承结果。

示例 3: #通配符的特殊
binding_key = "#"; routing_key = "aaa.bbb"

从这个例子中,能看出,当出现#通配符的时候是比力特殊的,如果 bbb 与#匹配成功的时候,从左上继承结果,得到的结果是 0,匹配失败,但是实际结果应该是成功的。
因此,得出结论:当遇到通配符 # 时,不仅从左上继承结果,还可以从上一个单词与#的匹配结果处(左边)继承。

既: dp[j] = dp[i - 1][j - 1] | dp[j - 1] ;

示例 4: #通配符的特殊
binding_key = "aaa.#"; routing_key = "aaa"

从上例中,看出,当 aaa 与#匹配成功时,从左边和左上继承的结果这时候都是 0,这也是不合理的。
结论,因此当遇到 # 通配符匹配成功时,不仅从 左上,左边继承结果,也可以从上方继承结果。
既: dp[j] = dp[i - 1][j - 1] | dp[j - 1] | dp[i - 1][j];

示例 4: #通配符的特殊
binding_key = "#.aaa"; routing_key = "aaa";

观察上述例子,当 aaa 匹配成功时,从左上继承匹配结果,这时候继承到的是 0 ,这是有问题的。因此,当 binding_key 中以起始行以#开始时,应该将起始行的第 0 列置为 1,以便于后边的匹配结果继承。



实际案例1:
binding_key = "#.ccc.bbb.*.bbb", routing_key = "aaa.ddd.ccc.bbb.eee.bbb"。


  • 定义状态: dp[j]表示 routing_tokens 的前 i 个字符串 能否与 binding_tokens 前 j 个字符串匹配
  • 初始值: dp[0][0] = true
初始状态:

第一轮匹配:

第二轮匹配:

第三轮匹配:
同样的原理, bbb 匹配成功,非统配符匹配成功, 则从左上继承结果

第四轮匹配:
这一轮遇到的是*通配符,而*表示任意一个单词,它与正常的单词匹配成功并没有区别,从左上继承结果。

第五轮匹配:
这一轮中,第一个 routing_key 中的 bbb 匹配成功,但是其继承结果为 0,而第二个bbb 匹配成功时,继承结果为 1


实际案例2:


  • binding_key: aaa.#.bbb.*.ddd
  • routing_key: aaa.ddd.aaa.bbb.eee.ddd
第一轮匹配:

第二轮匹配:
这一轮匹配中, aaa 遇到#时,就用到了从上方继承结果。其他的从左边继承结果。

第三轮匹配:
这一轮只有 bbb 匹配成功,从左上继承到 true

第四轮匹配:
这一轮固然全部单词与*都可以匹配成功,但是继承结果时,只有 eee 继承到左上 true

第五轮匹配:


总结:
匹配算法头脑:


  • 1.对binding key和routing key举行单词分割
  • 2.按照元素个数,定义出对应大小+1的二维数组,并且将dp[0][0]位置置1
  • 3.使用routing key的每个元素,与binding key的每个元素举行比对,在二维数组中举行标志标志规则:

    • 1.当两个单词匹配成功时:从左上方继承结果 dp[j] = dp[i -1][j-1];
    • 2.当遇到#通配符匹配成功时:不仅可以从左上方继承结果,还可以从左方继承结果 dp[j]=dp[i-1][j-1] | dp[j-1];
    • 3.当遇到#通配符匹配成功时:不仅可以从左上,左方继承结果,还可以从上方继承结果 dp[j]=dp[i-1][j-1] | dp[j-1] | dp[i-1][j];
    • 4.当binding key以#起始时:需要将#对应行的第0列置为1


   路由交换模块
  功能:判断一个消息中的routing_key与队列的binding_key是否匹配成功。
取决要素有两个:交换机范例,routing_key与binding_key的匹配
因此基于功能需求分析:路由交换模块只需要对传入的数据举行处理即可,因此这个模块要实现的实际上是一个功能类接口(没有成员)
提供的功能:


  • 1)判断routing_key是否合法:必须是a~z,A~Z,0~9,* # . _ 组成
  • 2)判断binding_key是否合法:

    • 1. 必须是a~z,A~Z,0~9,* # . _ 组成
    • 2.  * #是通配符,必须独立存在,*和#不能一连出现

  • 3)举行routing_key与binding_key的路由匹配

    • 1.广播:不管怎样都是成功的
    • 2.直接:相等则成功
    • 3.主题:按匹配模式,完成了则成功


   声明路由匹配模块
  1. class Router
  2. {
  3. public:
  4.     //判断routing_key是否合法
  5.     static bool isLegalRoutingKey(const std::string& routing_key);
  6.     //判断binding_key是否合法
  7.     static bool isLegalBindingKey(const std::string& binding_key);
  8.     //路由匹配
  9.     static bool route(ExchangeType type, const std::string& routing_key, const std::string& binding_key);
  10. };
复制代码
  定义路由匹配模块
  1. class Router
  2. {
  3. public:
  4.     //判断routing_key是否合法
  5.     static bool isLegalRoutingKey(const std::string& routing_key)
  6.     {
  7.         //1.routing_key:判断是否包含非法字符
  8.         for (auto& ch : routing_key)
  9.         {
  10.             if ((ch >= 'a' && ch <= 'z') ||
  11.                 (ch >= 'A' && ch <= 'Z') ||
  12.                 (ch >= '0' && ch <= '9') ||
  13.                 (ch == '_' || ch == '.'))
  14.             {
  15.                 continue;
  16.             }
  17.             return false;
  18.         }
  19.         return true;
  20.     }
  21.     //判断binding_key是否合法
  22.     static bool isLegalBindingKey(const std::string& binding_key)
  23.     {
  24.         //1.routing_key:判断是否包含非法字符
  25.         for (auto& ch : binding_key)
  26.         {
  27.             if ((ch >= 'a' && ch <= 'z') ||
  28.                 (ch >= 'A' && ch <= 'Z') ||
  29.                 (ch >= '0' && ch <= '9') ||
  30.                 (ch == '_' || ch == '.' ||
  31.                 ch == '*' || ch == '#'))
  32.             {
  33.                 continue;
  34.             }
  35.             return false;
  36.         }
  37.         //2.*和#必须独立存在:news.music#.*.#
  38.         //以.进行分割,判断每个单词中是否包含*和#
  39.         std::vector<std::string> sub_words;
  40.         StringHelper::splite(binding_key, ".", sub_words);
  41.         for (auto& word : sub_words)
  42.         {
  43.             if (word.size() > 1 && (word.find("*") != std::string::npos ||
  44.                 word.find("#") != std::string::npos))
  45.                 return false;
  46.         }
  47.         //3. #两边不能出现通配符
  48.         for (int i = 1; i < sub_words.size(); i++)
  49.         {
  50.             if ((sub_words[i] == "*" && sub_words[i-1] == "#") ||
  51.                 (sub_words[i] == "#" && sub_words[i-1] == "*") ||
  52.                 (sub_words[i] == "#" && sub_words[i-1] == "#"))
  53.                 return false;
  54.         }
  55.         return true;
  56.     }
  57.     //路由匹配
  58.     static bool route(ExchangeType type, const std::string& routing_key, const std::string& binding_key)
  59.     {
  60.         if (type == ExchangeType::FANOUT)
  61.         {
  62.             return true;
  63.         }
  64.         else if (type == ExchangeType::DIRECT)
  65.         {
  66.             return routing_key == binding_key;
  67.         }
  68.         else
  69.         {
  70.             //主题交换:
  71.             //1.将binding_key与routiing_key进行字符串分割,得到各个的单词数组
  72.             std::vector<std::string> bkeys, rkeys;
  73.             int n_rkey = StringHelper::splite(routing_key, ".", rkeys);
  74.             int n_bkey = StringHelper::splite(binding_key, ".", bkeys);
  75.             //2.定义标记数组,并初始化[0][0]位置为true,其他位置为false
  76.             std::vector<std::vector<bool>> dp(n_bkey + 1, std::vector<bool>(n_rkey + 1, false));
  77.             dp[0][0] = true;
  78.             //3.如果binding_key以#起始,则将#对应行的第0列置为1
  79.             if (bkeys[0] == "#")
  80.                 dp[1][0] = true;
  81.             //4.使用rouing_key中的每个单词与binding_key中的每个单词进行匹配
  82.             for (int i = 1; i <= n_bkey; i++)
  83.             {
  84.                 for (int j = 1; j <= n_rkey; j++)
  85.                 {
  86.                     //如果当前bkey是个*或两个单词相同,则匹配成功,继承左上方结果
  87.                     if (bkeys[i-1] == rkeys[j-1] || bkeys[i-1] == "*")
  88.                     {
  89.                         dp[i][j] = dp[i-1][j-1];
  90.                     }
  91.                     else if (bkeys[i-1] == "#")
  92.                     {
  93.                         dp[i][j] = dp[i-1][j-1] | dp[i][j-1] | dp[i-1][j];
  94.                     }
  95.                 }
  96.             }
  97.             return dp[n_bkey][n_rkey];
  98.         }
  99.     }
  100. };
复制代码
单元测试:
  1. #include "../../mqserver/mq_route.hpp"
  2. #include <gtest/gtest.h>
  3. class BindingTest : public testing::Environment
  4. {
  5. public:
  6.     virtual void SetUp() override
  7.     { }
  8.     virtual void TearDown() override
  9.     { }
  10. };
  11. TEST(route_test, legal_routing_key)
  12. {
  13.     std::string rkey1 = "new.music.pop";
  14.     std::string rkey2 = "new..music.pop";
  15.     std::string rkey3 = "news.,music.pop";
  16.     std::string rkey4 = "news.music_123.pop";
  17.     ASSERT_EQ(bitmq::Router::isLegalRoutingKey(rkey1), true);
  18.     ASSERT_EQ(bitmq::Router::isLegalRoutingKey(rkey2), true);
  19.     ASSERT_EQ(bitmq::Router::isLegalRoutingKey(rkey3), false);
  20.     ASSERT_EQ(bitmq::Router::isLegalRoutingKey(rkey4), true);
  21. }
  22. TEST(route_test, legal_binding_key)
  23. {
  24.     std::string bkey1 = "news.music.pop";
  25.     std::string bkey2 = "news.#.music.pop";
  26.     std::string bkey3 = "news.#.*.music.pop";
  27.     std::string bkey4 = "news.*.#.music_123.pop";
  28.     std::string bkey5 = "news.#.#.music_123.pop";
  29.     std::string bkey6 = "news.*.*.music_123.pop";
  30.     std::string bkey7 = "news.,music_123.pop";
  31.     ASSERT_EQ(bitmq::Router::isLegalBindingKey(bkey1), true);
  32.     ASSERT_EQ(bitmq::Router::isLegalBindingKey(bkey2), true);
  33.     ASSERT_EQ(bitmq::Router::isLegalBindingKey(bkey3), false);
  34.     ASSERT_EQ(bitmq::Router::isLegalBindingKey(bkey4), false);
  35.     ASSERT_EQ(bitmq::Router::isLegalBindingKey(bkey5), false);
  36.     ASSERT_EQ(bitmq::Router::isLegalBindingKey(bkey6), true);
  37.     ASSERT_EQ(bitmq::Router::isLegalBindingKey(bkey7), false);
  38. }
  39. // [测试用例]
  40. // binding_key     routing_key         result
  41. // aaa             aaa                 true
  42. // aaa.bbb         aaa.bbb             true
  43. // aaa.bbb         aaa.bbb.ccc         false
  44. // aaa.bbb         aaa.ccc             false
  45. // aaa.#.bbb       aaa.bbb.ccc         false
  46. // aaa.bbb.#       aaa.ccc.bbb         false
  47. // #.bbb.ccc       aaa.bbb.ccc.ddd     false
  48. // aaa.bbb.ccc     aaa.bbb.ccc         true
  49. // aaa.*           aaa.bbb             true
  50. // aaa.*.bbb       aaa.bbb.ccc         false
  51. // *.aaa.bbb       aaa.bbb             false
  52. // #               aaa.bbb.ccc         true
  53. // aaa.#           aaa.bbb true// aaa.# aaa.bbb.ccc      true
  54. // aaa.#.ccc       aaa.ccc             true
  55. // aaa.#.ccc       aaa.bbb.ccc         true
  56. // aaa.#.ccc       aaa.aaa.bbb.ccc     true
  57. // #.ccc           ccc                 true
  58. // #.ccc           aaa.bbb.ccc         true
  59. // aaa.#.ccc.ccc   aaa.bbb.ccc.ccc.ccc     true
  60. // aaa.#.bbb.*.bbb aaa.ddd.ccc.bbb.eee.bbb     true
  61. TEST(route_test, legal_route)
  62. {
  63.     std::vector<std::string> bkeys = {
  64.         "aaa",
  65.         "aaa.bbb",
  66.         "aaa.bbb",
  67.         "aaa.bbb",
  68.         "aaa.#.bbb",
  69.         "aaa.bbb.#",
  70.         "#.bbb.ccc",
  71.         "aaa.bbb.ccc",
  72.         "aaa.*",
  73.         "aaa.*.bbb",
  74.         "*.aaa.bbb",
  75.         "#",   
  76.         "aaa.#",
  77.         "aaa.#",  
  78.         "aaa.#.ccc",
  79.         "aaa.#.ccc",
  80.         "aaa.#.ccc",
  81.         "#.ccc",
  82.         "#.ccc",
  83.         "aaa.#.ccc.ccc",
  84.         "aaa.#.bbb.*.bbb"
  85.     };
  86.     std::vector<std::string> rkeys = {
  87.         "aaa",
  88.         "aaa.bbb",   
  89.         "aaa.bbb.ccc",        
  90.         "aaa.ccc",        
  91.         "aaa.bbb.ccc",        
  92.         "aaa.ccc.bbb",        
  93.         "aaa.bbb.ccc.ddd",   
  94.         "aaa.bbb.ccc",      
  95.         "aaa.bbb",         
  96.         "aaa.bbb.ccc",      
  97.         "aaa.bbb",         
  98.         "aaa.bbb.ccc",      
  99.         "aaa.bbb",        
  100.         "aaa.bbb.ccc",     
  101.         "aaa.ccc",        
  102.         "aaa.bbb.ccc",      
  103.         "aaa.aaa.bbb.ccc",  
  104.         "ccc",         
  105.         "aaa.bbb.ccc",   
  106.         "aaa.bbb.ccc.ccc.ccc",
  107.         "aaa.ddd.ccc.bbb.eee.bbb"
  108.     };
  109.     std::vector<bool> result = {
  110.         true,
  111.         true,
  112.         false,
  113.         false,
  114.         false,
  115.         false,
  116.         false,
  117.         true,
  118.         true,
  119.         false,
  120.         false,
  121.         true,
  122.         true,
  123.         true,
  124.         true,
  125.         true,
  126.         true,
  127.         true,
  128.         true,
  129.         true,
  130.         true
  131.     };
  132.     for (int i = 0; i < bkeys.size(); i++)
  133.     {
  134.         ASSERT_EQ(bitmq::Router::route(bitmq::ExchangeType::TOPIC, rkeys[i], bkeys[i]), result[i]);
  135.     }
  136. }
  137. int main(int argc, char* argv[])
  138. {
  139.     testing::InitGoogleTest(&argc, argv);
  140.     testing::AddGlobalTestEnvironment(new BindingTest);
  141.     RUN_ALL_TESTS();
  142.     return 0;
  143. }
复制代码
测试结果:


8.10 队列消费者 / 订阅者管理

客户端这边每当发起一个订阅哀求,意味着服务器这边就多了一个订阅者(处理消息的客户端描述),而这个消费者大概说订阅者它是和队列直接关联的,由于订阅哀求中会描述当前用户想要订阅哪一个队列的消息。
而一个信道关闭的时候,大概队列被删除的时候,那么这个信道或队列关联的消费者也就没有存在的意义了,因此也需要将相干的消费者信息给删撤除。

基于以上需求,因此需要对订阅者信息举行管理。
1. 定义消费者信息结构


  • 1)消费者标识
  • 2)订阅的队列名称
  • 3)一个消息的处理回调函数(实现的是当发布一条消息到队列,则选择消费者举行消费,怎样消费?对于服务端来说就是调用这个个回调函数举行处理,其内部逻辑就是找到消费者对应的毗连,然后将数据发送给消费者对应的客户端)

    • void(const std::string&, const BasicProperties&, const std::string&)

  • 4)是否主动应答标志。(一个消息被消费者消费后,若主动应答,则直接移除待确认消息,否则等待客户端确认)

2. 消费者管理--以队列为单元举行管理-队列消费者管理结构


  • 1)操作:

    • i. 新增消费者:信道提供的服务是订阅队列消息的时候创建
    • ii. 删除消费者:取消订阅 / 信道关闭 / 毗连关闭 的时候删除
    • iii. 获取消费者:从队列全部的消费者中按序取出一个消费者举行消息的推送
    • iv. 判断队列消费者是否为空
    • v. 判断指定消费者是否存在
    • vi. 清理队列全部消费者

  • 2)元素

    • i. 消费者管理结构: vector
    • ii. 轮转序号:一个队列可能会有多个消费者,但是一条消息只需要被一个消费者消费即可,因此接纳 RR 轮转
    • iii. 互斥锁:保证线程安全
    • iv. 队列名称

   消费者的管理以信道为单元还是以队列为单元?
  两者各自的利益


  • 1.以信道为单元:一个信道关闭的时候全部的关联的消费者都要删除
  • 2.以队列为单元:一个队列收到了一条消息,就要找到订阅了队列消息的消费者举行消息推送
而明显找到订阅队列的消费者使用场景更多,所以我们以队列为单元管理消费者。

3. 对消费者举行同一管理结构


  • 1)初始化/删除队列的消费者信息结构(创建/删除队列的时候初始化)
  • 2)向指定队列新增消费者(客户端订阅指定队列消息的时候):新增完成的时候返回消费者对象
  • 3)从指定队列移除消费者(客户端取消订阅的时候)
  • 4)移除指定队列的全部消费者(队列被删除时销毁):删除消费者的队列管理单元对象
  • 5)从指定队列获取一个消费者(轮询获取-消费者轮换消费起到负载均衡的作用)
  • 6)判断队列中消费者是否为空
  • 7)判断队列中指定消费者是否存在
  • 8)清理全部消费者

   声明消费者信息结构
  1. using ConsumerCallBack = std::function<void(const std::string&,  const BasicProperties* , const std::string&)>;
  2. //1. 定义消费者信息结构
  3. struct Consumer
  4. {
  5. public:
  6.     using ptr = std::shared_ptr<Consumer>;
  7.     Consumer(){}
  8.     Consumer(const std::string &ctag, const std::string& queue_name, bool ack_flag, ConsumerCallBack& cb)
  9.         : tag(ctag)
  10.         , qname(queue_name)
  11.         , callback(cb)
  12.         , auto_ack(ack_flag)
  13.     {}
  14. public:
  15.     std::string tag;   // 1)消费者标识
  16.     std::string qname;  // 2)订阅的队列名称
  17.     ConsumerCallBack callback; // 3)一个消息的处理回调函数
  18.     bool auto_ack;    // 4)是否自动应答标志
  19. };
复制代码
  声明消费者管理类
  1. //2. 消费者管理--以队列为单元进行管理-队列消费者管理结构
  2. class QueueConsumer
  3. {
  4. public:
  5.     QueueConsumer(const std::string& qname);
  6.     // 1)新增消费者:信道提供的服务是订阅队列消息的时候创建
  7.     Consumer::ptr create(const std::string &ctag, const std::string& queue_name, bool ack_flag, ConsumerCallBack& cb);
  8.     // 2)删除消费者:取消订阅 / 信道关闭 / 连接关闭 的时候删除
  9.     void remove(const std::string& ctag);
  10.     // 3)获取消费者:从队列所有的消费者中按序取出一个消费者进行消息的推送
  11.     Consumer::ptr choose();
  12.     // 4)判断队列消费者是否为空
  13.     bool empty();
  14.     // 5)判断指定消费者是否存在
  15.     bool exists(const std::string& ctag);
  16.     // 6)清理队列所有消费者
  17.     void clear();
  18. private:
  19.     std::string qname;  // 1)队列名称
  20.     std::vector<Consumer::ptr> _consumers;  // 2)消费者管理结构: vector
  21.     uint64_t _rr_seq;   // 3)轮转序号
  22.     std::mutex _mutex;  // 4)互斥锁:保证线程安全
  23. };
复制代码
  声明对消费者的同一管理类
  1. class ConsumerManager
  2. {
  3. public:
  4.     ConsumerManager()
  5.     {}
  6.     // 1)初始化/删除队列的消费者信息结构(创建/删除队列的时候初始化)
  7.     void initQueueConsumer(const std::string& qname);
  8.     // 2)移除指定队列的所有消费者(队列被删除时销毁):删除消费者的队列管理单元对象
  9.     void destroyQueueConsumer(const std::string& qname);
  10.     // 3)向指定队列新增消费者(客户端订阅指定队列消息的时候):新增完成的时候返回消费者对象
  11.     Consumer::ptr create(const std::string &ctag, const std::string& queue_name, bool ack_flag, ConsumerCallBack& cb);
  12.     // 4)从指定队列移除消费者(客户端取消订阅的时候)
  13.     void remove(const std::string& ctag, const std::string& queue_name);
  14.     // 5)从指定队列获取一个消费者(轮询获取-消费者轮换消费起到负载均衡的作用)
  15.     Consumer::ptr choose(const std::string& queue_name);
  16.     // 6)判断队列中指定消费者是否存在
  17.     bool empty(const std::string& queue_name);
  18.     // 7)判断队列中指定消费者是否存在
  19.     bool exists(const std::string& ctag, const std::string& queue_name);
  20.     // 8)清理所有消费者
  21.     void clear();
  22.    
  23. private:
  24.     std::mutex _mutex;
  25.     std::unordered_map<std::string, QueueConsumer::ptr> _qconsumers;
  26. };
复制代码


   定义消费者管理类
  1. //2. 消费者管理--以队列为单元进行管理-队列消费者管理结构
  2. class QueueConsumer
  3. {
  4. public:
  5.     using ptr = std::shared_ptr<QueueConsumer>;
  6.     QueueConsumer()
  7.     {}
  8.     QueueConsumer(const std::string& qname)
  9.         : _qname(qname)
  10.         , _rr_seq(0)
  11.     {}
  12.     // 1)新增消费者:信道提供的服务是订阅队列消息的时候创建
  13.     Consumer::ptr create(const std::string &ctag, const std::string& queue_name, bool ack_flag, const ConsumerCallBack& cb)
  14.     {
  15.         //1.加锁
  16.         std::unique_lock<std::mutex> lock(_mutex);
  17.         //2.判断消费者是否重复
  18.         for (auto& cmp : _consumers)
  19.         {
  20.             if (cmp->tag == ctag)
  21.                 return {};
  22.         }
  23.         //3.没有重复则新增————构造对象
  24.         auto consumer = std::make_shared<Consumer>(ctag, queue_name, ack_flag, cb);
  25.         //4.添加管理后返回对象
  26.         _consumers.push_back(consumer);
  27.         return consumer;
  28.     }
  29.     // 2)删除消费者:取消订阅 / 信道关闭 / 连接关闭 的时候删除
  30.     void remove(const std::string& ctag)
  31.     {
  32.         std::unique_lock<std::mutex> lock(_mutex);
  33.         for (auto it = _consumers.begin(); it != _consumers.end(); ++it)
  34.         {
  35.             if ((*it)->tag == ctag)
  36.             {
  37.                 _consumers.erase(it);
  38.                 return;
  39.             }
  40.         }
  41.     }
  42.     // 3)获取消费者:从队列所有的消费者中按序取出一个消费者进行消息的推送
  43.     Consumer::ptr choose()
  44.     {
  45.         std::unique_lock<std::mutex> lock(_mutex);
  46.         if (_consumers.size() == 0)
  47.             return {};
  48.         //获取轮转下标
  49.         int idx = _rr_seq % _consumers.size();
  50.         ++_rr_seq;
  51.         //返回结果
  52.         return _consumers[idx];
  53.     }
  54.    
  55.     // 4)判断队列消费者是否为空
  56.     bool empty()
  57.     {
  58.         std::unique_lock<std::mutex> lock(_mutex);
  59.         return _consumers.size() == 0;
  60.     }
  61.     // 5)判断指定消费者是否存在
  62.     bool exists(const std::string& ctag)
  63.     {
  64.         std::unique_lock<std::mutex> lock(_mutex);
  65.         for (auto it = _consumers.begin(); it != _consumers.end(); ++it)
  66.         {
  67.             if ((*it)->tag == ctag)
  68.             {
  69.                 return true;
  70.             }
  71.         }
  72.         return false;
  73.     }
  74.     // 6)清理队列所有消费者
  75.     void clear()
  76.     {
  77.         std::unique_lock<std::mutex> lock(_mutex);
  78.         _consumers.clear();
  79.         _rr_seq = 0;
  80.     }
  81. private:
  82.     std::string _qname;  // 1)队列名称
  83.     std::vector<Consumer::ptr> _consumers;  // 2)消费者管理结构: vector
  84.     uint64_t _rr_seq;   // 3)轮转序号
  85.     std::mutex _mutex;  // 4)互斥锁:保证线程安全
  86. };
复制代码
团体代码的编写还是比力简单的,这里不外多赘述了。

   定义对消费者的同一管理类
  1. class ConsumerManager
  2. {
  3. public:
  4.     using ptr = std::shared_ptr<ConsumerManager>;
  5.     ConsumerManager()
  6.     {}
  7.     // 1)初始化/删除队列的消费者信息结构(创建/删除队列的时候初始化)
  8.     void initQueueConsumer(const std::string& qname)
  9.     {
  10.         std::unique_lock<std::mutex> lock(_mutex);
  11.         auto it = _qconsumers.find(qname);
  12.         if (it != _qconsumers.end())
  13.             return;
  14.         auto qconsumers = std::make_shared<QueueConsumer>(qname);
  15.         _qconsumers.insert({qname, qconsumers});
  16.     }
  17.     // 2)移除指定队列的所有消费者(队列被删除时销毁):删除消费者的队列管理单元对象
  18.     void destroyQueueConsumer(const std::string& qname)
  19.     {
  20.         std::unique_lock<std::mutex> lock(_mutex);
  21.         auto it = _qconsumers.find(qname);
  22.         if (it == _qconsumers.end())
  23.             return;
  24.         _qconsumers.erase(it);
  25.     }
  26.     // 3)向指定队列新增消费者(客户端订阅指定队列消息的时候):新增完成的时候返回消费者对象
  27.     Consumer::ptr create(const std::string &ctag, const std::string& queue_name, bool ack_flag, const ConsumerCallBack& cb)
  28.     {
  29.         QueueConsumer::ptr qcp;
  30.         {
  31.             std::unique_lock<std::mutex> lock(_mutex);
  32.             //获取消费者管理单元
  33.             auto it = _qconsumers.find(queue_name);
  34.             if (it == _qconsumers.end())
  35.             {
  36.                 DLOG("没有找到队列%s的消息管理句柄", queue_name.c_str());
  37.                 return {};
  38.             }
  39.             qcp = it->second;
  40.         }
  41.         //通过句柄完成创建
  42.         return qcp->create(ctag, queue_name, ack_flag, cb);
  43.     }
  44.     // 4)从指定队列移除消费者(客户端取消订阅的时候)
  45.     void remove(const std::string& ctag, const std::string& queue_name)
  46.     {
  47.         QueueConsumer::ptr qcp;
  48.         {
  49.             std::unique_lock<std::mutex> lock(_mutex);
  50.             //获取消费者管理单元
  51.             auto it = _qconsumers.find(queue_name);
  52.             if (it == _qconsumers.end())
  53.             {
  54.                 DLOG("没有找到队列%s的消息管理句柄", queue_name.c_str());
  55.                 return ;
  56.             }
  57.             qcp = it->second;
  58.         }
  59.         //通过句柄完成删除
  60.         return qcp->remove(ctag);
  61.     }
  62.     // 5)从指定队列获取一个消费者(轮询获取-消费者轮换消费起到负载均衡的作用)
  63.     Consumer::ptr choose(const std::string& queue_name)
  64.     {
  65.         QueueConsumer::ptr qcp;
  66.         {
  67.             std::unique_lock<std::mutex> lock(_mutex);
  68.             //获取消费者管理单元
  69.             auto it = _qconsumers.find(queue_name);
  70.             if (it == _qconsumers.end())
  71.             {
  72.                 DLOG("没有找到队列%s的消息管理句柄", queue_name.c_str());
  73.                 return {};
  74.             }
  75.             qcp = it->second;
  76.         }
  77.         //通过句柄完成获取消费者
  78.         return qcp->choose();
  79.     }
  80.     // 6)判断队列中指定消费者是否存在
  81.     bool empty(const std::string& queue_name)
  82.     {
  83.         QueueConsumer::ptr qcp;
  84.         {
  85.             std::unique_lock<std::mutex> lock(_mutex);
  86.             //获取消费者管理单元
  87.             auto it = _qconsumers.find(queue_name);
  88.             if (it == _qconsumers.end())
  89.             {
  90.                 DLOG("没有找到队列%s的消息管理句柄", queue_name.c_str());
  91.                 return false;
  92.             }
  93.             qcp = it->second;
  94.         }
  95.         return qcp->empty();
  96.     }
  97.     // 7)判断队列中指定消费者是否存在
  98.     bool exists(const std::string& ctag, const std::string& queue_name)
  99.     {
  100.         QueueConsumer::ptr qcp;
  101.         {
  102.             std::unique_lock<std::mutex> lock(_mutex);
  103.             //获取消费者管理单元
  104.             auto it = _qconsumers.find(queue_name);
  105.             if (it == _qconsumers.end())
  106.             {
  107.                 DLOG("没有找到队列%s的消息管理句柄", queue_name.c_str());
  108.                 return false;
  109.             }
  110.             qcp = it->second;
  111.         }
  112.         //通过句柄完成删除
  113.         return qcp->exists(ctag);
  114.     }
  115.     // 8)清理所有消费者
  116.     void clear()
  117.     {
  118.         std::unique_lock<std::mutex> lock(_mutex);
  119.         _qconsumers.clear();
  120.     }
  121.    
  122. private:
  123.     std::mutex _mutex;
  124.     std::unordered_map<std::string, QueueConsumer::ptr> _qconsumers;
  125. };
复制代码
留意:每个成员函数在获取完消费者管理句柄后,通过句柄对实行对应语句是不消被锁管理的,由于每个消费者管理句柄在内部都存在一把锁,已经可以保证线程安全了,为了制止锁冲突和进步服从,所以该语句不被锁管理。


单元测试:
  1. bitmq::ConsumerManager::ptr cmp;
  2. class ConsumerTest : public testing::Environment
  3. {
  4. public:
  5.     virtual void SetUp() override
  6.     {
  7.         cmp = std::make_shared<bitmq::ConsumerManager>();
  8.         cmp->initQueueConsumer("queue1");
  9.     }
  10.     virtual void TearDown() override
  11.     { }
  12. };
  13. void cb(const std::string &ctag, const bitmq::BasicProperties* bp, const std::string& queue_name)
  14. {
  15. }
  16. TEST(consumer_test, insert_test)
  17. {
  18.     cmp->create("consumer1", "queue1", true, cb);
  19.     cmp->create("consumer2", "queue1", true, cb);
  20.     cmp->create("consumer3", "queue1", true, cb);
  21.     ASSERT_EQ(cmp->exists("consumer1", "queue1"), true);
  22.     ASSERT_EQ(cmp->exists("consumer2", "queue1"), true);
  23.     ASSERT_EQ(cmp->exists("consumer3", "queue1"), true);
  24.     ASSERT_EQ(cmp->exists("consumer1", "queue2"), false);
  25. }
  26. TEST(consumer_test, remove_test)
  27. {
  28.     cmp->remove("consumer1", "queue1");
  29.     ASSERT_EQ(cmp->exists("consumer1", "queue1"), false);
  30.     ASSERT_EQ(cmp->exists("consumer2", "queue1"), true);
  31.     ASSERT_EQ(cmp->exists("consumer3", "queue1"), true);
  32. }
  33. TEST(consumer_test, choose_test)
  34. {
  35.     bitmq::Consumer::ptr cp1 = cmp->choose("queue1");
  36.     ASSERT_NE(cp1.get(), nullptr);
  37.     ASSERT_EQ(cp1->tag, "consumer2");
  38.    
  39.     bitmq::Consumer::ptr cp2 = cmp->choose("queue1");
  40.     ASSERT_NE(cp2.get(), nullptr);
  41.     ASSERT_EQ(cp2->tag, "consumer3");
  42.     bitmq::Consumer::ptr cp3 = cmp->choose("queue1");
  43.     ASSERT_NE(cp3.get(), nullptr);
  44.     ASSERT_EQ(cp3->tag, "consumer2");
  45. }
  46. int main(int argc, char* argv[])
  47. {
  48.     testing::InitGoogleTest(&argc, argv);
  49.     testing::AddGlobalTestEnvironment(new ConsumerTest);
  50.     RUN_ALL_TESTS();
  51.     return 0;
  52. }
复制代码
实行结果:


8.11 信道管理模块

在 AMQP 模型中,除了通信毗连 Connection 概念外,还有一个 Channel 的概念, Channel 是针对 Connection 毗连的一个更细粒度的通信信道,多个 Channel 可以使用同一个通信毗连 Connection 举行通信,但是同一个 Connection 的 Channel 之间相互独立。
而信道模块就是再次将上述模块举行整合提供服务的模块,信道的作用就是给用户提供服务。
1. 管理信息:


  • 1)信道 ID:信道的唯一标识
  • 2)信道关联的消费者:用于消费者信道在关闭的时候取消订阅,删除订阅者信息
  • 3)信道关联的毗连:用于向客户端发送数据(响应,推送的消息)
  • 4)protobuf 协议处理句柄:网络通信前的协议处理
  • 5)消费者管理句柄:信道关闭/取消订阅的时候,通过句柄删除订阅者信息
  • 6)虚拟机句柄:交换机/队列/绑定/消息数据管理
  • 7)工作线程池句柄(一条消息被发布到队列后,需要将消息推送给订阅了对应队列的消费者,过程由线程池完成)

2. 管理操作:


  • 1)提供声明&删除交换机操作(删除交换机的同时删除交换机关联的绑定信息)
  • 2)提供声明&删除队列操作(删除队列的同时,删除队列关联的绑定信息,消息,消费者信息)
  • 3)提供绑定&解绑队列操作
  • 4)提供订阅&取消订阅队列消息操作
  • 5)提供发布&确认消息操作

3. 信道管理


  • 1)新增一条信道信道
  • 2)删除指定信道
  • 3)获取指定信道

   信道类
  1. #include "muduo/net/TcpConnection.h"
  2. #include "muduo/proto/codec.h"
  3. #include "muduo/proto/dispatcher.h"
  4. #include "../mqcommon/mq_helper.hpp"
  5. #include "../mqcommon/mq_logger.hpp"
  6. #include "../mqcommon/mq_msg.pb.h"
  7. #include "../mqcommon/mq_proto.pb.h"
  8. #include "../mqcommon/mq_threadpool.hpp"
  9. #include "mq_virtualhost.hpp"
  10. #include "mq_consumer.hpp"
  11. using ProtobufCodecPtr = std::shared_ptr<ProtobufCodec>;
  12. class Channel
  13. {
  14. public:
  15.     Channel(const std::string& id,
  16.         const VirtualHost::ptr& host,
  17.         ConsumerManager::ptr& cmp,
  18.         const ProtobufCodecPtr& codec,
  19.         const muduo::net::TcpConnectionPtr& conn,
  20.         const threadpool::ptr& pool)
  21.     {}
  22.     ~Channel();
  23.     //1)声明交换机
  24.     void declareExchange();
  25.     //2)删除交换机
  26.     void deleteExchange();
  27.     //3)声明队列
  28.     void declarQueue();
  29.     //4)删除队列
  30.     void deleteQueue();
  31.     //5)队列的绑定
  32.     void bind();
  33.     //6)队列的解绑定
  34.     void unBind();
  35.     //7)发布消息
  36.     void basicPublish();
  37.     //8)确认消息
  38.     void basicAck();
  39.     //9)订阅队列
  40.     void basicConsume();
  41.     //10)取消订阅
  42.     void basicCancel();
  43. private:
  44.     std::string _cid;           // 1)信道 ID:信道的唯一标识
  45.     Consumer::ptr _consumer;    // 2)信道关联的消费者
  46.     muduo::net::TcpConnectionPtr _conn;  // 3)信道关联的连接:用于向客户端发送数据(响应,推送的消息)
  47.     ProtobufCodecPtr _code;      // 4)protobuf 协议处理句柄:网络通信前的协议处理
  48.     ConsumerManager::ptr _cmp;  // 5)消费者管理句柄:信道关闭/取消订阅的时候,通过句柄删除订阅者信息
  49.     VirtualHost::ptr _host;     // 6)虚拟机句柄:交换机/队列/绑定/消息数据管理
  50.     threadpool::ptr _pool;      // 7)线程池
  51. };
复制代码


  • 可以看到每个成员函数的参数都没有填写,那是由于如果按照之前的参数,那么需要传递的参数太多了,我们期望将这些参数封装成一个对象,传递时只需传递一个对象进去就好了。
  • 更告急的是,上面的全部函数起其实就是给客户端提供服务的,也就是说全部的参数数据都是要颠末网络的,而我们不可能将一个哀求的全部参数都分开传递,所以对参数的封装工作就比力告急了。而数据在网络中的传输势必会导致粘包问题,所以我们还需要制定网络通信协议。
我们前面编写的基于muduo实现protobuf通信协议的例子中也是如许写的,如许写可以使代码更加整洁直观。
  1. class ProtoServer
  2. {
  3.     typedef shared_ptr<request::TranslateRequest> TranslateRequestPtr;
  4.     typedef shared_ptr<request::TranslateResponse> TranslateResponsePtr;
  5.     typedef shared_ptr<request::CalculatorRequest> CalculatorRequestPtr;
  6.     typedef shared_ptr<request::CalculatorResponse> CalculatorResponsePtr;
  7. public:
  8.     void onTranslate(const muduo::net::TcpConnectionPtr& conn, const TranslateRequestPtr& req, muduo::Timestamp rt);
  9.     void onCalculator(const muduo::net::TcpConnectionPtr& conn, const CalculatorRequestPtr& req, muduo::Timestamp rt);
  10.     void onConnection(const muduo::net::TcpConnectionPtr& conn);
  11.     void onUnknownMessage(const muduo::net::TcpConnectionPtr& conn, const MessagePtr& message, muduo::Timestamp);
  12.    
  13. private:
  14.     muduo::net::EventLoop _baseloop;
  15.     muduo::net::TcpServer _server;
  16.     ProtobufDispatcher _dispatcher;
  17.     ProtobufCodec _codec;
  18. };
复制代码
也就是说我们需要本身制定协议,将上述所需函数参数举行封装,而这些参数是会颠末网络流传的,所以我们接纳protobuf来完成封装工作。
关于网络通信协议的设计不放在这一章节讲,请通过目录找到 [9.网络通信协议设计]部分,细致阅读完后再返回该位置。


在编写好网络通信协议部分的proto文件后,使用protoc生成对应的.h和.cc文件,再让我们的文件包含刚刚生成的.h文件。
我们期望用智能指针来帮我们管理全部的对象,所以更新我们的代码,如下:
  1. using ProtobufCodecPtr = std::shared_ptr<ProtobufCodec>;
  2. using openChannelRequestPtr = std::shared_ptr<openChannelRequest>;
  3. using closeChannelRequestPtr = std::shared_ptr<closeChannelRequest>;
  4. using declareExchangeRequestPtr = std::shared_ptr<declareExchangeRequest>;
  5. using deleteExchangeRequestPtr = std::shared_ptr<deleteExchangeRequest>;
  6. using declareQueueRequestPtr = std::shared_ptr<declareQueueRequest>;
  7. using deleteQueueRequestPtr = std::shared_ptr<deleteQueueRequest>;
  8. using queueBindRequestPtr = std::shared_ptr<queueBindRequest>;
  9. using queueUnBindRequestPtr = std::shared_ptr<queueUnBindRequest>;
  10. using basicPublishRequestPtr = std::shared_ptr<basicPublishRequest>;
  11. using basicAckRequestPtr = std::shared_ptr<basicAckRequest>;
  12. using basicConsumeRequestPtr = std::shared_ptr<basicConsumeRequest>;
  13. using basicCancelRequestPtr = std::shared_ptr<basicCancelRequest>;
  14. class Channel
  15. {
  16. public:
  17.     Channel(const std::string& id,
  18.         const VirtualHost::ptr& host,
  19.         ConsumerManager::ptr& cmp,
  20.         const ProtobufCodecPtr& codec,
  21.         const muduo::net::TcpConnectionPtr& conn,
  22.         const threadpool::ptr pool)
  23.             : _cid(id)
  24.             , _conn(conn)
  25.             , _codec(codec)
  26.             , _cmp(cmp)
  27.             , _pool(pool)
  28.     {}
  29.     ~Channel();
  30.     //1)声明交换机
  31.     void declareExchange(const declareExchangeRequestPtr& req);
  32.     //2)删除交换机
  33.     void deleteExchange(const deleteExchangeRequestPtr& req);
  34.     //3)声明队列
  35.     void declarQueue(const declareQueueRequestPtr& req);
  36.     //4)删除队列
  37.     void deleteQueue(const deleteQueueRequestPtr& req);
  38.     //5)队列的绑定
  39.     void bind(const queueBindRequestPtr& req);
  40.     //6)队列的解绑定
  41.     void unBind(const queueUnBindRequestPtr& req);
  42.     //7)发布消息
  43.     void basicPublish(const basicPublishRequestPtr req);
  44.     //8)确认消息
  45.     void basicAck(const basicAckRequestPtr& req);
  46.     //9)订阅队列
  47.     void basicConsume(const basicConsumeRequestPtr& req);
  48.     //10)取消订阅
  49.     void basicCancel(const basicCancelRequestPtr& req);
  50. private:
  51.     std::string _cid;           // 1)信道 ID:信道的唯一标识
  52.     Consumer::ptr _consumer;    // 2)信道关联的消费者
  53.     muduo::net::TcpConnectionPtr _conn;  // 3)信道关联的连接:用于向客户端发送数据(响应,推送的消息)
  54.     ProtobufCodecPtr _codec;      // 4)protobuf 协议处理句柄:网络通信前的协议处理
  55.     ConsumerManager::ptr _cmp;  // 5)消费者管理句柄:信道关闭/取消订阅的时候,通过句柄删除订阅者信息
  56.     VirtualHost::ptr _host;     // 6)虚拟机句柄:交换机/队列/绑定/消息数据管理
  57.     threadpool::ptr _pool;      // 7)线程池
  58. };
复制代码
  定义信道类
  1. using ProtobufCodecPtr = std::shared_ptr<ProtobufCodec>;
  2. using openChannelRequestPtr = std::shared_ptr<openChannelRequest>;
  3. using closeChannelRequestPtr = std::shared_ptr<closeChannelRequest>;
  4. using declareExchangeRequestPtr = std::shared_ptr<declareExchangeRequest>;
  5. using deleteExchangeRequestPtr = std::shared_ptr<deleteExchangeRequest>;
  6. using declareQueueRequestPtr = std::shared_ptr<declareQueueRequest>;
  7. using deleteQueueRequestPtr = std::shared_ptr<deleteQueueRequest>;
  8. using queueBindRequestPtr = std::shared_ptr<queueBindRequest>;
  9. using queueUnBindRequestPtr = std::shared_ptr<queueUnBindRequest>;
  10. using basicPublishRequestPtr = std::shared_ptr<basicPublishRequest>;
  11. using basicAckRequestPtr = std::shared_ptr<basicAckRequest>;
  12. using basicConsumeRequestPtr = std::shared_ptr<basicConsumeRequest>;
  13. using basicCancelRequestPtr = std::shared_ptr<basicCancelRequest>;
  14. class Channel
  15. {
  16. public:
  17.     Channel(const std::string& id,
  18.         const VirtualHost::ptr& host,
  19.         ConsumerManager::ptr& cmp,
  20.         const ProtobufCodecPtr& codec,
  21.         const muduo::net::TcpConnectionPtr& conn,
  22.         const threadpool::ptr pool)
  23.             : _cid(id)
  24.             , _conn(conn)
  25.             , _codec(codec)
  26.             , _cmp(cmp)
  27.             , _pool(pool)
  28.     {}
  29.     ~Channel()
  30.     {
  31.         //删除信道对应的消费者
  32.         if (_consumer.get() != nullptr)
  33.         {
  34.             _cmp->remove(_consumer->tag, _consumer->qname);
  35.         }
  36.     }
  37.     //1)声明交换机
  38.     void declareExchange(const declareExchangeRequestPtr& req)
  39.     {
  40.         bool ret = _host->declareExchange(req->exchange_name(), req->exchange_type(),
  41.             req->durable(), req->auto_delete(), req->args());
  42.         return basicResponse(ret, req->rid(), req->cid());
  43.     }
  44.     //2)删除交换机
  45.     void deleteExchange(const deleteExchangeRequestPtr& req)
  46.     {
  47.         _host->deleteExchange(req->exchange_name());   
  48.         return basicResponse(true, req->rid(), req->cid());
  49.     }
  50.     //3)声明队列
  51.     void declarQueue(const declareQueueRequestPtr& req)
  52.     {
  53.         bool ret = _host->declareQueue(req->queue_name(), req->durable(), req->exclusive(),
  54.             req->auto_delete(), req->args());
  55.         if (ret == false)
  56.             return;
  57.         //初始化队列的消费者管理句柄
  58.         _cmp->initQueueConsumer(req->queue_name());
  59.         return basicResponse(true, req->rid(), req->cid());
  60.     }
  61.     //4)删除队列
  62.     void deleteQueue(const deleteQueueRequestPtr& req)
  63.     {
  64.         _host->deleteQueue(req->queue_name());
  65.         _cmp->destroyQueueConsumer(req->queue_name());
  66.         return basicResponse(true, req->rid(), req->cid());
  67.     }
  68.     //5)队列的绑定
  69.     void queuebind(const queueBindRequestPtr& req)
  70.     {
  71.         bool ret = _host->bind(req->exchange_name(), req->queue_name(),
  72.             req->binding_key());
  73.         return basicResponse(ret, req->rid(), req->cid());
  74.     }
  75.     //6)队列的解绑定
  76.     void queueUnBind(const queueUnBindRequestPtr& req)
  77.     {
  78.         _host->unBind(req->exchange_name(), req->queue_name());
  79.         return basicResponse(true, req->rid(), req->cid());
  80.     }
  81.     //7)发布消息
  82.     void basicPublish(const basicPublishRequestPtr req)
  83.     {
  84.         //1.判断交换机是否存在
  85.         auto ep = _host->selectExchange(req->exchange_name());
  86.         if (ep.get() == nullptr)
  87.             return basicResponse(true, req->rid(), req->cid());
  88.         //2.进行交换路由,判断消息可以发布到交换机哪个队列中
  89.         MsgQueueBindingMap mqbm = _host->exchangeBindings(req->exchange_name());
  90.         BasicProperties* bp = nullptr;
  91.         std::string routing_key;
  92.         //判断properties是否为空
  93.         if (req->has_properties() != false)
  94.         {
  95.             routing_key = req->properties().routing_key();
  96.             bp = req->mutable_properties();
  97.         }
  98.         for (auto& binding : mqbm)
  99.         {
  100.             if (Router::route(ep->type, routing_key, binding.second->binding_key))
  101.             {
  102.                 //消息匹配成功,则将该消息加入队列
  103.                 _host->basicPublish(binding.first, bp, req->body());
  104.                 //向线程池中添加一个消息消费任务(向指定队列的订阅者去推送消息————由线程池完成
  105.                 auto task = std::bind(&Channel::publish, this, binding.first);
  106.                 _pool->push(task);
  107.             }
  108.         }
  109.     }
  110.     //8)确认消息
  111.     void basicAck(const basicAckRequestPtr& req)
  112.     {
  113.         _host->basicAck(req->queue_name(), req->message_id());
  114.         return basicResponse(true, req->rid(), req->cid());
  115.     }
  116.     //9)订阅队列
  117.     void basicConsume(const basicConsumeRequestPtr& req)
  118.     {
  119.         //1.判断队列是否存在
  120.         bool ret = _host->existsQueue(req->queue_name());
  121.         if (ret == false)
  122.         {
  123.             DLOG("订阅队列失败,%s队列不存在", req->queue_name().c_str());
  124.             return;
  125.         }
  126.         //2.创建队列消费者
  127.         auto cb = std::bind(&Channel::callback, this, std::placeholders::_1,
  128.             std::placeholders::_2, std::placeholders::_3);
  129.         //在创建了消费者之后,当前的channel角色就是一个消费者
  130.         //该消费者需要保存起来,以便在取消订阅 / 删除信道后删除对应的消费者(以防资源泄露)
  131.         _consumer = _cmp->create(req->consumer_tag(), req->queue_name(), req->auto_ack(), cb);
  132.     }
  133.     //10)取消订阅
  134.     void basicCancel(const basicCancelRequestPtr& req)
  135.     {
  136.         _cmp->remove(req->consumer_tag(), req->queue_name());
  137.         return basicResponse(true, req->rid(), req->cid());
  138.     }
  139. private:
  140.     void callback(const std::string& tag,  const BasicProperties* bp, const std::string& body)
  141.     {
  142.         //针对参数组织处推送消息请求,将消息推送给channel对应的客户端
  143.         basicConsumeResponse resp;
  144.         resp.set_cid(_cid);
  145.         resp.set_body(body);
  146.         resp.set_consumer_tag(tag);
  147.         if (bp != nullptr)
  148.         {
  149.             resp.mutable_properties()->set_id(bp->id());
  150.             resp.mutable_properties()->set_delivery_mode(bp->delivery_mode());
  151.             resp.mutable_properties()->set_routing_key(bp->routing_key());
  152.         }
  153.         _codec->send(_conn, resp);
  154.     }
  155.     void publish(const std::string& qname)
  156.     {
  157.         //指定队列消费消息
  158.         //1.从队列中获取一条消息
  159.         MessagePtr mp = _host->basicConsume(qname);
  160.         if (mp.get() == nullptr)
  161.         {
  162.             DLOG("执行消费任务时,%s队列没有消息", qname.c_str());
  163.             return;
  164.         }
  165.         //2.从队列订阅者中取出一个订阅者
  166.         Consumer::ptr cmp = _cmp->choose(qname);
  167.         if (mp.get() == nullptr)
  168.         {
  169.             DLOG("执行消费任务时,%s队列没有订阅者", qname.c_str());
  170.             return;
  171.         }
  172.         //3.调用订阅者对应的消息处理函数,实现消息的推送
  173.         cmp->callback(cmp->tag, mp->mutable_payload()->mutable_properties(), mp->payload().body());
  174.         //4.判断如果订阅者是自动确认——不需要等待确认,直接删除消息,否则需要收到确认后再删除
  175.         if (cmp->auto_ack == true)
  176.         {
  177.             _host->basicAck(qname, cmp->tag);
  178.         }
  179.     }
  180.     void basicResponse(bool ok, const std::string& rid, const std::string& cid)
  181.     {
  182.         basicCommonResponse resp;
  183.         resp.set_rid(rid);
  184.         resp.set_cid(cid);
  185.         resp.set_is_ok(ok);
  186.         _codec->send(_conn, resp);
  187.     }
  188. private:
  189.     std::string _cid;           // 1)信道 ID:信道的唯一标识
  190.     Consumer::ptr _consumer;    // 2)信道关联的消费者
  191.     muduo::net::TcpConnectionPtr _conn;  // 3)信道关联的连接:用于向客户端发送数据(响应,推送的消息)
  192.     ProtobufCodecPtr _codec;      // 4)protobuf 协议处理句柄:网络通信前的协议处理
  193.     ConsumerManager::ptr _cmp;  // 5)消费者管理句柄:信道关闭/取消订阅的时候,通过句柄删除订阅者信息
  194.     VirtualHost::ptr _host;     // 6)虚拟机句柄:交换机/队列/绑定/消息数据管理
  195.     threadpool::ptr _pool;      // 7)线程池
  196. };
复制代码


  • 每个哀求在实行完后,都应该对哀求举行响应,我们同一使用baasicResponse函数举行响应;
  • 发布消息basicPublish函数较为复杂,发布消息首先要找到对应的交换机是否存在,然后与该交换机关联的全部队列的binding_key举行比力,如果能匹配成功则参加对应的队列中。而当队列中有消息时,就应该将消息推送给消费者,我们将这个使命交给线程池处理,所以这里有了一个回调函数publish。
  • 订阅队列basicConsume函数也比力复杂,复杂的地方在于这个回调函数,publish的函数逻辑是获取一个消息,再获取一个消费者,再将消息推送给消费者,而最后一步将消息推送给消费者的使命就是由callback回调函数实行的,该函数在内部会构造Response并将消息发送给消费者。所以我们在订阅队列时需要创建该回调

   信道管理类
  1. class ChannelManager
  2. {
  3. public:
  4.     using ptr = std::shared_ptr<ChannelManager>;
  5.     ChannelManager()
  6.     {}
  7.     bool openChannel(const std::string& id,
  8.         const VirtualHost::ptr& host,
  9.         ConsumerManager::ptr& cmp,
  10.         const ProtobufCodecPtr& codec,
  11.         const muduo::net::TcpConnectionPtr& conn,
  12.         const threadpool::ptr pool)
  13.     {
  14.         std::unique_lock<std::mutex> lock(_mutex);
  15.         auto it = _channels.find(id);
  16.         if (it != _channels.end())
  17.         {
  18.             return false;
  19.         }
  20.         auto channel = std::make_shared<Channel>(id, host, cmp, codec, conn, pool);
  21.         _channels.insert({id, channel});
  22.         return true;
  23.     }
  24.     void closeChannel(const std::string& id)
  25.     {
  26.         std::unique_lock<std::mutex> lock(_mutex);
  27.         _channels.erase(id);
  28.     }
  29.     Channel::ptr getChannel(const std::string& id)
  30.     {
  31.         std::unique_lock<std::mutex> lock(_mutex);
  32.         auto it = _channels.find(id);
  33.         if (it != _channels.end())
  34.         {
  35.             return {};
  36.         }
  37.         return it->second;
  38.     }
  39. private:
  40.     std::mutex _mutex;
  41.     std::unordered_map<std::string, Channel::ptr> _channels;
  42. };
复制代码


这部分内容无法完成单元测试,由于该部分的代码还包含了网络部分,而这部分我们现在还没有完成,我们先测试一下编译能否通过。
编写makefile:
  1. test:mq_channeltest.cpp ../../mqcommon/mq_msg.pb.cc ../../mqcommon/mq_proto.pb.cc
  2.         g++ -o $@ $^ -std=c++11 -lgtest -lprotobuf -lsqlite3 -w -g -I../../third/include
  3. .PHONY:clean
  4. clean:
  5.         rm -rf test
复制代码

编译成功。


8.12 毗连受理模块

向用户提供一个用于实现网络通信的 Connection 对象,从其内部可创建出粒度更轻的Channel 对象,用于与客户端举行网络通信。
1. 成员信息:


  • a. 毗连关联的信道管理句柄(实现信道的增删查)
  • b. 毗连关联的实际用于通信的 muduo::net::Connection 毗连
  • c. protobuf 协议处理的句柄(ProtobufCodec 对象)
  • d. 消费者管理句柄
  • e. 虚拟机句柄
  • f. 异步工作线程池句柄

2. 毗连操作:


  • a. 提供创建 Channel 信道的操作
  • b. 提供删除 Channel 信道的操作

3. 毗连受理:


  • a. 毗连的增删查
   毗连类
  1. class Connection
  2. {
  3. public:
  4.     Connection(const VirtualHost::ptr& host,
  5.         const ConsumerManager::ptr& cmp,
  6.         const ProtobufCodecPtr& codec,
  7.         const muduo::net::TcpConnectionPtr& conn,
  8.         const threadpool::ptr& pool)
  9.             : _conn(conn)
  10.             , _codec(codec)
  11.             , _cmp(cmp)
  12.             , _host(host)
  13.             , _pool(pool)
  14.             , _channels(std::make_shared<ChannelManager>())
  15.     {}
  16.     ~Connection();
  17.     void openChannel(const openChannelRequestPtr& req)
  18.     {
  19.         bool ret = _channels->openChannel(req->rid(), _host, _cmp,
  20.             _codec, _conn, _pool);
  21.         return basicResponse(true, req->rid(), req->cid());
  22.     }
  23.     void closeChannel(const closeChannelRequestPtr& req)
  24.     {
  25.         _channels->closeChannel(req->cid());
  26.         return basicResponse(true, req->rid(), req->cid());
  27.     }
  28. private:
  29.     void basicResponse(bool ok, const std::string& rid, const std::string& cid)
  30.     {
  31.         basicCommonResponse resp;
  32.         resp.set_rid(rid);
  33.         resp.set_cid(cid);
  34.         resp.set_is_ok(ok);
  35.         _codec->send(_conn, resp);
  36.     }
  37. private:
  38.     VirtualHost::ptr _host;
  39.     ConsumerManager::ptr _cmp;
  40.     ProtobufCodecPtr _codec;
  41.     muduo::net::TcpConnectionPtr _conn;
  42.     threadpool::ptr _pool;
  43.     ChannelManager::ptr _channels; //一个连接关闭了,所有的信道也要析构
  44. };
复制代码
毗连类的编写还是比力简单的就是将前面的内容再次整合。越往子女码的编写越简单,而框架的头脑越来越明显
   毗连受理类
  1. class ConnectionManager
  2. {
  3. public:
  4.     ConnectionManager()
  5.     {}
  6.     void newConnection(const VirtualHost::ptr& host,
  7.         const ConsumerManager::ptr& cmp,
  8.         const ProtobufCodecPtr& codec,
  9.         const muduo::net::TcpConnectionPtr& conn,
  10.         const threadpool::ptr& pool)
  11.     {
  12.         std::unique_lock<std::mutex> lock(_mutex);
  13.         auto it = _connections.find(conn);
  14.         if (it != _connections.end())
  15.         {
  16.             return;
  17.         }
  18.         auto newConn = std::make_shared<Connection>(host, cmp, codec, conn, pool);
  19.         _connections.insert({conn, newConn});
  20.     }
  21.     void delConnection(const muduo::net::TcpConnectionPtr& conn)
  22.     {
  23.         std::unique_lock<std::mutex> lock(_mutex);
  24.         auto it = _connections.find(conn);
  25.         if (it == _connections.end())
  26.         {
  27.             return;
  28.         }
  29.         _connections.erase(it);
  30.     }
  31.     Connection::ptr getConnection(const muduo::net::TcpConnectionPtr& conn)
  32.     {
  33.         std::unique_lock<std::mutex> lock(_mutex);
  34.         std::unique_lock<std::mutex> lock(_mutex);
  35.         auto it = _connections.find(conn);
  36.         if (it == _connections.end())
  37.         {
  38.             return {};
  39.         }
  40.         return it->second;
  41.     }
  42. private:
  43.     std::mutex _mutex;
  44.     std::unordered_map<muduo::net::TcpConnectionPtr, Connection::ptr> _connections;
  45. };
复制代码
同样这里也是无法直接测试的,我们测试一下编译能否通过即可。
编写makefile:
  1. test:mq_connectiontest.cpp ../../mqcommon/mq_msg.pb.cc ../../mqcommon/mq_proto.pb.cc
  2.         g++ -o $@ $^ -std=c++11 -lgtest -lprotobuf -lsqlite3 -w -g -I../../third/include
  3. .PHONY:clean
  4. clean:
  5.         rm -rf test
复制代码
编译:

到这里服务器核心模块的工作就已经完成了,接下来,我们需要完成整个服务器功能。

9. 网络通信协议设计

9.1 需求确认这个章节我们考虑客户
端和服务器之间的通信方式。回首 MQ 的交互模型:



其中生产者和消费者都是客户端, 它们都需要通过网络和 Broker Server 举行通信。具体通信的过程我们使用 Muduo 库来实现, 使用 TCP 作为通信的底层协议, 同时在这个基础上自定义应用层协议, 完成客户端对服务器功能的远端调用。 我们要实现的远端调用接口包括:


  • 创建 channel
  • 关闭 channel
  • 创建 exchange
  • 删除 exchange
  • 创建 queue
  • 删除 queue
  • 创建 binding
  • 删除 binding
  • 发送 message
  • 订阅 message
  • 发送 ack
  • 返回 message (服务器 -> 客户端)


9.2 设计应用层协议

使用二进制的方式设计应用层协议。 由于 MQMessage 的消息体是使用 Protobuf 举行序列化的,本身是按照二进制存储的,所以不太得当用 json 等文本格式来定义协议。下面我们设计一下应用层协议:哀求/响应报文设计



  • len: 4 个字节, 表示整个报文的长度
  • nameLen: 4 个字节, 表示 typeName 数组的长度
  • typeName:是个字节数组, 占 nameLen 个字节, 表示哀求/响应报文的范例名,作用是分发差别消息到对应的远端接口调用中
  • protobufData:是个字节数组, 占 len - nameLen - 8 个字节, 表示哀求/响应参数数据通过 protobuf 序列化之后的二进制
  • checkSum: 4 个字节, 表示整个消息的校验和, 作用是为了校验哀求/响应报文的完备性
示例:

颠末协议处理后:

按照 len - nameLen - 8 的长度读取出 protobufData 就可以将读到的二进制数据反序列化成 ExchangeDeclareArguments 对象举行后续处理。后续的哀求报文和这里都是雷同的。
 

9.3 定义哀求/响应参数

由于这里的参数需要举行网络传输以及序列化, 所以我们需要将参数定义在 pb 文件中。
  1. syntax = "proto3";
  2. package bitmq;
  3. import "mq_msg.proto";
  4. //信道的打开
  5. message openChannelRequest
  6. {
  7.     string rid = 1;  //请求id
  8.     string cid = 2;  //信道id
  9. };
  10. //信道的关闭
  11. message closeChannelRequest
  12. {
  13.     string rid = 1;  //请求id
  14.     string cid = 2;  //信道id  
  15. };
  16. //交换机的声明
  17. message declareExchangeRequest
  18. {
  19.     string rid = 1;  //请求id
  20.     string cid = 2;  //信道id  
  21.     string exchange_name = 3;  //交换机名称
  22.     ExchangeType exchange_type = 4;  //交换机类型
  23.     bool durable = 5;  //持久化标志
  24.     bool auto_delete = 6;  //自动删除
  25.     map<string, string> args = 7;  //其他参数
  26. };
  27. //删除交换机
  28. message deleteExchangeRequest
  29. {
  30.     string rid = 1;  //请求id
  31.     string cid = 2;  //信道id  
  32.     string exchange_name = 3;  //交换机名称
  33. };
  34. //队列的声明
  35. message declareQueueRequest
  36. {
  37.     string rid = 1;  //请求id
  38.     string cid = 2;  //信道id  
  39.     string queue_name = 3;  //队列名称
  40.     bool exclusive = 4;  //是否独占
  41.     bool durable = 5;  //持久化标志
  42.     bool auto_delete = 6;  //自动删除
  43.     map<string, string> args = 7;  //其他参数
  44. };
  45. //队列的删除
  46. message deleteQueueRequest
  47. {
  48.     string rid = 1;  //请求id
  49.     string cid = 2;  //信道id  
  50.     string queue_name = 3;  //队列名称   
  51. };
  52. //队列的绑定
  53. message queueBindRequest
  54. {
  55.     string rid = 1;  //请求id
  56.     string cid = 2;  //信道id  
  57.     string exchange_name = 3;  //交换机名称
  58.     string queue_name = 4;     //队列名称
  59.     string binding_key = 5;  
  60. };
  61. //队列的解绑定
  62. message queueUnBindRequest
  63. {
  64.     string rid = 1;  //请求id
  65.     string cid = 2;  //信道id  
  66.     string exchange_name = 3;  //交换机名称
  67.     string queue_name = 4;     //队列名称
  68. };
  69. //消息的发布
  70. message basicPublishRequest
  71. {
  72.     string rid = 1;  //请求id
  73.     string cid = 2;  //信道id  
  74.     string exchange_name = 3; //交换机名称
  75.     string body = 4; //消息的内容
  76.     BasicProperties properties = 5; //消息的属性
  77. };
  78. //消息的确认
  79. message basicAckRequest
  80. {
  81.     string rid = 1;  //请求id
  82.     string cid = 2;  //信道id
  83.     string queue_name = 3;  //队列名称
  84.     string message_id = 4;  //消息id
  85. };
  86. //队列的订阅
  87. message basicConsumeRequest
  88. {
  89.     string rid = 1;  //请求id
  90.     string cid = 2;  //信道id
  91.     string consumer_tag = 3; //消费者标识
  92.     string queue_name = 4;   //队列名称
  93.     bool auto_ack = 5;       //自动应答
  94. };
  95. //取消订阅
  96. message basicCancelRequest
  97. {
  98.     string rid = 1;  //请求id
  99.     string cid = 2;  //信道id
  100.     string consumer_tag = 3;  //消费者标识
  101.     string queue_name = 4;    //队列名称
  102. };
  103. //消息的推送
  104. message basicConsumeResponse
  105. {
  106.     string cid = 1;  //信道id
  107.     string consumer_tag = 2;  //消费者标识
  108.     string body = 3;  //消息的内容
  109.     BasicProperties properties = 4; //消息的属性
  110. };
  111. //通用响应
  112. message basicCancelResponse
  113. {
  114.     string rid = 1;  //请求id
  115.     string cid = 2;  //信道id
  116.     bool is_ok = 3;      //请求是否成功
  117. };
复制代码


10. 服务器模块实现

服务器模块我们借助 Muduo 网络库来实现



  • _server: Muduo 库提供的一个通用 TCP 服务器, 我们可以封装这个服务器举行TCP 通信
  • _baseloop:主事件循环器, 用于响应 IO 事件和定时器事件,主 loop 主要是为了响应监听描述符的 IO 事件
  • _codec: 一个 protobuf 编解码器, 我们在 TCP 服务器上设计了一层应用层协议,这个编解码器主要就是负责实现应用层协议的解析和封装, 下边具体讲解
  • _dispatcher:一个消息分发器, 当 Socket 接收到一个报文消息后, 我们需要按照消息的范例, 即上面提到的 typeName 举行消息分发, 会不差别范例的消息分发相对应的的处理函数中,下边具体讲解
  • _consumer: 服务器中的消费者信息管理句柄。
  • _threadpool: 异步工作线程池,主要用于队列消息的推送工作。
  • _connections: 毗连受理句柄,管理当前服务器上的全部已经建立的通信毗连。
  • _virtual_host:服务器持有的虚拟主机。 队列、交换机 、绑定、消息等数据都是通过虚拟主机管理
   怎样编写MQBroker服务器
  在前面我们编写过一个基于muduo库的protobuf通佩服务器,代码如下:
  1. class ProtoServer
  2. {
  3.     typedef shared_ptr<request::TranslateRequest> TranslateRequestPtr;
  4.     typedef shared_ptr<request::TranslateResponse> TranslateResponsePtr;
  5.     typedef shared_ptr<request::CalculatorRequest> CalculatorRequestPtr;
  6.     typedef shared_ptr<request::CalculatorResponse> CalculatorResponsePtr;
  7. public:
  8.     ProtoServer(int port)
  9.             : _server(&_baseloop, muduo::net::InetAddress(port), "ProtoServer", muduo::net::TcpServer::kReusePort)
  10.             , _dispatcher(bind(&ProtoServer::onUnknownMessage, this,
  11.             placeholders::_1, placeholders::_2, placeholders::_3))
  12.             , _codec(bind(&ProtobufDispatcher::onProtobufMessage, &_dispatcher,
  13.             placeholders::_1, placeholders::_2, placeholders::_3))
  14.     {
  15.         //注册业务处理函数
  16.         _dispatcher.registerMessageCallback<request::TranslateRequest>(std::bind(&ProtoServer::onTranslate, this,
  17.             placeholders::_1, placeholders::_2, placeholders::_3));
  18.         _dispatcher.registerMessageCallback<request::CalculatorRequest>(std::bind(&ProtoServer::onCalculator, this,
  19.             placeholders::_1, placeholders::_2, placeholders::_3));
  20.         //设置回调函数
  21.         _server.setConnectionCallback(bind(&ProtoServer::onConnection, this, placeholders::_1));
  22.         _server.setMessageCallback(bind(&ProtobufCodec::onMessage, &_codec, placeholders::_1, placeholders::_2, placeholders::_3));
  23.     }
  24.     void start()
  25.     {
  26.         _server.start();
  27.         _baseloop.loop();
  28.     }
  29.    
  30. private:
  31.     string translate(const string& word)
  32.     {
  33.         static unordered_map<string, string> dict = {
  34.             {"sun", "太阳"},
  35.             {"left", "左"},
  36.             {"right", "右"},
  37.             {"hello", "你好"}
  38.         };
  39.         
  40.         auto it = dict.find(word);
  41.         if (it != dict.end())
  42.             return it->second;
  43.         else  
  44.             return "未找到";
  45.     }
  46.     void onTranslate(const muduo::net::TcpConnectionPtr& conn, const TranslateRequestPtr& req, muduo::Timestamp rt)
  47.     {
  48.         //读取请求字符串
  49.         string word = req->word();
  50.         //将请求字符串进行翻译
  51.         string tranStr = translate(word);
  52.         //构建TranslateResponse响应
  53.         request::TranslateResponse resp;
  54.         resp.set_result(tranStr);
  55.         //发送响应
  56.         _codec.send(conn, resp);
  57.     }
  58.     void onCalculator(const muduo::net::TcpConnectionPtr& conn, const CalculatorRequestPtr& req, muduo::Timestamp rt)
  59.     {
  60.         int num1 = req->num1();
  61.         int num2 = req->num2();
  62.         char op = req->op()[0];
  63.         request::CalculatorResponse resp;
  64.         switch(op)
  65.         {
  66.             case '+':
  67.                 resp.set_result(num1 + num2);
  68.                 resp.set_code(true);
  69.                 break;
  70.             case '-':
  71.                 resp.set_result(num1 - num2);
  72.                 resp.set_code(true);
  73.                 break;
  74.             case '*':
  75.                 resp.set_result(num1 * num2);
  76.                 resp.set_code(true);
  77.                 break;
  78.             case '/':
  79.                 if (num2 == 0)
  80.                 {
  81.                     resp.set_code(false);
  82.                 }
  83.                 else
  84.                 {
  85.                     resp.set_result(num1 / num2);
  86.                     resp.set_code(true);
  87.                 }
  88.                 break;                                
  89.         }
  90.         _codec.send(conn, resp);
  91.     }
  92.     void onConnection(const muduo::net::TcpConnectionPtr& conn)
  93.     {
  94.         if (conn->connected())
  95.         {
  96.             cout << "连接成功!!!" << endl;
  97.         }
  98.         else
  99.         {
  100.             cout << "断开连接" << endl;
  101.         }
  102.     }
  103.     void onUnknownMessage(const muduo::net::TcpConnectionPtr& conn, const MessagePtr& message, muduo::Timestamp)
  104.     {
  105.         std::cout << "onUnknownMessage: " << message->GetTypeName() << std::endl;
  106.     }
  107.    
  108. private:
  109.     muduo::net::EventLoop _baseloop;
  110.     muduo::net::TcpServer _server;
  111.     ProtobufDispatcher _dispatcher;
  112.     ProtobufCodec _codec;
  113. };
复制代码
这个例子很好的展示了一个通佩服务器的编写。


  • _baseloop负责事件监控,判断有无事件就绪
  • _server对象就是一个Tcp服务器
  • _dispatcher是事件分发器,我们需要在构造函数处注册好哀求以及对应的回调函数,当服务器收到一条哀求后,事件分发器就会根据差别的哀求调用差别的回调函数。

先搭建一下团体框架:
  1. #define DBFILE "/meta.db"
  2. class MQBrokerServer
  3. {
  4. public:
  5.     typedef std::shared_ptr<google::protobuf::Message> MessagePtr;
  6.     MQBrokerServer(int port, const std::string& basedir)
  7.         : _server(&_baseloop, muduo::net::InetAddress("0.0.0.0", port), "MQBrokerServer", muduo::net::TcpServer::kReusePort)
  8.         , _dispatcher(std::bind(&MQBrokerServer::onUnknownMessage, this,
  9.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3))
  10.         , _codec(std::make_shared<ProtobufCodec>(std::bind(&ProtobufDispatcher::onProtobufMessage, &_dispatcher,
  11.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3)))
  12.         , _virtual_host(std::make_shared<VirtualHost>(basedir, basedir + DBFILE))
  13.         , _consumer_manager(std::make_shared<ConsumerManager>())
  14.         , _connection_manager(std::make_shared<ConnectionManager>())
  15.         , _threadpool(std::make_shared<threadpool>())
  16.     {
  17.         //针对历史消息中的所有队列,初始化队列的消费者管理结构
  18.         auto qm = _virtual_host->allQueues();
  19.         for (auto& q : qm)
  20.         {
  21.             _consumer_manager->initQueueConsumer(q.first);
  22.         }
  23.         //注册业务处理函数
  24.         _dispatcher.registerMessageCallback<openChannelRequest>(std::bind(&MQBrokerServer::onOpenChannel, this,
  25.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  26.         _dispatcher.registerMessageCallback<closeChannelRequest>(std::bind(&MQBrokerServer::onCloseChannel, this,
  27.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  28.         _dispatcher.registerMessageCallback<declareExchangeRequest>(std::bind(&MQBrokerServer::onDeclareExchange, this,
  29.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  30.         _dispatcher.registerMessageCallback<deleteExchangeRequest>(std::bind(&MQBrokerServer::onDeleteExchange, this,
  31.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  32.         _dispatcher.registerMessageCallback<declareQueueRequest>(std::bind(&MQBrokerServer::onDeclareQueue, this,
  33.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  34.         _dispatcher.registerMessageCallback<deleteQueueRequest>(std::bind(&MQBrokerServer::onDeleteQueue, this,
  35.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  36.         _dispatcher.registerMessageCallback<queueBindRequest>(std::bind(&MQBrokerServer::onQueueBind, this,
  37.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  38.         _dispatcher.registerMessageCallback<queueUnBindRequest>(std::bind(&MQBrokerServer::onQueueUnBind, this,
  39.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  40.         _dispatcher.registerMessageCallback<basicPublishRequest>(std::bind(&MQBrokerServer::onBasicPublish, this,
  41.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  42.         _dispatcher.registerMessageCallback<basicAckRequest>(std::bind(&MQBrokerServer::onBasicAck, this,
  43.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));  
  44.         _dispatcher.registerMessageCallback<basicConsumeRequest>(std::bind(&MQBrokerServer::onBasicConsume, this,
  45.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));  
  46.         _dispatcher.registerMessageCallback<basicCancelRequest>(std::bind(&MQBrokerServer::onBasicCancel, this,
  47.             std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));            
  48.         //设置回调函数
  49.         _server.setConnectionCallback(std::bind(&MQBrokerServer::onConnection, this, std::placeholders::_1));
  50.         _server.setMessageCallback(std::bind(&ProtobufCodec::onMessage, _codec.get(), std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  51.     }
  52.     void start()
  53.     {
  54.         _server.start();
  55.         _baseloop.loop();
  56.     }
  57. private:
  58.     //打开信道
  59.     void onOpenChannel(const muduo::net::TcpConnectionPtr& conn, const openChannelRequestPtr& req, muduo::Timestamp);
  60.     //关闭信道
  61.     void onCloseChannel(const muduo::net::TcpConnectionPtr& conn, const closeChannelRequestPtr& req, muduo::Timestamp);
  62.     //声明交换机
  63.     void onDeclareExchange(const muduo::net::TcpConnectionPtr& conn, const declareExchangeRequestPtr& req, muduo::Timestamp);
  64.     //删除交换机
  65.     void onDeleteExchange(const muduo::net::TcpConnectionPtr& conn, const deleteExchangeRequestPtr& req, muduo::Timestamp);
  66.     //声明队列
  67.     void onDeclareQueue(const muduo::net::TcpConnectionPtr& conn, const declareQueueRequestPtr& req, muduo::Timestamp);
  68.     //删除队列
  69.     void onDeleteQueue(const muduo::net::TcpConnectionPtr& conn, const deleteQueueRequestPtr& req, muduo::Timestamp);
  70.     //队列绑定
  71.     void onQueueBind(const muduo::net::TcpConnectionPtr& conn, const queueBindRequestPtr& req, muduo::Timestamp);
  72.     //队列解绑
  73.     void onQueueUnBind(const muduo::net::TcpConnectionPtr& conn, const queueUnBindRequestPtr& req, muduo::Timestamp);
  74.     //消息发布
  75.     void onBasicPublish(const muduo::net::TcpConnectionPtr& conn, const basicPublishRequestPtr& req, muduo::Timestamp);
  76.     //消息确认
  77.     void onBasicAck(const muduo::net::TcpConnectionPtr& conn, const basicAckRequestPtr& req, muduo::Timestamp);
  78.     //队列消息订阅
  79.     void onBasicConsume(const muduo::net::TcpConnectionPtr& conn, const basicConsumeRequestPtr& req, muduo::Timestamp);
  80.     //队列消息取消订阅
  81.     void onBasicCancel(const muduo::net::TcpConnectionPtr& conn, const basicCancelRequestPtr& req, muduo::Timestamp);
  82.     void onConnection(const muduo::net::TcpConnectionPtr& conn)
  83.     {
  84.         if (conn->connected())
  85.         {
  86.             DLOG("连接建立成功");
  87.             _connection_manager->newConnection(_virtual_host, _consumer_manager,
  88.                 _codec, conn, _threadpool);
  89.         }
  90.         else
  91.         {
  92.             DLOG("连接断开");
  93.             _connection_manager->delConnection(conn);
  94.         }
  95.     }
  96.     void onUnknownMessage(const muduo::net::TcpConnectionPtr& conn, const MessagePtr& message, muduo::Timestamp)
  97.     {
  98.         std::cout << "onUnknownMessage: " << message->GetTypeName() << std::endl;
  99.     }
  100.    
  101. private:
  102.     muduo::net::EventLoop _baseloop;
  103.     muduo::net::TcpServer _server;
  104.     ProtobufDispatcher _dispatcher;
  105.     ProtobufCodecPtr _codec;
  106.     VirtualHost::ptr _virtual_host;
  107.     ConsumerManager::ptr _consumer_manager;
  108.     ConnectionManager::ptr _connection_manager;
  109.     threadpool::ptr _threadpool;
  110. };
复制代码
上面的代码看似复杂,其实就是将用户所需的服务举行了封装,先使用shared_ptr修饰每种哀求范例,再根据对应的哀求范例注册业务处理回调函数。
接下来完成服务器的团体代码:
  1. #pragma once
  2. #include <iostream>
  3. #include <functional>
  4. #include <memory>
  5. #include "muduo/proto/codec.h"
  6. #include "muduo/proto/dispatcher.h"
  7. #include "muduo/net/EventLoop.h"
  8. #include "muduo/net/TcpServer.h"
  9. #include "mq_connection.hpp"
  10. #include "mq_consumer.hpp"
  11. #include "mq_virtualhost.hpp"
  12. #include "../mqcommon/mq_threadpool.hpp"
  13. #include "../mqcommon/mq_msg.pb.h"
  14. #include "../mqcommon/mq_proto.pb.h"
  15. #include "../mqcommon/mq_logger.hpp"
  16. namespace bitmq
  17. {
  18.     #define DBFILE "/meta.db"
  19.     class MQBrokerServer
  20.     {
  21.     public:
  22.         typedef std::shared_ptr<google::protobuf::Message> MessagePtr;
  23.         MQBrokerServer(int port, const std::string &basedir)
  24.             : _server(&_baseloop, muduo::net::InetAddress("0.0.0.0", port),
  25.                 "Server", muduo::net::TcpServer::kReusePort)
  26.             , _dispatcher(std::bind(&MQBrokerServer::onUnknownMessage, this, std::placeholders::_1,
  27.                 std::placeholders::_2, std::placeholders::_3))
  28.             , _codec(std::make_shared<ProtobufCodec>(std::bind(&ProtobufDispatcher::onProtobufMessage, &_dispatcher,
  29.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3)))
  30.             , _virtual_host(std::make_shared<VirtualHost>("", basedir, basedir + DBFILE))
  31.             , _consumer_manager(std::make_shared<ConsumerManager>())
  32.             , _connection_manager(std::make_shared<ConnectionManager>())
  33.             , _threadpool(std::make_shared<threadpool>())
  34.         {
  35.             //针对历史消息中的所有队列,初始化队列的消费者管理结构
  36.             auto qm = _virtual_host->allQueues();
  37.             for (auto& q : qm)
  38.             {
  39.                 _consumer_manager->initQueueConsumer(q.first);
  40.             }
  41.             //注册业务处理函数
  42.             _dispatcher.registerMessageCallback<openChannelRequest>(std::bind(&MQBrokerServer::onOpenChannel, this,
  43.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  44.             _dispatcher.registerMessageCallback<closeChannelRequest>(std::bind(&MQBrokerServer::onCloseChannel, this,
  45.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  46.             _dispatcher.registerMessageCallback<declareExchangeRequest>(std::bind(&MQBrokerServer::onDeclareExchange, this,
  47.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  48.             _dispatcher.registerMessageCallback<deleteExchangeRequest>(std::bind(&MQBrokerServer::onDeleteExchange, this,
  49.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  50.             _dispatcher.registerMessageCallback<declareQueueRequest>(std::bind(&MQBrokerServer::onDeclareQueue, this,
  51.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  52.             _dispatcher.registerMessageCallback<deleteQueueRequest>(std::bind(&MQBrokerServer::onDeleteQueue, this,
  53.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  54.             _dispatcher.registerMessageCallback<queueBindRequest>(std::bind(&MQBrokerServer::onQueueBind, this,
  55.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  56.             _dispatcher.registerMessageCallback<queueUnBindRequest>(std::bind(&MQBrokerServer::onQueueUnBind, this,
  57.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  58.             _dispatcher.registerMessageCallback<basicPublishRequest>(std::bind(&MQBrokerServer::onBasicPublish, this,
  59.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  60.             _dispatcher.registerMessageCallback<basicAckRequest>(std::bind(&MQBrokerServer::onBasicAck, this,
  61.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));  
  62.             _dispatcher.registerMessageCallback<basicConsumeRequest>(std::bind(&MQBrokerServer::onBasicConsumer, this,
  63.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));  
  64.             _dispatcher.registerMessageCallback<basicCancelRequest>(std::bind(&MQBrokerServer::onBasicCancel, this,
  65.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));            
  66.             //设置回调函数
  67.             _server.setConnectionCallback(std::bind(&MQBrokerServer::onConnection, this, std::placeholders::_1));
  68.             _server.setMessageCallback(std::bind(&ProtobufCodec::onMessage, _codec.get(), std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  69.         }
  70.         void start()
  71.         {
  72.             _server.start();
  73.             _baseloop.loop();
  74.         }
  75.    
  76.     private:
  77.         //打开信道
  78.         void onOpenChannel(const muduo::net::TcpConnectionPtr& conn, const openChannelRequestPtr& req, muduo::Timestamp)
  79.         {
  80.             //先获取Connection对象
  81.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  82.             if (mconn.get() == nullptr)
  83.             {
  84.                 DLOG("打开信道失败,没有找到对应的Connection对象");
  85.                 conn->shutdown();
  86.                 return;
  87.             }
  88.             return mconn->openChannel(req);
  89.         }
  90.         //关闭信道
  91.         void onCloseChannel(const muduo::net::TcpConnectionPtr& conn, const closeChannelRequestPtr& req, muduo::Timestamp)
  92.         {
  93.             //先获取Connection对象
  94.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  95.             if (mconn.get() == nullptr)
  96.             {
  97.                 DLOG("关闭信道失败,没有找到对应的Connection对象");
  98.                 conn->shutdown();
  99.                 return;
  100.             }
  101.             return mconn->closeChannel(req);
  102.         }
  103.         //声明交换机
  104.         void onDeclareExchange(const muduo::net::TcpConnectionPtr& conn, const declareExchangeRequestPtr& req, muduo::Timestamp)
  105.         {
  106.             //先获取Connection对象
  107.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  108.             if (mconn.get() == nullptr)
  109.             {
  110.                 DLOG("声明交换机失败,没有找到对应的Connection对象");
  111.                 conn->shutdown();
  112.                 return;
  113.             }
  114.             //获取信道
  115.             Channel::ptr cp = mconn->getChannel(req->cid());
  116.             if (mconn.get() == nullptr)
  117.             {
  118.                 DLOG("声明交换机时,没有找到对应的信道");
  119.                 conn->shutdown();
  120.                 return;
  121.             }
  122.             return cp->declareExchange(req);
  123.         }
  124.         //删除交换机
  125.         void onDeleteExchange(const muduo::net::TcpConnectionPtr& conn, const deleteExchangeRequestPtr& req, muduo::Timestamp)
  126.         {
  127.             //先获取Connection对象
  128.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  129.             if (mconn.get() == nullptr)
  130.             {
  131.                 DLOG("删除交换机失败,没有找到对应的Connection对象");
  132.                 conn->shutdown();
  133.                 return;
  134.             }
  135.             //获取信道
  136.             Channel::ptr cp = mconn->getChannel(req->cid());
  137.             if (mconn.get() == nullptr)
  138.             {
  139.                 DLOG("删除交换机时,没有找到对应的信道");
  140.                 conn->shutdown();
  141.                 return;
  142.             }
  143.             return cp->deleteExchange(req);
  144.         }
  145.         //声明队列
  146.         void onDeclareQueue(const muduo::net::TcpConnectionPtr& conn, const declareQueueRequestPtr& req, muduo::Timestamp)
  147.         {
  148.             //先获取Connection对象
  149.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  150.             if (mconn.get() == nullptr)
  151.             {
  152.                 DLOG("声明队列失败,没有找到对应的Connection对象");
  153.                 conn->shutdown();
  154.                 return;
  155.             }
  156.             //获取信道
  157.             Channel::ptr cp = mconn->getChannel(req->cid());
  158.             if (mconn.get() == nullptr)
  159.             {
  160.                 DLOG("声明队列时,没有找到对应的信道");
  161.                 conn->shutdown();
  162.                 return;
  163.             }
  164.             return cp->declareQueue(req);
  165.         }
  166.         //删除队列
  167.         void onDeleteQueue(const muduo::net::TcpConnectionPtr& conn, const deleteQueueRequestPtr& req, muduo::Timestamp)
  168.         {
  169.             //先获取Connection对象
  170.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  171.             if (mconn.get() == nullptr)
  172.             {
  173.                 DLOG("删除队列失败,没有找到对应的Connection对象");
  174.                 conn->shutdown();
  175.                 return;
  176.             }
  177.             //获取信道
  178.             Channel::ptr cp = mconn->getChannel(req->cid());
  179.             if (mconn.get() == nullptr)
  180.             {
  181.                 DLOG("删除队列时,没有找到对应的信道");
  182.                 conn->shutdown();
  183.                 return;
  184.             }
  185.             return cp->deleteQueue(req);
  186.         }
  187.         //队列绑定
  188.         void onQueueBind(const muduo::net::TcpConnectionPtr& conn, const queueBindRequestPtr& req, muduo::Timestamp)
  189.         {
  190.             //先获取Connection对象
  191.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  192.             if (mconn.get() == nullptr)
  193.             {
  194.                 DLOG("绑定队列失败,没有找到对应的Connection对象");
  195.                 conn->shutdown();
  196.                 return;
  197.             }
  198.             //获取信道
  199.             Channel::ptr cp = mconn->getChannel(req->cid());
  200.             if (mconn.get() == nullptr)
  201.             {
  202.                 DLOG("绑定队列时,没有找到对应的信道");
  203.                 conn->shutdown();
  204.                 return;
  205.             }
  206.             return cp->queueBind(req);
  207.         }
  208.         //队列解绑
  209.         void onQueueUnBind(const muduo::net::TcpConnectionPtr& conn, const queueUnBindRequestPtr& req, muduo::Timestamp)
  210.         {
  211.             //先获取Connection对象
  212.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  213.             if (mconn.get() == nullptr)
  214.             {
  215.                 DLOG("队列解绑失败,没有找到对应的Connection对象");
  216.                 conn->shutdown();
  217.                 return;
  218.             }
  219.             //获取信道
  220.             Channel::ptr cp = mconn->getChannel(req->cid());
  221.             if (mconn.get() == nullptr)
  222.             {
  223.                 DLOG("队列解绑时,没有找到对应的信道");
  224.                 conn->shutdown();
  225.                 return;
  226.             }
  227.             return cp->queueUnBind(req);
  228.         }
  229.         //消息发布
  230.         void onBasicPublish(const muduo::net::TcpConnectionPtr& conn, const basicPublishRequestPtr& req, muduo::Timestamp)
  231.         {
  232.             //先获取Connection对象
  233.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  234.             if (mconn.get() == nullptr)
  235.             {
  236.                 DLOG("消息发布失败,没有找到对应的Connection对象");
  237.                 conn->shutdown();
  238.                 return;
  239.             }
  240.             //获取信道
  241.             Channel::ptr cp = mconn->getChannel(req->cid());
  242.             if (mconn.get() == nullptr)
  243.             {
  244.                 DLOG("消息发布时,没有找到对应的信道");
  245.                 conn->shutdown();
  246.                 return;
  247.             }
  248.             return cp->basicPublish(req);
  249.         }
  250.         //消息确认
  251.         void onBasicAck(const muduo::net::TcpConnectionPtr& conn, const basicAckRequestPtr& req, muduo::Timestamp)
  252.         {
  253.             //先获取Connection对象
  254.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  255.             if (mconn.get() == nullptr)
  256.             {
  257.                 DLOG("消息确认失败,没有找到对应的Connection对象");
  258.                 conn->shutdown();
  259.                 return;
  260.             }
  261.             //获取信道
  262.             Channel::ptr cp = mconn->getChannel(req->cid());
  263.             if (mconn.get() == nullptr)
  264.             {
  265.                 DLOG("消息确认时,没有找到对应的信道");
  266.                 conn->shutdown();
  267.                 return;
  268.             }
  269.             return cp->basicAck(req);
  270.         }
  271.         //队列消息订阅
  272.         void onBasicConsumer(const muduo::net::TcpConnectionPtr& conn, const basicConsumeRequestPtr& req, muduo::Timestamp)
  273.         {
  274.             //先获取Connection对象
  275.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  276.             if (mconn.get() == nullptr)
  277.             {
  278.                 DLOG("队列订阅消息失败,没有找到对应的Connection对象");
  279.                 conn->shutdown();
  280.                 return;
  281.             }
  282.             //获取信道
  283.             Channel::ptr cp = mconn->getChannel(req->cid());
  284.             if (mconn.get() == nullptr)
  285.             {
  286.                 DLOG("队列订阅消息时,没有找到对应的信道");
  287.                 conn->shutdown();
  288.                 return;
  289.             }
  290.             return cp->basicConsumer(req);
  291.         }
  292.         //队列消息取消订阅
  293.         void onBasicCancel(const muduo::net::TcpConnectionPtr& conn, const basicCancelRequestPtr& req, muduo::Timestamp)
  294.         {
  295.             //先获取Connection对象
  296.             Connection::ptr mconn = _connection_manager->getConnection(conn);
  297.             if (mconn.get() == nullptr)
  298.             {
  299.                 DLOG("队列消息取消订阅失败,没有找到对应的Connection对象");
  300.                 conn->shutdown();
  301.                 return;
  302.             }
  303.             //获取信道
  304.             Channel::ptr cp = mconn->getChannel(req->cid());
  305.             if (mconn.get() == nullptr)
  306.             {
  307.                 DLOG("队列消息取消订阅时,没有找到对应的信道");
  308.                 conn->shutdown();
  309.                 return;
  310.             }
  311.             return cp->basicCancel(req);
  312.         }
  313.         void onUnknownMessage(const muduo::net::TcpConnectionPtr&, const MessagePtr& message, muduo::Timestamp)
  314.         {
  315.             std::cout << "onUnknownMessage: " << message->GetTypeName() << std::endl;
  316.         }
  317.         void onConnection(const muduo::net::TcpConnectionPtr& conn)
  318.         {
  319.             if (conn->connected())
  320.             {
  321.                 DLOG("连接建立成功");
  322.                 _connection_manager->newConnection(_virtual_host, _consumer_manager,
  323.                     _codec, conn, _threadpool);
  324.             }
  325.             else
  326.             {
  327.                 DLOG("连接断开");
  328.                 _connection_manager->delConnection(conn);
  329.             }
  330.         }
  331.         
  332.     private:
  333.         muduo::net::EventLoop _baseloop;
  334.         muduo::net::TcpServer _server;//服务器对象
  335.         ProtobufDispatcher _dispatcher;//请求分发器对象--要向其中注册请求处理函数
  336.         ProtobufCodecPtr _codec;//protobuf协议处理器--针对收到的请求数据进行protobuf协议处理
  337.         VirtualHost::ptr _virtual_host;
  338.         ConsumerManager::ptr _consumer_manager;
  339.         ConnectionManager::ptr _connection_manager;
  340.         threadpool::ptr _threadpool;
  341.     };
  342. }
复制代码
基本上全部函数的逻辑都是一样的,先获取毗连,再获取信道,最后根据差别哀求实行差别的使命

服务器的测试工作也暂时无法完成,需要比及客户端完成之后再举行同一的测试,所以我们先测试一下能否成功编译即可。
我们编写如下makefile:
  1. .PHONY:myserver
  2. CFLAG=-I../third/include
  3. LFLAG=-L../third/lib -lgtest -lprotobuf -lsqlite3 -lmuduo_net -lmuduo_base -lz -lpthread
  4. test:mq_server.cpp ../mqcommon/mq_msg.pb.cc ../mqcommon/mq_proto.pb.cc ../third/include/muduo/proto/codec.cc
  5.         g++ -o $@ $^ -std=c++11 $(CFLAG) $(LFLAG) -w
  6. .PHONY:clean
  7. clean:
  8.         rm -rf test
复制代码
编译:

可以编译成功,并且启动服务器也没有问题。
服务器模块到这里就已经实现完毕了,接下来我们进入客户端模块的实现。

11. 客户端模块实现

在 RabbitMQ 中,提供服务的是信道,因此在客户端的实现中,弱化了 Client 客户端的概念,也就是说在 RabbitMQ 中并不会向用户展示网络通信的概念出来,而是以一种提供服务的情势来体现。
其实现头脑雷同于平凡的功能接口封装,一个接口实现一个功能,接口内部完成向客户端哀求的过程,但是对外并不需要体现出客户端与服务端通信的概念,用户需要什么服务就调用什么接口就行。
基于以上的头脑,客户端的实现共分为四大模块:

订阅者模块:


  • 一个并不直接对用户展示的模块,其在客户端体现的作用就是对于脚色的描述,表示这是一个消费者。
信道模块:


  • 一个直接面向用户的模块,内部包含多个向外提供的服务接口,用户需要什么服务,调用对应接口即可。
  • 其包含交换机声明/删除,队列声明/删除,绑定/解绑,消息发布/确认,订阅/清除订阅等服务。
毗连模块:


  • 这是唯一能体现出网络通信概念的一个模块了,它向用户提供的功能就是用于打开/关闭信道。
异步线程模块:


  • 固然客户端部分,并不对外体现网络通信的概念,但是本质上内部还是包含有网络通信的,因此既然有网络通信,那么就必须包含有一个网络通信 IO 事件监控线程模块,用于举行客户端毗连的 IO 事件监控,以便于在事件出发后举行 IO操作。
  • 其次,在客户端部分存在一个情况就是,当一个信道作为消费者而存在的时候,服务端会向信道推送消息,而用户这边需要对收到的消息举行差别的业务处理,而这个消息的处理需要一个异步的工作线程池来完成。
  • 因此异步线程模块包含两个部分:

    • 客户端毗连的 IO 事件监控线程
    • 推送过来的消息异步处理线程


   基于以上模块,实现一个客户端的流程也就比力简单了
  

  • 1. 实例化异步线程对象
  • 2. 实例化毗连对象
  • 3. 通过毗连对象,创建信道
  • 4. 根据信道获取本身所需服务
  • 5. 关闭信道
  • 6. 关闭毗连
  
11.1 订阅者模块

与服务端,并无太大差异,客户端这边固然订阅者的存在感微弱了很多,但是还是有的,当举行队列消息订阅的时候,会伴随着一个订阅者对象的创建,(一个信道只有一个订阅者,一个信道只能订阅一个队列)而这个订阅者对象有以下几个作用:


  • 描述当前信道订阅了哪个队列的消息。
  • 描述了收到消息后该怎样对这条消息举行处理。
  • 描述收到消息后是否需要举行确认回复。
订阅者信息:


  • 1)订阅者标识
  • 2)订阅队列名
  • 3)是否主动确认标志
  • 4)回调处理函数(收到消息后该怎样处理的回调函数对象)
而客户端订阅者所需代码和服务端基本上一样,所以我们直接将服务器的mq_consumer..hpp文件拿过来用即可。
  1. using ConsumerCallBack = std::function<void(const std::string&,  const BasicProperties* , const std::string&)>;
  2. //1. 定义消费者信息结构
  3. struct Consumer
  4. {
  5. public:
  6.     using ptr = std::shared_ptr<Consumer>;
  7.     Consumer(){}
  8.     Consumer(const std::string &ctag, const std::string& queue_name, bool ack_flag, const ConsumerCallBack& cb)
  9.         : tag(ctag)
  10.         , qname(queue_name)
  11.         , callback(cb)
  12.         , auto_ack(ack_flag)
  13.     {
  14.         DLOG("new Consumer: %s", ctag.c_str());
  15.     }
  16.     ~Consumer()
  17.     {
  18.         DLOG("delete Consumer: %s", tag.c_str());
  19.     }
  20. public:
  21.     std::string tag;   // 1)消费者标识
  22.     std::string qname;  // 2)订阅的队列名称
  23.     ConsumerCallBack callback; // 3)一个消息的处理回调函数
  24.     bool auto_ack;    // 4)是否自动应答标志
  25. };
复制代码

11.2 信道管理模块

同样的,客户端也有信道,其功能与服务端险些同等,大概说不管是客户端的channel 还是服务端的 channel 都是为了用户提供具体服务而存在的,只不外服务端是为客户端的对应哀求提供服务,而客户端的接口服务是为了用户具体需要服务,也可以理解是用户通过客户端 channel 的接口调用来向服务端发送对应哀求,获取哀求的服务。
1. 信道信息:


  • 1)信道 ID
  • 2)信道关联的网络通信毗连对象
  • 3)protobuf 协议处理对象
  • 4)信道关联的消费者
  • 5)哀求对应的响应信息队列(这里队列使用<哀求 ID,响应>hash 表,以便于查找指定的响应)
  • 6)互斥锁&条件变量(大部分的哀求都是阻塞操作,发送哀求后需要比及响应才能继承,但是 muduo 库的通信是异步的,因此需要我们本身在收到响应后,通过判断是否是等待的指定响应来举行同步)

2. 信道操作:


  • 1)提供创建信道操作
  • 2)提供删除信道操作
  • 3)提供声明交换机操作(强断言-有则 OK,没有则创建)
  • 4)提供删除交换机
  • 5)提供创建队列操作(强断言-有则 OK,没有则创建)
  • 6)提供删除队列操作
  • 7)提供交换机-队列绑定操作
  • 8)提供交换机-队列清除绑定操作
  • 9)提供添加订阅操作
  • 10)提供取消订阅操作
  • 11)提供发布消息操作
  • 12)提供确认消息操作

3. 信道管理:


  • 1)创建信道
  • 2)查询信道
  • 3)删除信道

   声明客户端信道类
  1. using ProtobufCodecPtr = std::shared_ptr<ProtobufCodec>;   
  2. //客户端只能收到两种响应类型
  3. using basicConsumeResponsePtr = std::shared_ptr<basicConsumeResponse>;
  4. using basicCommonResponsePtr = std::shared_ptr<basicCommonResponse>;
  5. class Channel
  6. {
  7. public:
  8.     Channel(const std::string& cid, const muduo::net::TcpConnectionPtr& conn,
  9.         const ProtobufCodecPtr& codec);
  10.    
  11.     bool declareExchange(const std::string& name, ExchangeType type,
  12.         bool durable, bool auto_delete, const google::protobuf::Map<std::string, std::string>& args);
  13.     void deleteExchange(const std::string& qname);
  14.     bool declareQueue(const std::string& name, bool durable, bool exclusive,
  15.         bool auto_delete, google::protobuf::Map<std::string, std::string> args);
  16.     void deleteQueue(const std::string& qname);
  17.     bool queueBind(const std::string& ename, const std::string& qname, const std::string& key);
  18.     void queueUnBind(const std::string& ename, const std::string& qname);
  19.     void basicPublish(const std::string& ename, const BasicProperties* bp, const std::string& body);
  20.     void basicAck(const std::string& msgid);
  21.     void basicConsume(const std::string& consumer_tag, const std::string& qname,
  22.         bool auto_ack, const ConsumerCallBack& cb);
  23.     void basicCancel(const std::string& consumer_tag);
  24. public:
  25.     //连接收到基础响应,向响应消息队列中添加数据
  26.     void putBasicResponse(const basicCommonResponsePtr& resp);
  27.     //连接收到消息推送后,需要通过信道找到对应的消费者对象,通过回调函数进行消息处理
  28.     void consume(const basicConsumeResponsePtr& resp);
  29.     //等待服务器响应
  30.     basicCommonResponsePtr waitResponse(const std::string& rid);
  31. private:
  32.     std::string _cid;         // 1)信道 ID
  33.     muduo::net::TcpConnectionPtr _conn;  // 2)信道关联的网络通信连接对象
  34.     ProtobufCodec _codec;     // 3)protobuf 协议处理对象
  35.     Consumer::ptr _consumer;  // 4)信道关联的消费者
  36.     std::unordered_map<std::string, basicCommonResponsePtr> _basic_resp;  // 5)请求对应的响应信息队列
  37.     std::mutex _mutex;             //6)互斥锁
  38.     std::condition_variable _cv;   //7)条件变量
  39. };
复制代码
  定义客户端信道类
  1. using ProtobufCodecPtr = std::shared_ptr<ProtobufCodec>;   
  2. //客户端只能收到两种响应类型
  3. using basicConsumeResponsePtr = std::shared_ptr<basicConsumeResponse>;
  4. using basicCommonResponsePtr = std::shared_ptr<basicCommonResponse>;
  5. class Channel
  6. {
  7. public:
  8.     using ptr = std::shared_ptr<Channel>;
  9.     Channel(const std::string& cid, const muduo::net::TcpConnectionPtr& conn,
  10.         const ProtobufCodecPtr& codec)
  11.         : _cid(cid)
  12.         , _conn(conn)
  13.         , _codec(codec)
  14.     {}
  15.     ~Channel()
  16.     {
  17.         //信道关闭时,要取消订阅
  18.         basicCancel();
  19.     }
  20.    
  21.     bool declareExchange(const std::string& ename, ExchangeType type,
  22.         bool durable, bool auto_delete, google::protobuf::Map<std::string, std::string>& args)
  23.     {
  24.         std::string rid = UUIDHelper::uuid();
  25.         //构造一个声明虚拟机的请求对象
  26.         declareExchangeRequest req;
  27.         req.set_rid(rid);
  28.         req.set_cid(_cid);
  29.         req.set_exchange_name(ename);
  30.         req.set_exchange_type(type);
  31.         req.set_durable(durable);
  32.         req.set_auto_delete(auto_delete);
  33.         req.mutable_args()->swap(args);
  34.         //向服务器发送请求
  35.         _codec->send(_conn, req);
  36.         //等待服务器的响应
  37.         basicCommonResponsePtr resp = waitResponse(rid);
  38.         return resp->is_ok();
  39.     }
  40.     void deleteExchange(const std::string& ename)
  41.     {
  42.         std::string rid = UUIDHelper::uuid();
  43.         //构造一个删除虚拟机的请求对象
  44.         deleteExchangeRequest req;
  45.         req.set_rid(rid);
  46.         req.set_cid(_cid);
  47.         req.set_exchange_name(ename);
  48.         //向服务器发送请求
  49.         _codec->send(_conn, req);
  50.         //等待服务器的响应
  51.         waitResponse(rid);
  52.         return;
  53.     }
  54.     bool declareQueue(const std::string& qname, bool durable, bool exclusive,
  55.         bool auto_delete, google::protobuf::Map<std::string, std::string> args)
  56.     {
  57.         std::string rid = UUIDHelper::uuid();
  58.         //构造一个声明的请求对象
  59.         declareQueueRequest req;
  60.         req.set_rid(rid);
  61.         req.set_cid(_cid);
  62.         req.set_queue_name(qname);
  63.         req.set_durable(durable);
  64.         req.set_exclusive(exclusive);
  65.         req.set_durable(auto_delete);
  66.         req.mutable_args()->swap(args);
  67.         //向服务器发送请求
  68.         _codec->send(_conn, req);
  69.         //等待服务器的响应
  70.         basicCommonResponsePtr resp = waitResponse(rid);
  71.         return resp->is_ok();
  72.     }
  73.     void deleteQueue(const std::string& qname)
  74.     {
  75.         std::string rid = UUIDHelper::uuid();
  76.         //构造一个删除队列的请求对象
  77.         deleteQueueRequest req;
  78.         req.set_rid(rid);
  79.         req.set_cid(_cid);
  80.         req.set_queue_name(req);
  81.         //向服务器发送请求
  82.         _codec->send(_conn, req);
  83.         //等待服务器的响应
  84.         waitResponse(rid);
  85.         return;
  86.     }
  87.     bool queueBind(const std::string& ename, const std::string& qname, const std::string& key)
  88.     {
  89.         std::string rid = UUIDHelper::uuid();
  90.         //构造一个队列绑定的请求对象
  91.         queueBindRequest req;
  92.         req.set_rid(rid);
  93.         req.set_cid(_cid);
  94.         req.set_exchange_name(ename);
  95.         req.set_queue_name(qname);
  96.         req.set_binding_key(key);
  97.         //向服务器发送请求
  98.         _codec->send(_conn, req);
  99.         //等待服务器的响应
  100.         basicCommonResponsePtr resp = waitResponse(rid);
  101.         return resp->is_ok();
  102.     }
  103.     void queueUnBind(const std::string& ename, const std::string& qname)
  104.     {
  105.         std::string rid = UUIDHelper::uuid();
  106.         //构造一个队列解绑定的请求对象
  107.         queueUnBindRequest req;
  108.         req.set_rid(rid);
  109.         req.set_cid(_cid);
  110.         req.set_exchange_name(ename);
  111.         req.set_queue_name(qname);
  112.         //向服务器发送请求
  113.         _codec->send(_conn, req);
  114.         //等待服务器的响应
  115.         waitResponse(rid);
  116.         return;
  117.     }
  118.     void basicPublish(const std::string& ename, const BasicProperties* bp, const std::string& body)
  119.     {
  120.         std::string rid = UUIDHelper::uuid();
  121.         //构造一个消息发布的请求对象
  122.         basicPublishRequest req;
  123.         req.set_rid(rid);
  124.         req.set_cid(_cid);
  125.         req.set_exchange_name(ename);
  126.         req.set_body(body);
  127.         if (bp)
  128.         {
  129.             req.mutable_properties()->set_id(bp->id());
  130.             req.mutable_properties()->set_delivery_mode(bp->delivery_mode());
  131.             req.mutable_properties()->set_routing_key(bp->routing_key());
  132.         }
  133.         //向服务器发送请求
  134.         _codec->send(_conn, req);
  135.         //等待服务器的响应
  136.         waitResponse(rid);
  137.         return;
  138.     }
  139.     void basicAck(const std::string& msgid)
  140.     {
  141.         if (_consumer.get() != nullptr)
  142.         {
  143.             DLOG("消息确认时, 找不到消费者信息")
  144.             return;
  145.         }
  146.         std::string rid = UUIDHelper::uuid();
  147.         //构造一个消息确认的请求对象
  148.         basicAckRequest req;
  149.         req.set_rid(rid);
  150.         req.set_cid(_cid);
  151.         req.set_queue_name(_consumer->qname);
  152.         req.set_message_id(msgid);
  153.         //向服务器发送请求
  154.         _codec->send(_conn, req);
  155.         //等待服务器的响应
  156.         waitResponse(rid);
  157.         return;
  158.     }
  159.     bool basicConsume(const std::string& consumer_tag, const std::string& qname,
  160.         bool auto_ack, const ConsumerCallBack& cb)
  161.     {
  162.         if (_consumer.get() != nullptr)
  163.         {
  164.             DLOG("已经订阅过队列%s, 不能重复订阅")
  165.             return false;
  166.         }
  167.         std::string rid = UUIDHelper::uuid();
  168.         //构造一个订阅队列的请求对象
  169.         basicConsumeRequest req;
  170.         req.set_rid(rid);
  171.         req.set_cid(_cid);
  172.         req.set_queue_name(qname);
  173.         req.set_consumer_tag(consumer_tag);
  174.         req.set_auto_ack(auto_ack);
  175.         //向服务器发送请求
  176.         _codec->send(_conn, req);
  177.         //等待服务器的响应
  178.         basicCommonResponsePtr resp = waitResponse(rid);
  179.         if (resp->is_ok() == false)
  180.         {
  181.             DLOG("添加订阅失败");
  182.             return false;
  183.         }
  184.         _consumer = std::make_shared<Consumer>(consumer_tag, qname, auto_ack, cb);
  185.         return true;
  186.     }
  187.     void basicCancel()
  188.     {
  189.         std::string rid = UUIDHelper::uuid();
  190.         //构造一个消息确认的请求对象
  191.         basicCancelRequest req;
  192.         req.set_rid(rid);
  193.         req.set_cid(_cid);
  194.         req.set_queue_name(_consumer->qname);
  195.         req.set_consumer_tag(_consumer->tag);
  196.         //向服务器发送请求
  197.         _codec->send(_conn, req);
  198.         //等待服务器的响应
  199.         waitResponse(rid);
  200.         _consumer.reset(); //重置订阅
  201.         return;
  202.     }
  203. public:
  204.     //连接收到基础响应,向响应消息队列中添加数据
  205.     void putBasicResponse(const basicCommonResponsePtr& resp)
  206.     {
  207.         std::unique_lock<std::mutex> lock(_mutex);
  208.         _basic_resp.insert({resp->rid(), resp});
  209.         _cv.notify_all();
  210.     }
  211.     //连接收到消息推送后,需要通过信道找到对应的消费者对象,通过回调函数进行消息处理
  212.     void consume(const basicConsumeResponsePtr& resp)
  213.     {
  214.         if (_consumer.get() == nullptr)
  215.         {
  216.             DLOG("消息处理时,未找到订阅者信息!");
  217.             return;
  218.         }
  219.         if (_consumer->tag != resp->consumer_tag())
  220.         {
  221.             DLOG("收到的推送消息中消费者标识和当前信道消费者不一致!");
  222.             return;
  223.         }
  224.         //_consumer->cb已经说明了收到消息后如何处理
  225.         _consumer->callback(resp->consumer_tag(), resp->mutable_properties(), resp->body());
  226.     }
  227. private:
  228.     basicCommonResponsePtr waitResponse(const std::string& rid)
  229.     {
  230.         std::unique_lock<std::mutex> lock(_mutex);
  231.         _cv.wait(lock, [&rid, this](){
  232.             return _basic_resp.find(rid) != _basic_resp.end();
  233.         });
  234.         basicCommonResponsePtr basic_resp = _basic_resp[rid];
  235.         _basic_resp.erase(rid);
  236.         return basic_resp;
  237.     }
  238. private:
  239.     std::string _cid;         // 1)信道 ID
  240.     muduo::net::TcpConnectionPtr _conn;  // 2)信道关联的网络通信连接对象
  241.     ProtobufCodecPtr _codec;     // 3)protobuf 协议处理对象
  242.     Consumer::ptr _consumer;  // 4)信道关联的消费者
  243.     std::unordered_map<std::string, basicCommonResponsePtr> _basic_resp;  // 5)请求对应的响应信息队列
  244.     std::mutex _mutex;             //6)互斥锁
  245.     std::condition_variable _cv;   //7)条件变量
  246. };
复制代码


  • 团体来说全部函数的实现都比力简单,都是先构建哀求对象,再向服务端发送哀求对象,最后等待服务器的的响应。
  • putBasicResponse是给客户端服务器使用的,当客户端接收到了一条基础响应时,服务器就会通知对应的Channel信道调用该函数,该函数实行后,会唤醒条件变量的等待,那么在原客户端发起哀求的函数中就会在waitRespoonse函数继承实行——将哈希表中对应的哀求信息删除。
  • consume也是给客户端服务器使用的当客户端接收到了一条消息响应时,就会调用该函数,该函数内部会举行简单的判断,然后实行消息处理回调函数。

11.3 异步工作线程实现

客户端这边存在两个异步工作线程:


  • 一个是 muduo 库中客户端毗连的异步循环线程 EventLoopThread。
  • 一个是当收到消息后举行异步处理的工作线程池。
这两项都不是以毗连为单元举行创建的,而是创建后,可以用以多个毗连,多个信道,多个消费者,因此单独举行封装。
  1. #pragma once
  2. #include "muduo/net/EventLoopThread.h"
  3. #include "../mqcommon/mq_threadpool.hpp"
  4. #include "../mqcommon/mq_logger.hpp"
  5. namespace bitmq
  6. {
  7.     //异步工作者类
  8.     class AsyncWorker
  9.     {
  10.     public:
  11.         using ptr = std::shared_ptr<AsyncWorker>;
  12.         muduo::net::EventLoopThread loopthread;
  13.         threadpool pool;
  14.     };
  15. }
复制代码

11.4 毗连受理模块

在客户端这边, RabbitMQ 弱化了客户端的概念,由于用户所需的服务都是通过信道来提供的(不需要创建客户端向服务器发起哀求,而是通过创建信道来向服务器发起哀求),因此操作头脑转换为先创建毗连,通过毗连创建信道,通过信道提供服务这一流程。
这个模块同样是针对 muduo 库客户端毗连的二次封装,向用户提供创建 channel 信道的接口,创建信道后,可以通过信道来获取指定服务。
但是不管怎么说,毗连受理模块实际上都是搭建了一个客户端,而这个客户端是之前我们编写过的:基于muduo库的protobuf通信协议程序的客户端。
代码如下:
  1. #include <iostream>
  2. #include <functional>
  3. #include <memory>
  4. #include "request.pb.h"
  5. #include "muduo/proto/codec.h"
  6. #include "muduo/proto/dispatcher_lite.h"
  7. #include "muduo/proto/dispatcher.h"
  8. #include "muduo/net/EventLoopThread.h"
  9. #include "muduo/net/TcpClient.h"
  10. #include "muduo/net/TcpConnection.h"
  11. #include "muduo/base/CountDownLatch.h"
  12. #include "muduo/base/Mutex.h"
  13. using namespace std;
  14. class ProtoClient
  15. {
  16. public:
  17.         typedef shared_ptr<google::protobuf::Message> MessagePtr;
  18.     typedef shared_ptr<request::TranslateRequest> TranslateRequestPtr;
  19.     typedef shared_ptr<request::TranslateResponse> TranslateResponsePtr;
  20.     typedef shared_ptr<request::CalculatorRequest> CalculatorRequestPtr;
  21.     typedef shared_ptr<request::CalculatorResponse> CalculatorResponsePtr;
  22.         ProtoClient(const std::string& ip, int port)
  23.                 : _latch(1)
  24.                 , _client(_loopthread.startLoop(), muduo::net::InetAddress(ip, port), "Client")
  25.                 , _dispatcher(bind(&ProtoClient::onUnknownMessage, this, placeholders::_1, placeholders::_2, placeholders::_3))
  26.                 , _codec(bind(&ProtobufDispatcher::onProtobufMessage, &_dispatcher, placeholders::_1, placeholders::_2, placeholders::_3))
  27.         {
  28.                 //注册业务回调函数
  29.                 _dispatcher.registerMessageCallback<request::TranslateResponse>(bind(&ProtoClient::translateResp, this, placeholders::_1, placeholders::_2, placeholders::_3));
  30.                 _dispatcher.registerMessageCallback<request::CalculatorResponse>(bind(&ProtoClient::calculatorResp, this, placeholders::_1, placeholders::_2, placeholders::_3));
  31.                 //注册连接以及消息回调
  32.                 _client.setConnectionCallback(std::bind(&ProtoClient::onConnection, this, placeholders::_1));
  33.                 _client.setMessageCallback(bind(&ProtobufCodec::onMessage, &_codec, placeholders::_1, placeholders::_2, placeholders::_3));
  34.         }
  35.         void connect()
  36.         {
  37.                 _client.connect();
  38.                 _latch.wait();
  39.         }
  40.         void translate()
  41.         {
  42.                 std::cout << "请输入你要翻译的单词:";
  43.                 string word;
  44.                 getline(cin, word);
  45.                 request::TranslateRequest req;
  46.                 req.set_word(word);
  47.                 send(req);
  48.         }
  49.         void calculator()
  50.         {
  51.                 std::cout << "请输入操作数1:";
  52.                 int num1 = 0;
  53.                 cin >> num1;
  54.                 getchar();
  55.                 std::cout << "请输入操作符:";
  56.                 string op;
  57.                 getline(cin, op);
  58.                 std::cout << "请输入操作数2:";
  59.                 int num2 = 0;
  60.                 cin >> num2;
  61.                 getchar();
  62.                 request::CalculatorRequest req;
  63.                 req.set_num1(num1);
  64.                 req.set_op(op);
  65.                 req.set_num2(num2);
  66.                 send(req);
  67.         }
  68. private:
  69.         void translateResp(const muduo::net::TcpConnectionPtr& conn, const TranslateResponsePtr& req, muduo::Timestamp rt)
  70.         {
  71.                 cout << "结果为:" << req->result() << endl;
  72.         }
  73.         void calculatorResp(const muduo::net::TcpConnectionPtr& conn, const CalculatorResponsePtr& req, muduo::Timestamp rt)
  74.         {
  75.                 if (req->code() == false)
  76.                 {
  77.                         cout << "发生错误" << endl;
  78.                 }
  79.                 else
  80.                 {
  81.                         cout << "结果为:" << req->result() << endl;
  82.                 }
  83.         }
  84.         //多态
  85.         void send(const google::protobuf::Message& msg)
  86.         {
  87.                 if (_conn->connected())
  88.                         _codec.send(_conn, msg);
  89.         }
  90.     void onConnection(const muduo::net::TcpConnectionPtr& conn)
  91.     {
  92.         if (conn->connected())
  93.         {
  94.             cout << "连接成功!!!" << endl;
  95.                         _latch.countDown();
  96.                         _conn = conn;
  97.         }
  98.         else
  99.         {
  100.             cout << "断开连接" << endl;
  101.                         _conn.reset();
  102.         }
  103.     }
  104.     void onUnknownMessage(const muduo::net::TcpConnectionPtr& conn, const MessagePtr& message, muduo::Timestamp)
  105.     {
  106.         std::cout << "onUnknownMessage: " << message->GetTypeName() << std::endl;
  107.                 conn->shutdown();
  108.     }
  109. private:
  110.         muduo::CountDownLatch _latch; //实现同步
  111.         muduo::net::EventLoopThread _loopthread; //异步循环处理线程
  112.         muduo::net::TcpConnectionPtr _conn; //客户端与服务器的连接
  113.         muduo::net::TcpClient _client;    //客户端
  114.         ProtobufDispatcher _dispatcher; //请求分发器
  115.         ProtobufCodec _codec; //协议处理器
  116. };
复制代码
那我们可以直接在这个代码的基础上举行修改:
  1. class Connection
  2. {
  3. public:
  4.     using MessagePtr = std::shared_ptr<google::protobuf::Message>;
  5.     using ProtobufCodecPtr = std::shared_ptr<ProtobufCodec>;
  6.     using basicConsumeResponsePtr = std::shared_ptr<basicConsumeResponse>;
  7.     using basicCommonResponsePtr = std::shared_ptr<basicCommonResponse>;
  8.     Connection(const std::string& ip, int port, AsyncWorker::ptr& worker)
  9.         : _latch(1)
  10.         , _client(_worker->loopthread.startLoop(), muduo::net::InetAddress(ip, port), "Client")
  11.         , _worker(worker)
  12.         , _channel_manager(std::make_shared<ChannelManager>())
  13.         , _dispatcher(std::bind(&Connection::onUnknownMessage, this, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3))
  14.         , _codec(std::make_shared<ProtobufCodec>(std::bind(&ProtobufDispatcher::onProtobufMessage, &_dispatcher, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3)))
  15.     {
  16.         //注册业务回调函数
  17.         _dispatcher.registerMessageCallback<basicConsumeResponse>(std::bind(&Connection::consumeResponse, this,
  18.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  19.         _dispatcher.registerMessageCallback<basicCommonResponse>(std::bind(&Connection::basicResponse, this,
  20.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  21.         //注册连接以及消息回调
  22.         _client.setConnectionCallback(std::bind(&Connection::onConnection, this, std::placeholders::_1));
  23.         _client.setMessageCallback(std::bind(&ProtobufCodec::onMessage, _codec, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  24.         //连接服务器
  25.         _client.connect();
  26.         _latch.wait();
  27.     }
  28.     //创建信道
  29.     Channel::ptr openChannel();
  30.     //关闭信道
  31.     void closeChannel(const Channel::ptr& channel);
  32. private:
  33.     void consumeResponse(const muduo::net::TcpConnectionPtr& conn, const basicConsumeResponsePtr& resp, muduo::Timestamp);
  34.     void basicResponse(const muduo::net::TcpConnectionPtr& conn, const basicCommonResponsePtr& resp, muduo::Timestamp);
  35.     void onConnection(const muduo::net::TcpConnectionPtr& conn)
  36.     {
  37.         if (conn->connected())
  38.         {
  39.             DLOG("连接建立成功");
  40.             _latch.countDown();
  41.             _conn = conn;
  42.         }
  43.         else
  44.         {
  45.             DLOG("连接断开");
  46.             _conn.reset();
  47.         }
  48.     }
  49.     void onUnknownMessage(const muduo::net::TcpConnectionPtr& conn, const MessagePtr& message, muduo::Timestamp)
  50.     {
  51.         std::cout << "onUnknownMessage: " << message->GetTypeName() << std::endl;
  52.         conn->shutdown();
  53.     }
  54. private:
  55.     muduo::CountDownLatch _latch; //实现同步
  56.     muduo::net::TcpConnectionPtr _conn; //客户端与服务器的连接
  57.     muduo::net::TcpClient _client;    //客户端
  58.     ProtobufDispatcher _dispatcher; //请求分发器
  59.     ProtobufCodecPtr _codec; //协议处理器
  60.     ChannelManager::ptr _channel_manager;
  61.     AsyncWorker::ptr _worker;
  62. };
复制代码


  • 客户端只会向外提供两个服务:1.创建信道,2.删除信道。客户端可以通过创建信道获取信道对象,然后通过信道去完成全部的服务(这就是弱化了客户端的头脑)
  • 在构造函数时会注册好_dispatcher的响应回调函数,当收到了基础响应时,就会调用basicResponse,而如果是消息响应,就会调用consumeResponse
完成毗连受理模块代码:
  1. class Connection
  2. {
  3. public:
  4.     using MessagePtr = std::shared_ptr<google::protobuf::Message>;
  5.     using ProtobufCodecPtr = std::shared_ptr<ProtobufCodec>;
  6.     using basicConsumeResponsePtr = std::shared_ptr<basicConsumeResponse>;
  7.     using basicCommonResponsePtr = std::shared_ptr<basicCommonResponse>;
  8.     Connection(const std::string& ip, int port, AsyncWorker::ptr& worker)
  9.         : _latch(1)
  10.         , _client(_worker->loopthread.startLoop(), muduo::net::InetAddress(ip, port), "Client")
  11.         , _worker(worker)
  12.         , _channel_manager(std::make_shared<ChannelManager>())
  13.         , _dispatcher(std::bind(&Connection::onUnknownMessage, this, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3))
  14.         , _codec(std::make_shared<ProtobufCodec>(std::bind(&ProtobufDispatcher::onProtobufMessage, &_dispatcher, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3)))
  15.     {
  16.         //注册业务回调函数
  17.         _dispatcher.registerMessageCallback<basicConsumeResponse>(std::bind(&Connection::consumeResponse, this,
  18.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  19.         _dispatcher.registerMessageCallback<basicCommonResponse>(std::bind(&Connection::basicResponse, this,
  20.                 std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  21.         //注册连接以及消息回调
  22.         _client.setConnectionCallback(std::bind(&Connection::onConnection, this, std::placeholders::_1));
  23.         _client.setMessageCallback(std::bind(&ProtobufCodec::onMessage, _codec, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));
  24.         //连接服务器
  25.         _client.connect();
  26.         _latch.wait();
  27.     }
  28.     //创建信道
  29.     Channel::ptr openChannel()
  30.     {
  31.         Channel::ptr channel = _channel_manager->create(_conn, _codec);
  32.         bool ret = channel->openChannel();
  33.         if (ret == false)
  34.         {
  35.             DLOG("打开信道失败!");
  36.             return Channel::ptr();
  37.         }
  38.         return channel;
  39.     }
  40.     //关闭信道
  41.     void closeChannel(const Channel::ptr& channel)
  42.     {
  43.         channel->closeChannel();
  44.         _channel_manager->remove(channel->getCid());
  45.     }
  46. private:
  47.     void consumeResponse(const muduo::net::TcpConnectionPtr& conn, const basicConsumeResponsePtr& resp, muduo::Timestamp)
  48.     {
  49.         //1.找到信道
  50.         Channel::ptr channel = _channel_manager->get(resp->cid());
  51.         if (channel.get() == nullptr)
  52.         {
  53.             DLOG("未找到信道信息!");
  54.             return;
  55.         }
  56.         //2.封装异步任务(消息处理)抛入线程池
  57.         _worker->pool.push([channel, resp](){
  58.             channel->consume(resp);
  59.         });
  60.     }
  61.     void basicResponse(const muduo::net::TcpConnectionPtr& conn, const basicCommonResponsePtr& resp, muduo::Timestamp)
  62.     {
  63.         //1.找到信道
  64.         Channel::ptr channel = _channel_manager->get(resp->cid());
  65.         if (channel.get() == nullptr)
  66.         {
  67.             DLOG("未找到信道信息!");
  68.             return;
  69.         }
  70.         //2.将得到的响应对象添加到信道基础响应hash_map中
  71.         channel->putBasicResponse(resp);
  72.     }
  73.     void onConnection(const muduo::net::TcpConnectionPtr& conn)
  74.     {
  75.         if (conn->connected())
  76.         {
  77.             DLOG("连接建立成功");
  78.             _latch.countDown();
  79.             _conn = conn;
  80.         }
  81.         else
  82.         {
  83.             DLOG("连接断开");
  84.             _conn.reset();
  85.         }
  86.     }
  87.     void onUnknownMessage(const muduo::net::TcpConnectionPtr& conn, const MessagePtr& message, muduo::Timestamp)
  88.     {
  89.         std::cout << "onUnknownMessage: " << message->GetTypeName() << std::endl;
  90.         conn->shutdown();
  91.     }
  92. private:
  93.     muduo::CountDownLatch _latch; //实现同步
  94.     muduo::net::TcpConnectionPtr _conn; //客户端与服务器的连接
  95.     muduo::net::TcpClient _client;    //客户端
  96.     ProtobufDispatcher _dispatcher; //请求分发器
  97.     ProtobufCodecPtr _codec; //协议处理器
  98.     ChannelManager::ptr _channel_manager;
  99.     AsyncWorker::ptr _worker;
  100. };
复制代码


12. 基于 MQ 的生产者-消费者模型

到这里我们的项目也进入尾声了,在这一章节中,我们会搭建一个发布消息的生产者客户端和一个订阅消息的消费者客户端,然后对项目举行团体测试。
测试思绪:


  • 1.必须有一个生产者客户端

    • 1.声明一个交换机 exchange1
    • 2.声明一个队列 queue1,binding_key = queue1
    • 3.声明一个队列 queue2,binding key = news.music.#
    • 4.将两个队列和交换机绑定起来

  • 2.搭建两个消费者客户端,分别各自订阅一个队列的消息测试:

    • 第一次,将交换机范例,定义为广播交换模式:理论结果,两个消费者客户端分别都能拿到消息
    • 第二次,将交换机范例,定义为直接交换模式:routing key=queue1 理论结果,只有queue1能拿到消息
    • 第三次,将交换机范例,定义为主题交换模式:routing key="news.music.pop",理论结果,只有queue2能拿到消息

12.1 实现生产者客户端

  1. #include "mq_connection.hpp"
  2. int main()
  3. {
  4.     //1.实例化异步工作线程对象
  5.     bitmq::AsyncWorker::ptr awp = std::make_shared<bitmq::AsyncWorker>();
  6.     //2.实例化连接对象
  7.     bitmq::Connection::ptr conn = std::make_shared<bitmq::Connection>("127.0.0.1", 8080, awp);
  8.     //3.通过连接创建信道
  9.     bitmq::Channel::ptr channel = conn->openChannel();
  10.     //4.通过信道提供的服务完成所需
  11.     //  1.声明一个交换机exchange1, 交换机类型为广播模式
  12.     google::protobuf::Map<std::string, std::string> map;
  13.     channel->declareExchange("exchange1", bitmq::ExchangeType::FANOUT, true, false, map);
  14.     //  2.声明一个队列queue1
  15.     channel->declareQueue("queue1", true, false, false, map);
  16.     //  3.声明一个队列queue2
  17.     channel->declareQueue("queue2", true, false, false, map);
  18.     //  4.绑定queue1-exchange1, binding_key设置为queue1
  19.     channel->queueBind("exchange1", "queue1", "queue1");
  20.     //  5.绑定queue2-exchange1, binding_key设置为news.music.#
  21.     channel->queueBind("exchange1", "queue2", "news.music.#");
  22.     //5.循环像交换机发布消息
  23.     for (int i = 0; i < 10; i++)
  24.     {
  25.         channel->basicPublish("exchange1", nullptr, "Hello World-" + std::to_string(i+1));
  26.     }
  27.     //6.关闭信道
  28.     conn->closeChannel(channel);
  29.     return 0;
  30. }
复制代码

12.2 实现消费者客户端

  1. #include "mq_connection.hpp"
  2. void cb(bitmq::Channel::ptr& channel, std::string consumer_tag, const bitmq::BasicProperties* bp, const std::string& body)
  3. {
  4.     std::cout << consumer_tag << "消费了消息: " << body << std::endl;
  5.     //对消息进行确认
  6.     channel->basicAck(bp->id());
  7. }
  8. int main(int argc, char* argv[])
  9. {
  10.     if (argc != 2)
  11.     {
  12.         std::cout << "usage: ./consumer_client queue_name" << std::endl;
  13.         return -1;
  14.     }
  15.     //1.实例化异步工作线程对象
  16.     bitmq::AsyncWorker::ptr awp = std::make_shared<bitmq::AsyncWorker>();
  17.     //2.实例化连接对象
  18.     bitmq::Connection::ptr conn = std::make_shared<bitmq::Connection>("127.0.0.1", 8080, awp);
  19.     //3.通过连接创建信道
  20.     bitmq::Channel::ptr channel = conn->openChannel();
  21.     //4.通过信道提供的服务完成所需
  22.     //  1.声明一个交换机exchange1, 交换机类型为广播模式
  23.     google::protobuf::Map<std::string, std::string> map;
  24.     channel->declareExchange("exchange1", bitmq::ExchangeType::FANOUT, true, false, map);
  25.     //  2.声明一个队列queue1
  26.     channel->declareQueue("queue1", true, false, false, map);
  27.     //  3.声明一个队列queue2
  28.     channel->declareQueue("queue2", true, false, false, map);
  29.     //  4.绑定queue1-exchange1, binding_key设置为queue1
  30.     channel->queueBind("exchange1", "queue1", "queue1");
  31.     //  5.绑定queue2-exchange1, binding_key设置为news.music.#
  32.     channel->queueBind("exchange1", "queue2", "news.music.#");
  33.     auto func = std::bind(cb, channel, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3);
  34.     std::string queue_name = argv[1];
  35.     std::string consumer_name = "consumer";
  36.     channel->basicConsume(consumer_name, queue_name, false, func);
  37.     while (1)
  38.     {
  39.         std::this_thread::sleep_for(std::chrono::seconds(3));
  40.     }
  41.     conn->closeChannel(channel);
  42.     return 0;
  43. }
复制代码


12.3 测试的时候发现的问题

   1.客户端启动程序后,客户端出现Segmentation fault错误
  问题:_worker对象还没有初始化就使用


   2.服务器启动后,消费客户端毗连服务器,信道创建成功后程序崩溃,出现错误Segmentation fault
  错误原因:getChannel时,it的判定设置错误,导致获取的是一个空指针。


   3.消费客户端毗连服务器后,在绑定队列之后,应订阅队列消息,但在订阅队列消息时程序制止不动
  问题:服务器在订阅队列完毕后,没有给客户端发送响应,导致客户端阻塞等待


   4.生产者生产消息后阻塞
  问题:在服务端接收到了消息后,只是将消息jiao'ge了对应的队列,并没有通知生产者结果,导致生产者阻塞。
  


   5.消费者在收到消息后,不停表现未找到消费者信息。
  问题:线程池传入对象时,写成了&channel。
  


12.4 广播模式测试

在办理了上面的问题后,程序终于可以正常运行了,来看一下测试过程。
首先先先容一下,每个程序对应的脚色:

先启动服务器,再启动接收消息客户端,而此时队列中没有消息,所以这两个客户端会阻塞等待。

此时启动消息发布客户端,由于这次测试接纳广播发送,所以消费者1和消费者2都可以收到消息。

消费者成功拿到了数据,程序也没有出现非常报错,阐明我们的代码暂时没什么问题了。
到这里简单的功能测试就完毕了,接下来我们再测试一下其他模式的测试。

12.5 直接模式测试

主要就是修改消息发布客户端,接收消息客户端只需要修改交换机范例即可。
  1. #include "mq_connection.hpp"
  2. int main()
  3. {
  4.     //1.实例化异步工作线程对象
  5.     bitmq::AsyncWorker::ptr awp = std::make_shared<bitmq::AsyncWorker>();
  6.     //2.实例化连接对象
  7.     bitmq::Connection::ptr conn = std::make_shared<bitmq::Connection>("127.0.0.1", 8080, awp);
  8.     //3.通过连接创建信道
  9.     bitmq::Channel::ptr channel = conn->openChannel();
  10.     //4.通过信道提供的服务完成所需
  11.     //  1.声明一个交换机exchange1, 交换机类型为广播模式
  12.     google::protobuf::Map<std::string, std::string> map;
  13.     channel->declareExchange("exchange1", bitmq::ExchangeType::DIRECT, true, false, map);
  14.     //  2.声明一个队列queue1
  15.     channel->declareQueue("queue1", true, false, false, map);
  16.     //  3.声明一个队列queue2
  17.     channel->declareQueue("queue2", true, false, false, map);
  18.     //  4.绑定queue1-exchange1, binding_key设置为queue1
  19.     channel->queueBind("exchange1", "queue1", "queue1");
  20.     //  5.绑定queue2-exchange1, binding_key设置为news.music.#
  21.     channel->queueBind("exchange1", "queue2", "news.music.#");
  22.     //5.循环像交换机发布消息
  23.     for (int i = 0; i < 10; i++)
  24.     {
  25.         DLOG("开始发布消息: %d", i + 1);
  26.         bitmq::BasicProperties bp;
  27.         bp.set_id(bitmq::UUIDHelper::uuid());
  28.         bp.set_delivery_mode(bitmq::DeliveryMode::DURABLE);
  29.         bp.set_routing_key("queue1");
  30.         channel->basicPublish("exchange1", &bp, "Hello World-" + std::to_string(i+1));
  31.     }
  32.     //6.关闭信道
  33.     conn->closeChannel(channel);
  34.     return 0;
  35. }
复制代码
代码需要简单的修改:将交换机的范例从广播交换改成直接交换,还需要给每条消息添加一个routing_key。

再启动消息发布客户端,预期效果是:只有消费者1能收到消息,消费者2收不到消息。

测试结果符合预期。

12.6 主题模式测试

  1. #include "mq_connection.hpp"
  2. int main()
  3. {
  4.     //1.实例化异步工作线程对象
  5.     bitmq::AsyncWorker::ptr awp = std::make_shared<bitmq::AsyncWorker>();
  6.     //2.实例化连接对象
  7.     bitmq::Connection::ptr conn = std::make_shared<bitmq::Connection>("127.0.0.1", 8080, awp);
  8.     //3.通过连接创建信道
  9.     bitmq::Channel::ptr channel = conn->openChannel();
  10.     //4.通过信道提供的服务完成所需
  11.     //  1.声明一个交换机exchange1, 交换机类型为广播模式
  12.     google::protobuf::Map<std::string, std::string> map;
  13.     channel->declareExchange("exchange1", bitmq::ExchangeType::TOPIC, true, false, map);
  14.     //  2.声明一个队列queue1
  15.     channel->declareQueue("queue1", true, false, false, map);
  16.     //  3.声明一个队列queue2
  17.     channel->declareQueue("queue2", true, false, false, map);
  18.     //  4.绑定queue1-exchange1, binding_key设置为queue1
  19.     channel->queueBind("exchange1", "queue1", "queue1");
  20.     //  5.绑定queue2-exchange1, binding_key设置为news.music.#
  21.     channel->queueBind("exchange1", "queue2", "news.music.#");
  22.     //5.循环像交换机发布消息
  23.     for (int i = 0; i < 10; i++)
  24.     {
  25.         DLOG("开始发布消息: %d", i + 1);
  26.         bitmq::BasicProperties bp;
  27.         bp.set_id(bitmq::UUIDHelper::uuid());
  28.         bp.set_delivery_mode(bitmq::DeliveryMode::DURABLE);
  29.         bp.set_routing_key("news.music.pop");
  30.         channel->basicPublish("exchange1", &bp, "Hello World-" + std::to_string(i+1));
  31.     }
  32.     bitmq::BasicProperties bp;
  33.     bp.set_id(bitmq::UUIDHelper::uuid());
  34.     bp.set_delivery_mode(bitmq::DeliveryMode::DURABLE);
  35.     bp.set_routing_key("news.sport.football");
  36.     channel->basicPublish("exchange1", &bp, "Hello World-" + std::to_string(11));
  37.     //6.关闭信道
  38.     conn->closeChannel(channel);
  39.     return 0;
  40. }
复制代码
我们测试十条能发布的还有一条不能发布的,预期结果是消费者1收不到信息,消费者2能收到10条消息。

结果符合预期。

13. 项目总结

首先明白我们所实现的项目:仿 RabbitMQ 实现一个简化版的消息队列组件,其内部实现了消息队列服务器以及客户端的搭建,并支持差别主机间消息的发布与订阅及消息推送功能。
其次项目中所用到的技术:基于 muduo 库实现底层网络通佩服务器和客户端的搭建,在应用层基于 protobuf 协议设计应用层协议接口,在数据管理上使用了轻量数据库sqlite 来举行数据的长期化管理,以及基于 AMQP 模型的理解,实现整个消息队列项目技术的整合,并在项目的实现过程中使用 gtest 框架举行单元测试,完成项目的最终实现。

14. 扩展功能



  • 1)虚拟主机管理
  • 2)用户管理/用户认证
  • 3)交换机/队列 的独占模式和主动删除
  • 4)发送方确认(broker 给生产者的确认应答)
  • 5)消息的管理方式
  • 6)管理接口
  • 7)管理页面

15. 项目源码

https://gitee.com/fan-tianle/bitmq

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

小小小幸运

金牌会员
这个人很懒什么都没写!
快速回复 返回顶部 返回列表