SimpleAmqpClient 项目下载及安装教程

1. 项目介绍

SimpleAmqpClient 是一个易于使用的 C++ 封装库，基于 rabbitmq-c C 库开发。它从 puka AMQP 库中汲取灵感，抽象了底层 AMQP 协议中的通道概念，并将其用作错误/消费者的作用域。这使得编写简单的单线程 AMQP 应用程序变得容易。

2. 项目下载位置

项目托管在 GitHub 上，可以通过以下步骤进行下载：

1. 打开终端或命令行工具。
2. 使用 git clone 命令下载项目：

git clone https://github.com/alanxz/SimpleAmqpClient.git

3. 项目安装环境配置

3.1 环境要求

• 操作系统：Windows 10、Windows 7、Linux（RHEL 6.0）、Mac OS X（10.7 及以上）
• 编译器：MSVC 2019、GCC-4.4.5、gcc-4.2
• 依赖库：
  • boost-1.47.0 或更新版本（使用 chrono、system 等内部库）
  • rabbitmq-c 0.8.0 或更高版本
  • cmake 3.5 或更高版本
  • Doxygen（可选，用于生成 API 文档）

3.2 环境配置示例

以下是 Windows 10 环境下的配置示例：

1. 安装 Boost 库：

   • 使用 NuGet 安装 Boost 库：

     nuget install boost_chrono-vc142 -Version 1.77.0
     nuget install boost_system-vc142 -Version 1.77.0
     nuget install boost -Version 1.77.0
     

2. 安装 rabbitmq-c：

   • 下载并编译 rabbitmq-c 库，确保其为共享库。

3. 安装 CMake：

   • 下载并安装 CMake 3.5 或更高版本。

4. 项目安装方式

4.1 使用 CMake 构建项目

1. 进入项目目录：

   cd SimpleAmqpClient
   

2. 创建构建目录：

   mkdir simpleamqpclient-build
   cd simpleamqpclient-build
   

3. 运行 CMake 配置：

   cmake ..
   

4. 使用适当的构建工具进行编译：

   • 在 Linux 或 macOS 上使用 make：

     make
     

   • 在 Windows 上使用 msbuild：

     msbuild SimpleAmqpClient.sln
     

4.2 安装项目

1. 运行安装命令：

   make install
   

2. 安装完成后，库文件和头文件将被安装到 CMAKE_INSTALL_PREFIX 指定的目录中。

5. 项目处理脚本

5.1 示例脚本

以下是一个简单的 C++ 示例脚本，展示如何使用 SimpleAmqpClient 库连接到 AMQP 代理并消费消息：

#include <SimpleAmqpClient/SimpleAmqpClient.h>
#include <iostream>

int main() {
    try {
        // 创建连接
        AmqpClient::Channel::ptr_t channel = AmqpClient::Channel::Create("localhost");

        // 设置消费者
        std::string consumer_tag = channel->BasicConsume("my_queue", "");

        // 消费消息
        AmqpClient::Envelope::ptr_t envelope = channel->BasicConsumeMessage(consumer_tag);

        // 输出消息内容
        std::cout << "Received message: " << envelope->Message()->Body() << std::endl;

        // 确认消息
        channel->BasicAck(envelope);
    } catch (const std::exception& e) {
        std::cerr << "Error: " << e.what() << std::endl;
    }

    return 0;
}

5.2 编译脚本

使用以下命令编译示例脚本：

g++ -o amqp_consumer amqp_consumer.cpp -lSimpleAmqpClient -lboost_system

5.3 运行脚本

编译完成后，运行生成的可执行文件：

./amqp_consumer

通过以上步骤，您可以成功下载、安装并使用 SimpleAmqpClient 项目。