0、引言
先决条件
本教程假设 RabbitMQ 已安装并且正在
本地主机
的标准端口(5672
)上运行。如果您使用了不同的主机、端口或凭证,则要求调整连接设置。获取帮助
如果您在阅读本教程时遇到问题,可以通过邮件列表或者 RabbitMQ 社区 Slack 与 RabbitMQ 官方取得联系。
在上一篇教程中我们改进了日志系统。我们没有使用只能进行虚拟广播的 fanout
交换机,而是使用了 direct
直连交换机,从而获得了选择性接收日志的可能性。
尽管使用了 direct
直连交换机改进了我们的系统,但它仍然有局限性 ------ 它不能基于多个标准进行路由。
在我们的日志系统中,我们可能不仅希望订阅根据严重程度区分的日志,还希望订阅根据来源区分的日志。您可能从 syslog
unix 工具中了解过这个概念,它根据严重程度(info/warn/crit...)和设备(auth/cron/kern...)路由日志。
这可以给我们很大的灵活性 ------ 我们也许希望仅了解来自于 'corn' 的关键错误,但同样也希望了解来自于 'kern' 的所有日志。
为了在我们的日志系统中实现这一点,我们需要学习一种更复杂的 topic
主题交换机。
原文链接:https://www.rabbitmq.com/tutorials/tutorial-five-dotnet.html
1、主题交换机
发送给 topic
主题交换机的消息不能有任意的路由键 ------ 它只能是一个由点分隔的单词列表。单词可以是任何东西,但通常它们指定与消息相关的一些特征。下面是一些有效的路由键示例:"stock.usd.nyse
"、"nyse.vmw
"、"quick.orange.rabbit
"。路由键中可以有任意多的单词,最多不超过 255 字节。
绑定键也必须是同样的形式。topic
主题交换机背后的逻辑与 direct
直连交换机类似 ------ 使用特定 routing key
路由键发送的消息将被传递给使用匹配 binding key
绑定键绑定的所有队列。但是,绑定键有两种重要的特殊情况:
*
(星号)只能匹配一个单词。#
(井号)可以匹配零或者多个单词。
用一个例子来解释这一点最简单:
在这个例子当中,我们将会发送一些均用来描述动物的消息。我们将会使用包含三个单词(两个点)的 routing key
路由键发送这些消息。路由键中的第一个单词用于描述速度,第二个描述颜色以及第三个描述物种:"<speed>.<colour>.<species>
"。
我们创建三个绑定:Q1
使用 "*.orange.*
" 绑定键绑定;Q2
使用 "*.*.rabbit
" 和 "lazy.#
" 绑定。
这些绑定可以被总结为:
Q1
对所有的橙色动物感兴趣。Q2
想知道关于兔子以及懒惰动物的一切信息。
- 带有 "
quick.orange.rabbit
" 路由键的消息将被同时传递给两个队列。"lazy.orange.elephant
" 消息同样也会同时前往两个队列。- 另一方面,"
quick.orange.fox
" 只会前往Q1
,而 "lazy.brown.fox
" 只会前往Q2
。- "
lazy.pink.rabbit
" 只会被传递给Q2
一次,即便它与两个绑定匹配。- "
quick.brown.fox
" 不匹配任何绑定,因此将被丢弃。
如果我们违反约定,发送带有一个或者四个单词的消息(比如 "orange
" 或者 "quick.orange.new.rabbit
"),会发生什么呢?好吧,这些消息将不会匹配任何绑定并且丢失。
另一方面,即便 "lazy.orange.new.rabbit
" 有四个单词,但仍然匹配最后一个绑定,所以将会被传递给 Q2
队列。
主题交换机
主题交换机十分强大并且能够模拟其他交换机。
当一个队列使用 "
#
"(井号)绑定键绑定时 ------ 它将会忽略路由键接收所有消息 ------ 就像fanout
扇出交换机那样。当绑定中不使用 "
*
"(星号)与 "#
"(井号)特殊字符时,topic
主题交换机将会表现得像是direct
直连交换机。
2、将所有的东西放到一起
我们将在日志系统中使用 topic
主题交换机。我们将从一个工作假设开始:即日志的路由键将有两个单词:"<facility>.<severity>
"。
代码几乎与上一篇教程中一致。
EmitLogTopic.cs
的代码:
csharp
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: "topic_logs", type: ExchangeType.Topic);
var routingKey = (args.Length > 0) ? args[0] : "anonymous.info";
var message = (args.Length > 1)
? string.Join(" ", args.Skip(1).ToArray())
: "Hello World!";
var body = Encoding.UTF8.GetBytes(message);
channel.BasicPublish(exchange: "topic_logs",
routingKey: routingKey,
basicProperties: null,
body: body);
Console.WriteLine($" [x] Sent '{routingKey}':'{message}'");
ReceiveLogsTopic.cs
的代码:
csharp
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: "topic_logs", type: ExchangeType.Topic);
// declare a server-named queue
var queueName = channel.QueueDeclare().QueueName;
if (args.Length < 1)
{
Console.Error.WriteLine("Usage: {0} [binding_key...]",
Environment.GetCommandLineArgs()[0]);
Console.WriteLine(" Press [enter] to exit.");
Console.ReadLine();
Environment.ExitCode = 1;
return;
}
foreach (var bindingKey in args)
{
channel.QueueBind(queue: queueName,
exchange: "topic_logs",
routingKey: bindingKey);
}
Console.WriteLine(" [*] Waiting for messages. To exit press CTRL+C");
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();
运行如下示例:
接收所有日志:
shell
cd ReceiveLogsTopic
dotnet run "#"
接收来自 "kern
" 的所有日志:
shell
cd ReceiveLogsTopic
dotnet run "kern.*"
或者您只想知道 "critical
" 日志:
shell
cd ReceiveLogsTopic
dotnet run "*.critical"
您可以创建多个绑定:
shell
cd ReceiveLogsTopic
dotnet run "kern.*" "*.critical"
并发出带有 "kern.critical
" 类型路由键的日志:
shell
cd EmitLogTopic
dotnet run "kern.critical" "A critical kernel error"
运行效果:
😀 玩儿的开心!注意,代码没有对路由键或者绑定键做任何假设,您可能希望试试使用两个以上的路由键参数。
(EmitLogTopic.cs 和 ReceiveLogsTopic.cs 的完整源码)
接下来,在教程六中了解如何将往返消息作为远程过程调用。
5、生产[非]适用性免责声明
请记住,本教程和其他教程都是教程。他们一次展示一个新概念,可能会有意地过度简化一些东西,而忽略其他东西。例如,为了简洁起见,连接管理、错误处理、连接恢复、并发性和指标收集等主题在很大程度上被省略了。这种简化的代码不应该被认为可以用于生产。
在发布您的应用之前,请先查看其他文档。我们特别推荐以下指南:发布者确认和消费者确认,生产清单和监控。