RabbitMQ 入门（part 1）

RabbitMQ消息中间件的.NET/C#使用教程

最新推荐文章于 2025-05-14 10:34:48 发布

翻译最新推荐文章于 2025-05-14 10:34:48 发布 · 180 阅读

RabbitMQ 专栏收录该内容

3 篇文章

订阅专栏

简介

RabbitMQ是一个message broker（消息中间件）：它接受和转发消息。你可以把它想象成一个邮局：当你把你想要发布的邮件放在一个邮筒里时，你可以确定邮递员最终会把邮件交给你的收件人。在这个类比中，RabbitMQ是一个邮筒、一个邮局和一个邮递员。
RabbitMQ和邮局之间的主要区别在于，它不处理纸张，而是接受、存储和转发二进制数据消息。
RabbitMQ和消息传递通常使用一些术语。

Producing的思就是发送。一个发送消息的程序是一个生产者：

Queue(队列)是位于RabbitMQ内的一个邮筒的名称。尽管消息通过RabbitMQ和您的应用程序流动，但它们只能存储在队列中。队列只受主机的内存和磁盘限制的限制，它本质上是一个大的消息缓冲区。许多生产者可以发送到一个队列的消息，许多消费者可以尝试从一个队列接收数据。这就是我们如何表示队列的方式：
Queue

Consuming(消费者）对接收也有类似的含义。消费者是一个主要等待接收消息的程序：
Queue
请注意，生产者（Producer）、消费者（consumer）和中间件（borker）不需要驻留在同一个主机上;事实上，在大多数应用中，它们都没有。

“Hello World”

(using the .NET/C# Client)

在本教程的这一部分，我们将在C#中编写两个程序；一个发送单一消息的生产者，以及一个接收消息并将其打印出来的消费者。我们将对.NET客户端API中的一些细节进行注释，将重点放在这个非常简单的事情上，以便开始。这是一个信息传递的“Hello World”。

在下面的图表中，“P”是我们的生产者，而“C”是我们的消费者。中间的盒子是一个队列——RabbitMQ代表消费者保存的消息缓冲区。
Queue

The .NET client library
RabbitMQ讲多种协议。本教程使用AMQP 0-9-1，这是一种开放的、通用的消息传递协议。在许多不同的语言中，RabbitMQ有许多客户端。我们将使用RabbitMQ提供的`.NET Client。
客户端支持.Net Core Net Framework4.5.1+ 本教程将使用RabbitMQ.NET客户端5.0和.NET Core，这样您就可以确保安装并在您的路径中安装了它。
您还可以使用.NET框架来完成本教程，但是设置步骤将有所不同。
RabbitMQ。NET客户端5.0和以后的版本是通过nuget分发的。
本教程假设您在Windows上使用powershell。在MacOS和Linux上，几乎任何shell都可以工作。

安装

首先，让我们验证您在PATH中有。NET核心工具链：

dotnet --help

应该提供一个帮助信息。
现在，让我们生成两个项目，一个用于publisher，一个用于consumer：

dotnet new console --name Send
mv Send/Program.cs Send/Send.cs
dotnet new console --name Receive
mv Receive/Program.cs Receive/Receive.cs

这将创建两个名为Send和Receive的新目录。
然后我们添加客户端依赖项。

cd Send
dotnet add package RabbitMQ.Client
dotnet restore
cd ../Receive
dotnet add package RabbitMQ.Client
dotnet restore

现在我们已经建立了。NET项目，我们可以编写一些代码。

Sending (发送)

获取-github 源代码 Send.cs

using System;
using RabbitMQ.Client;
using System.Text;

连接抽象了套接字连接，并负责协议版本的协商和认证，等等。在这里，我们连接到本地机器上的代理——因此是localhost。如果我们想要连接到另一台机器上的代理，我们只需在这里指定它的名称或IP地址。
接下来，我们创建一个通道，这是大多数用于完成任务的API所在。
为了发送，我们必须声明一个队列供我们发送;然后我们可以向队列发布一条消息：

public class Send
{
    public static void Main()
    {
        var factory = new ConnectionFactory() { HostName = "localhost" };//创建连接工厂
        using(var connection = factory.CreateConnection())  //创建一个连接
        using(var channel = connection.CreateModel())   //创建一个模型 
        {
            channel.QueueDeclare(queue: "hello", 
                                exclusive: false, 
                                autoDelete: false, 
                                arguments: null);

            string message = "Hello World!";
            var body = Encoding.UTF8.GetBytes(message);

            channel.BasicPublish(exchange: "",
                                basicProperties: null,
                                 body: body);
            Console.WriteLine(" [x] Sent {0}", message);
        }

        Console.WriteLine(" Press [enter] to exit.");
        Console.ReadLine();
    }
}

Receiving(接收者)

using RabbitMQ.Client;
using RabbitMQ.Client.Events;
using System;
using System.Text;

设置与publisher是一样的;我们打开一个连接和一个通道，并声明我们将要消费的队列。注意，这与发送发布到的队列相匹配。

注意，我们也在这里声明队列。因为我们可能会在publisher之前启动消费者，所以在尝试使用它之前，我们希望确保队列的存在。
我们将告诉服务器从队列中传递消息。因为它会异步地推送我们的消息，所以我们提供了一个回调。这就是EventingBasicConsumer。收到的事件处理程序。

class Receive
{
    public static void Main()
    {
        var factory = new ConnectionFactory() { HostName = "localhost" };
        using(var connection = factory.CreateConnection())
        using(var channel = connection.CreateModel())
        {
            channel.QueueDeclare(queue: "hello", durable: false, exclusive: false, autoDelete: false, arguments: null);

            var consumer = new EventingBasicConsumer(channel);
            consumer.Received += (model, ea) =>
            {
                var body = ea.Body;
                var message = Encoding.UTF8.GetString(body);
                Console.WriteLine(" [x] Received {0}", message);
            };
            channel.BasicConsume(queue: "hello", autoAck: true, consumer: consumer);

            Console.WriteLine(" Press [enter] to exit.");
            Console.ReadLine();
        }
    }
}