C# RabbitMQ的使用

尋找無名的特質發表於2021-12-28

本文目的如題。

安裝

先說一下RabbitMQ的安裝，建議使用Docker映象安裝，Docker安裝的好處是不管Windows系統還是Linux，安裝步驟少，安裝方法相同，不容易出錯。使用下面的命令就可以：

docker run -d --hostname myRabbit --name rabbitmq3.9.11 -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=admin RABBITMQ_DEFAULT_VHOST=my_vhost -p 15672:15672 -p 5672:5672 rabbitmq3.9.11:management

安裝完成後，可以開啟瀏覽器訪問管理網站http://127.0.0.1:15672，使用安裝時設定的使用者名稱和密碼登入，就可以進行管理了。

不管使用什麼方法安裝，都可以執行本文中的示例。這些示例中使用了使用者admin，密碼是admin，如果沒有，可以在管理網站中建立：

本文的示例中還使用了my_vhost虛擬主機，如果沒有，也需要定義一下：

注意，admin 需要有對my_vhost的操作許可權。

編寫訊息接收端

安裝完成後可以進行開發了。我們需要編寫訊息的生產者和消費者，如果哪一部分出了問題，或者RabbitMQ伺服器出了問題，都會影響工作的進展。因此我們分步進行，先編寫訊息接受部分，也就是所謂的消費者，與RabbitMQ伺服器聯調，成功後再進行下一步。

先建立一個.Net 6的控制檯專案,可以使用Visual Studio建立。如果使用命令列，命令如下:

mkdir DirectReceiveDemo
cd DirectReceiveDemo
dotnet new console

然後安裝rabbitmq.client程式包：

dotnet add package rabbitmq.client

編寫Program.cs程式碼如下：

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

var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{
    channel.QueueDeclare(queue: "mymessage",
                                  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.ToArray());
        Console.WriteLine("收到訊息 {0}", message);
    };
    channel.BasicConsume(queue: "mymessage",
                         autoAck: true,
                         consumer: consumer);

    Console.WriteLine(" 按回車退出");
    Console.ReadLine();
}

執行dotnet run 執行程式碼，程式會一直等待輸入，這時需要輸入一些訊息驗證程式。現在登入管理網站http://127.0.0.1:15672/，使用安裝時設定的使用者名稱和密碼,在Connections分頁中可以看到多了新的連線：

在Channel分頁中可以看到當前的Chanel:

進入Queues分頁，點選列表中的mymessage

進入mymessage佇列：

在Publish message中寫一些訊息併傳送。回到控制檯接收程式，訊息應該已經被接收了。

到這裡，接收部分完成，退出這個程式，我們開始編寫傳送部分。

編寫傳送端

建立過程跟接收部分完全一樣，只是專案名稱為DirectSendDemo，Program.cs程式碼如下：

using RabbitMQ.Client;
using System.Text;


var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{
    channel.QueueDeclare(queue: "mymessage",
                                     durable: false,
                                     exclusive: false,
                                     autoDelete: false,
                                     arguments: null);

    Console.WriteLine("輸入需要傳輸的訊息，輸入Exit退出");
    var message = Console.ReadLine();
    while (message != "Exit")
    {
        var body = Encoding.UTF8.GetBytes(message);

        channel.BasicPublish(exchange: "",
                             routingKey: "mymessage",
                             basicProperties: null,
                             body: body);
        Console.WriteLine(" 傳送訊息 {0}", message);
        message = Console.ReadLine();
    }
}

Console.WriteLine("按回車退出");
Console.ReadLine();

執行這個專案，輸入一些訊息，

還是回到管理頁面，在mymessage佇列頁面，執行GetMessage,可以獲取傳送的訊息。

測試傳送端和接收端

現在我們可以讓傳送和接收一起工作了，在兩個終端分別啟動傳送和接收程式，看是否可以一起工作。

傳送和接收可以一起工作了。

現在可以用這兩個程式做一些測試，首先看一下一個傳送端，兩個接收端是什麼情況：

我們發現，接收端會輪流接收訊息。
兩個傳送端對一個接收端的情況如下：

跟想象的一樣，接收端會處理所有訊息。

Fanout 模式

現在我們需要處理一個訊息有多個消費者的情況，這種情況下，訊息需要傳送給交換機（exchange）,然後將交換機與訊息佇列繫結，一個交換機可以繫結多個訊息佇列，這樣，不同的訊息消費者都可以接收到訊息。我們建立一個新的傳送方FanoutSender，將訊息傳送給exchange：

using RabbitMQ.Client;
using System.Text;


var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{
    channel.ExchangeDeclare("example.exchange", ExchangeType.Fanout, true, false, null);

    Console.WriteLine("輸入需要傳輸的訊息，輸入Exit退出");
    var message = Console.ReadLine();
    while (message != "Exit")
    {
        var body = Encoding.UTF8.GetBytes(message);

        channel.BasicPublish(exchange: "example.exchange",
                             routingKey: "",
                             basicProperties: null,
                             body: body);
        Console.WriteLine(" 傳送訊息 {0}", message);
        message = Console.ReadLine();
    }
}

Console.WriteLine("按回車退出");
Console.ReadLine();

然後建立兩個接收方，FanoutReceiver1和FanoutReceiver2，分別接收que1和que2佇列的訊息，這兩個佇列都繫結到相同的交換機，程式碼如下：
FanoutReceiver1:

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


var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{
    channel.ExchangeDeclare(exchange: "example.exchange",
type: "fanout", durable: true);

    channel.QueueDeclare(queue: "que1",
                         durable: true,
                         exclusive: false,
                         autoDelete: false,
                         arguments: null);
    channel.QueueBind(queue: "que1", exchange: "example.exchange",
routingKey: "");
    var consumer = new EventingBasicConsumer(channel);
    consumer.Received += (model, ea) =>
    {
        var body = ea.Body;
        var message = Encoding.UTF8.GetString(body.ToArray());
        Console.WriteLine("收到訊息 {0}", message);
    };
    channel.BasicConsume(queue: "que1",
                         autoAck: true,
                         consumer: consumer);

    Console.WriteLine(" 按回車退出");
    Console.ReadLine();
}

FanoutReceiver2:

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


var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{
    channel.ExchangeDeclare(exchange: "example.exchange",
type: "fanout", durable: true);

    channel.QueueDeclare(queue: "que2",
                         durable: true,
                         exclusive: false,
                         autoDelete: false,
                         arguments: null);
    channel.QueueBind(queue: "que2", exchange: "example.exchange",
routingKey: "");
    var consumer = new EventingBasicConsumer(channel);
    consumer.Received += (model, ea) =>
    {
        var body = ea.Body;
        var message = Encoding.UTF8.GetString(body.ToArray());
        Console.WriteLine("收到訊息 {0}", message);
    };
    channel.BasicConsume(queue: "que2",
                         autoAck: true,
                         consumer: consumer);

    Console.WriteLine(" 按回車退出");
    Console.ReadLine();
}

同時啟動這三個程式，執行結果如下：

傳送的訊息被同時接收。

使用這種方式，我們可以靈活擴充套件訊息的消費者，比如使用者提醒功能，目前已經有了郵件提醒和簡訊提醒，對應的兩個佇列繫結到相同交換機，如果再增加微信提醒，只要再增加一個繫結佇列和相應的處理程式就可以了。

Direct模式和RouteKey

在Fanout模式下，我們將訊息傳送到訂閱訊息的所有佇列中，如果我們希望選擇性地向佇列傳送訊息，可以使用Direct模式，根據不同的RouteKey向不同的佇列傳送訊息。

我們建立三個控制檯程式程式模擬一個傳送方和兩個接收方，專案的建立方法同上，程式碼如下：
傳送：

using RabbitMQ.Client;
using System.Text;


var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{
    channel.ExchangeDeclare("directdemo.exchange", ExchangeType.Direct, true, false, null);

    Console.WriteLine("輸入需要傳輸的訊息，輸入Exit退出");
    var message = Console.ReadLine();
    while (message != "Exit")
    {
        Console.WriteLine("輸入RouteKey");
        var routekey = Console.ReadLine();
        var body = Encoding.UTF8.GetBytes(message);

        channel.BasicPublish(exchange: "directdemo.exchange",
                             routingKey: routekey,
                             basicProperties: null,
                             body: body);
        Console.WriteLine(" 傳送訊息 {0} Routekey {1}", message,routekey);
        message = Console.ReadLine();
    }
}

Console.WriteLine("按回車退出");
Console.ReadLine();

接收1：

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


var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{

    channel.ExchangeDeclare(exchange: "directdemo.exchange",
type: ExchangeType.Direct, durable: true);

    channel.QueueDeclare(queue: "log_que",
                         durable: true,
                         exclusive: false,
                         autoDelete: false,
                         arguments: null);
    channel.QueueBind(queue: "log_que", exchange: "directdemo.exchange",
routingKey: "log");
    var consumer = new EventingBasicConsumer(channel);
    consumer.Received += (model, ea) =>
    {
        var body = ea.Body;
        var message = Encoding.UTF8.GetString(body.ToArray());
        Console.WriteLine("收到訊息 {0}", message);
    };
    channel.BasicConsume(queue: "log_que",
                         autoAck: true,
                         consumer: consumer);

    Console.WriteLine(" 按回車退出");
    Console.ReadLine();
}

接收2：

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


var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{

    channel.ExchangeDeclare(exchange: "directdemo.exchange",
type: ExchangeType.Direct, durable: true);

    channel.QueueDeclare(queue: "email_que",
                         durable: true,
                         exclusive: false,
                         autoDelete: false,
                         arguments: null);
    channel.QueueBind(queue: "email_que", exchange: "directdemo.exchange",
routingKey: "email");
    var consumer = new EventingBasicConsumer(channel);
    consumer.Received += (model, ea) =>
    {
        var body = ea.Body;
        var message = Encoding.UTF8.GetString(body.ToArray());
        Console.WriteLine("收到訊息 {0}", message);
    };
    channel.BasicConsume(queue: "email_que",
                         autoAck: true,
                         consumer: consumer);

    Console.WriteLine(" 按回車退出");
    Console.ReadLine();
}

上面的程式碼中，關鍵是佇列繫結：

   channel.QueueBind(queue: "email_que", exchange: "directdemo.exchange",
routingKey: "email");

這句話將queue、exchange和routingKey繫結在一起。執行效果如下：

Topic 模式

前面的Direct模式中，RouteKey是固定的，Topic模式引入了萬用字元，RouteKey可以是符合表示式的任何字串。

萬用字元“*”，代表一個字元
萬用字元“#”,代表0或多個字元

仔細研究上面的規則，會發現Topic模式可以代替Direct和Fanout，如果RouteKey被設定為“#”，就是佇列可以接收任何訊息，這與Fanout模式相同，如果RouteKey中沒有萬用字元，則和使用Direct模式的效果相同。

現在我們編寫Topic模式的傳送和接收，程式碼如下：
Topic模式傳送：

using RabbitMQ.Client;
using System.Text;


var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{
    channel.ExchangeDeclare("topicdemo.exchange", ExchangeType.Topic, true, false, null);

    Console.WriteLine("輸入需要傳輸的訊息，輸入Exit退出");
    var message = Console.ReadLine();
    while (message != "Exit")
    {
        Console.WriteLine("輸入RouteKey");
        var routekey = Console.ReadLine();
        var body = Encoding.UTF8.GetBytes(message);

        channel.BasicPublish(exchange: "topicdemo.exchange",
                             routingKey: routekey,
                             basicProperties: null,
                             body: body);
        Console.WriteLine(" 傳送訊息 {0} Routekey {1}", message, routekey);
        message = Console.ReadLine();
    }
}

Console.WriteLine("按回車退出");
Console.ReadLine();

Topic模式接收：

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


var factory = new ConnectionFactory()
{
    HostName = "127.0.0.1",
    UserName = "admin",
    Password = "admin",
    VirtualHost = "my_vhost"
};
using (var connection = factory.CreateConnection())
using (var channel = connection.CreateModel())
{

    channel.ExchangeDeclare(exchange: "topicdemo.exchange",
type: ExchangeType.Topic, durable: true);

    channel.QueueDeclare(queue: "topic_que",
                         durable: true,
                         exclusive: false,
                         autoDelete: false,
                         arguments: null);
    channel.QueueBind(queue: "topic_que", exchange: "topicdemo.exchange",
routingKey: "#.log");
    var consumer = new EventingBasicConsumer(channel);
    consumer.Received += (model, ea) =>
    {
        var body = ea.Body;
        var message = Encoding.UTF8.GetString(body.ToArray());
        Console.WriteLine("收到訊息 {0}", message);
    };
    channel.BasicConsume(queue: "topic_que",
                         autoAck: true,
                         consumer: consumer);

    Console.WriteLine(" 按回車退出");
    Console.ReadLine();
}

我們設定的RouteKey是"#.log"，也就是匹配這個表示式的RouteKey的訊息會被接收到：

到這裡RabbitMQ常用的幾種模式都介紹了，最後說一點程式碼中的細節，在傳送方和接收方程式碼中，有重複的queue或者exchange宣告，比如:

    channel.QueueDeclare(queue: "mymessage",
                                  durable: false,
                                  exclusive: false,
                                  autoDelete: false,
                                  arguments: null);

這些程式碼讓人感到有些困惑，似乎每次都需要宣告，而實際上是隻要存在相關的queue或者exchange，這些程式碼就不再起作用。之所以在傳送方和接收方都包含這些程式碼，是因為不知道是否存在相關的queue或exchange,也不知道誰先啟動，避免出錯。如果在RabbitMQ的Web管理頁面預先手工建立了相應的queue或者exchange，這些程式碼是可以去掉的。

本文程式碼可以從github下載：https://github.com/zhenl/ZL.RabbitMQ.Demo

C#使用RabbitMq佇列(Sample,Work,Fanout,Direct等模式的簡單使用)
2020-10-16
C#MQ佇列模式
RabbitMQ學習之（一）_初步瞭解RabbitMQ、RabbitMQ的使用流程、為什麼要使用RabbitMQ、RabbitMQ的應用場景
2018-01-08
MQ
RabbitMQ學習系列二：.net 環境下 C#程式碼使用 RabbitMQ 訊息佇列
2019-05-11
MQC#佇列
快速掌握RabbitMQ(一)——RabbitMQ的基本概念、安裝和C#驅動
2019-05-23
MQC#
搭建高可用的rabbitmq叢集 + Mirror Queue + 使用C#驅動連線
2016-11-29
MQC#
RabbitMQ的安裝使用
2016-12-16
MQ
[譯]RabbitMQ教程C#版 - 主題
2021-09-09
MQC#
Go Rabbitmq 使用
2020-01-19
GoMQ
RabbitMQ基本使用
2021-04-09
MQ
laravel rabbitmq 使用
2021-05-15
LaravelMQ
RabbitMQ的詳解和使用
2024-06-02
MQ
在C#中使用RabbitMQ做個簡單的傳送郵件小專案
2024-07-02
C#MQ
C#中的訊息中介軟體(RabbitMQ 和 Redis)
2024-04-01
C#MQRedis
RabbitMQ系列（五）使用Docker部署RabbitMQ叢集
2018-07-24
MQDocker
RabbitMQ 使用場景
2021-05-21
MQ
.net core使用RabbitMQ
2024-03-12
MQ
flutter中使用rabbitmq
2024-07-27
FlutterMQ
RabbitMQ和Elasticsearch的使用筆記
2021-08-23
MQElasticsearch筆記
RabbitMQ延時佇列的使用
2020-11-05
MQ佇列
RabbitMQ的使用--以topic路由為例
2024-06-27
MQ路由
.Net使用RabbitMQ詳解
2016-03-21
MQ
.Net Core中使用RabbitMQ
2024-05-08
MQ
RabbitMQ .NET訊息佇列使用入門(五)【RabbitMQ例子】
2018-07-24
MQ佇列
使用docker 搭建rabbitmq 叢集
2019-04-19
DockerMQ
瞭解何時使用RabbitMQ
2018-09-19
MQ
lumen 8.0 使用 rabbitmq 佇列
2020-10-26
MQ佇列
RabbitMQ+haProxy+keepalived使用
2020-09-01
MQ
輕鬆使用Aspire rabbitmq framework
2024-05-01
MQFramework
RabbitMQ 新增新使用者
2024-07-17
MQ
RabbitMQ系列（二）深入瞭解RabbitMQ工作原理及簡單使用
2018-07-06
MQ
RabbitMQ使用教程（二）RabbitMQ使用者管理,角色管理及許可權設定
2019-05-24
MQ
RabbitMQ學習系列三：.net 環境下 C#程式碼訂閱 RabbitMQ 訊息並處理
2019-05-11
MQC#
C# ExpandoObject的使用
2019-01-02
C#Object
關於 RabbitMQ 的安裝與簡單使用
2020-05-30
MQ
訊息佇列的使用場景之RabbitMQ
2021-12-11
佇列MQ
RabbitMQ（四）：使用Docker構建RabbitMQ高可用負載均衡叢集
2019-08-03
MQDocker負載
RabbitMQ使用教程（一）RabbitMQ環境安裝配置及Hello World示例
2019-05-23
MQ
RabbitMQ .NET訊息佇列使用入門(四)【RabbitMQ用法大全】
2018-07-21
MQ佇列