(四)「消息队列」之 RabbitMQ 路由(使用 .NET 客户端)

0、引言

先决条件

本教程假设 RabbitMQ 已安装并且正在 本地主机 的标准端口(5672)上运行。如果您使用了不同的主机、端口或凭证,则要求调整连接设置。

获取帮助

如果您在阅读本教程时遇到问题,可以通过邮件列表或者 RabbitMQ 社区 Slack 与 RabbitMQ 官方取得联系。

在上一篇教程中我们构建了一个简单的日志系统,得以向许多接收者(receiver)广播日志消息。

在本教程中我们将会为该系统添加一个特性 —— 我们将使“仅订阅消息的一个子集”成为可能。例如,我们将能够只将关键错误消息定向到日志文件(以节省磁盘空间),与此同时仍然能够在控制台上打印所有的日志消息。

原文链接:https://www.rabbitmq.com/tutorials/tutorial-four-dotnet.html

1、绑定

在上一篇例程中我们已经建立过绑定了。您也许能够回想起,代码类似于:

channel.QueueBind(queue: queueName,
                  exchange: "logs",
                  routingKey: string.Empty);

绑定 即表征 交换机队列 之间的关系。这可以简单地理解为:队列对来自此交换机的消息感兴趣。

绑定可以接收一个额外的 routingKey (路由键)参数。为了避免与 BasicPublish 方法的一个参数混淆,我们现在将其称之为 binding key (绑定键)。下面演示了我们如何创建一个带有键的绑定:

channel.QueueBind(queue: queueName,
                  exchange:"direct_logs",
                  routingKey: "black");

binding key 的含义取决于交换机的类型。比如我们之前使用的 fanout 交换机会简单地忽略它的值。

2、直连交换机(Direct exchange)

在上一篇教程中,我们的日志系统向所有的消费者广播所有消息。我们希望对其进行拓展,以允许根据消息的严重程度过滤消息。比如,我们也许想要向磁盘写入日志消息的脚本文件只接收关键错误,而不是在警告或者信息日志消息上浪费磁盘空间。

但我们在上一篇教程使用的 fanout 扇出交换机并没有给我们如此大的灵活性 —— 它只能够进行无意识的广播。

相反,我们将会使用一个 direct 直连交换机。其背后的路由算法很简单 —— 将消息路由到其 routing key 与队列的 binding key 完全匹配的队列。

为了说明这一点,请考虑如下配置:

(四)「消息队列」之 RabbitMQ 路由(使用 .NET 客户端)_第1张图片

在这个配置中,我们可以看到绑定了两个队列的 direct 直连交换机 X。第一个队列使用 orange 绑定键绑定;而第二个队列拥有两个绑定,一个绑定键为 black,另一个绑定键为 green

在这样的配置下,被发布到交换机中带有 orange 路由键的消息将会被路由到 Q1 队列。而带有 black 或者 green 路由键的消息将会去往 Q2 队列。其他所有消息将会被丢弃。

3、多个绑定

direct-exchange-multiple

使用相同的绑定键绑定多个队列是完全合法的。在我们的示例中,我们可以使用 black 绑定键在 XQ1 之间添加绑定。在那样的情况下,direct 直连交换机表现得像是 fanout 扇出交换机:向所有匹配的队列广播消息。带有 black 路由键的消息将同时传递给 Q1Q2 双方。

4、发送日志

我们将在日志系统中使用这个模型,我们将消息发送至 direct 直连交换机而不是 fanout 扇出交换机。我们提供日志严重程序作为 routing key 路由键。这样接收脚本就能够选择其想要接收的严重程度。让我们首先关注发送日志:

如常,首先我们需要创建一个交换机:

channel.ExchangeDeclare(exchange: "direct_logs", type: ExchangeType.Direct);

我们已经准备好发送一条消息:

var body = Encoding.UTF8.GetBytes(message);
channel.BasicPublish(exchange: "direct_logs",
                     routingKey: severity,
                     basicProperties: null,
                     body: body);

为了简化问题我们假定 ‘严重程度’ 可以是 infowarningerror 中的一个。

5、订阅

接收消息的方式工作与上一篇教程类似,但有一点例外 —— 我们将会为我们感兴趣的每个 ‘严重程度’ 创建新的绑定。

var queueName = channel.QueueDeclare().QueueName;

foreach(var severity in args)
{
    channel.QueueBind(queue: queueName,
                      exchange: "direct_logs",
                      routingKey: severity);
}

6、将所有的东西放到一起

tutorial-four

EmitLogDirect.cs 类的代码:

using System.Text;
using RabbitMQ.Client;

var factory = new ConnectionFactory { HostName = "localhost" };
using var connection = factory.CreateConnection();
using var channel = connection.CreateModel();

channel.ExchangeDeclare(exchange: "direct_logs", type: ExchangeType.Direct);

var severity = (args.Length > 0) ? args[0] : "info";
var message = (args.Length > 1)
              ? string.Join(" ", args.Skip(1).ToArray())
              : "Hello World!";
var body = Encoding.UTF8.GetBytes(message);
channel.BasicPublish(exchange: "direct_logs",
                     routingKey: severity,
                     basicProperties: null,
                     body: body);
Console.WriteLine($" [x] Sent '{severity}':'{message}'");

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

ReceiveLogsDirect.cs 的代码:

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

var factory = new ConnectionFactory { HostName = "localhost" };

using var connection = factory.CreateConnection();
using var channel = connection.CreateModel();

channel.ExchangeDeclare(exchange: "direct_logs", type: ExchangeType.Direct);
// declare a server-named queue
var queueName = channel.QueueDeclare().QueueName;

if (args.Length < 1)
{
    Console.Error.WriteLine("Usage: {0} [info] [warning] [error]",
                            Environment.GetCommandLineArgs()[0]);
    Console.WriteLine(" Press [enter] to exit.");
    Console.ReadLine();
    Environment.ExitCode = 1;
    return;
}

foreach (var severity in args)
{
    channel.QueueBind(queue: queueName,
                      exchange: "direct_logs",
                      routingKey: severity);
}

Console.WriteLine(" [*] Waiting for messages.");

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

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

像往常一样创建项目(建议参考教程一)

如果您只想要保存 warningerror(没有 info)日志消息到文件中,只需要打开一个控制台并输入:

cd ReceiveLogsDirect
dotnet run warning error > logs_from_rabbit.log

如果您想要在屏幕上看见所有的日志消息,打开一个新的终端并尝试:

cd ReceiveLogsDirect
dotnet run info warning error
# => [*] Waiting for logs. To exit press CTRL+C

例如,要发送一个 error 日志消息,只需要输入:

cd EmitLogDirect
dotnet run error "Run. Run. Or it will explode."
# => [x] Sent 'error':'Run. Run. Or it will explode.'

(EmitLogDirect.cs 和 ReceiveLogsDirect.cs 的完整源码)

运行效果:

要了解如何基于特定模式侦听消息,请移步至教程五。

5、生产[非]适用性免责声明

请记住,本教程和其他教程都是教程。他们一次展示一个新概念,可能会有意地过度简化一些东西,而忽略其他东西。例如,为了简洁起见,连接管理、错误处理、连接恢复、并发性和指标收集等主题在很大程度上被省略了。这种简化的代码不应该被认为可以用于生产。

在发布您的应用之前,请先查看其他文档。我们特别推荐以下指南:发布者确认和消费者确认,生产清单和监控。

你可能感兴趣的:(消息队列(MQ),rabbitmq,分布式,.net,c#)