RabbitMQ 教程 - 发布/订阅
发布/订阅
(使用 Objective-C 客户端)
先决条件
本教程假设 RabbitMQ 已 安装 并在 localhost 上的 标准端口 (5672) 上运行。如果您使用不同的主机、端口或凭据,则需要调整连接设置。
哪里寻求帮助
如果您在学习本教程时遇到困难,可以通过 GitHub Discussions 或 RabbitMQ 社区 Discord 联系我们。
在上一篇教程中,我们创建了一个工作队列。工作队列背后的假设是,每个任务都只会被传递给一个工作者。在这部分,我们将要做一些完全不同的事情——我们将一条消息传递给多个消费者。这种模式被称为“发布/订阅”。
为了说明这种模式,我们将构建一个简单的日志系统。它将包含两个程序——第一个程序将发出日志消息,第二个程序将接收并打印它们。
在我们的日志系统中,每个正在运行的接收器副本都会收到消息。这样,我们就可以运行一个接收器并将日志记录到磁盘;同时,我们还可以运行另一个接收器并在屏幕上显示日志。
本质上,发布的日志消息将被广播给所有接收者。
交换器
在之前的教程中,我们向队列发送消息并从队列接收消息。现在是时候在 RabbitMQ 中引入完整的消息模型了。
让我们快速回顾一下之前的内容
- 生产者 是发送消息的用户应用程序。
- 队列 是存储消息的缓冲区。
- 消费者 是接收消息的用户应用程序。
RabbitMQ 消息模型的核心思想是生产者从不直接将任何消息发送到队列。实际上,生产者往往甚至不知道消息是否会被传递到任何队列。
相反,生产者只能将消息发送到交换器。交换器是一个非常简单的东西。一方面,它接收来自生产者的消息;另一方面,它将消息推送到队列。交换器必须确切地知道如何处理它收到的消息。应该将其附加到特定队列吗?应该将其附加到多个队列吗?还是应该将其丢弃?这些规则由交换器类型定义。
有几种可用的交换器类型:direct、topic、headers 和 fanout。我们将重点关注最后一种——fanout。让我们创建一个此类型的交换器,并将其命名为 logs。
[ch fanout:@"logs"];
fanout 交换器非常简单。顾名思义,它只是将收到的所有消息广播到它知道的所有队列。这正是我们日志记录器所需要的。
列出交换器
要列出服务器上的交换器,可以使用一直很有用的
rabbitmqctl。sudo rabbitmqctl list_exchanges在此列表中,将有一些
amq.*交换器以及默认(未命名)交换器。这些是默认创建的,但目前不太可能需要使用它们。
默认交换器
在教程的先前部分,我们对交换机一无所知,但仍然能够将消息发送到队列。这是可能的,因为我们使用的是一个默认交换机,它由空字符串 (
"") 标识。回想一下我们之前是如何发布消息的
[ch.defaultExchange publish:@"hello" routingKey:@"hello" persistent:YES];这里我们使用默认的或无名的交换机:如果队列存在,消息将被路由到由
routingKey指定名称的队列。
现在,我们可以改为发布到我们的命名交换器
RMQExchange *x = [ch fanout:@"logs"];
[x publish:[msg dataUsingEncoding:NSUTF8StringEncoding]];
临时队列
您可能还记得,之前我们使用了具有特定名称的队列(还记得 hello 和 task_queue 吗?)。能够命名队列对我们至关重要——我们需要将工作者指向同一个队列。给队列命名对于我们希望在生产者和消费者之间共享队列非常重要。
但我们的日志记录器不是这种情况。我们想了解所有日志消息,而不仅仅是其中的一部分。我们只对当前正在流动的消息感兴趣,而不是旧消息。要解决这个问题,我们需要两件事。
首先,每当我们连接到 RabbitMQ 时,都需要一个新的、空的队列。为此,我们可以创建一个带有随机名称的队列,或者,更好的是——让库为我们选择一个随机队列名称(其他客户端将这项工作留给服务器,但由于 Objective-C 客户端的设计是为了避免阻塞调用线程,它更喜欢生成自己的名称)。
其次,一旦我们断开消费者连接,队列应被自动删除。
在 Objective-C 客户端中,当我们提供空字符串作为队列名称时,我们会创建一个具有生成名称的非持久化队列。
RMQQueue *q = [ch queue:@"" options:RMQQueueDeclareExclusive];
当方法返回时,队列实例将包含由库生成的随机队列名称。例如,它可能看起来像 rmq-objc-client.gen-049F8D0B-F330-4D65-9277-0F418F529A93-41604-000030FB39652E07。
当声明该队列的连接关闭时,该队列将被删除,因为它被声明为独占的。您可以在队列指南中了解有关 exclusive 标志和其他队列属性的更多信息。
绑定
我们已经创建了一个 fanout 交换器和一个队列。现在我们需要告诉交换器将消息发送到我们的队列。交换器和队列之间的这种关系称为绑定。
[q bind:x];
从现在开始,logs 交换器将把消息附加到我们的队列。
列出绑定
你可以使用你猜到的命令
rabbitmqctl list_bindings来列出存在的绑定。
总而言之
生产者方法,用于发出日志消息,与上一篇教程相比并没有太大变化。最重要的改变是我们现在希望将消息发布到我们的 logs 交换机,而不是无名交换机。以下是 emitLog 的代码。
RMQConnection *conn = [[RMQConnection alloc] initWithDelegate:[RMQConnectionDelegateLogger new]];
[conn start];
id<RMQChannel> ch = [conn createChannel];
RMQExchange *x = [ch fanout:@"logs"];
NSString *msg = @"Hello World!";
[x publish:[msg dataUsingEncoding:NSUTF8StringEncoding]];
NSLog(@"Sent %@", msg);
[conn close];
如您所见,建立连接后,我们声明了交换器。此步骤是必要的,因为禁止发布到不存在的交换器。
如果尚未将任何队列绑定到交换器,消息将丢失,但这对我们来说没关系;如果没有消费者在监听,我们可以安全地丢弃该消息。
receiveLogs 的代码。
RMQConnection *conn = [[RMQConnection alloc] initWithDelegate:[RMQConnectionDelegateLogger new]];
[conn start];
id<RMQChannel> ch = [conn createChannel];
RMQExchange *x = [ch fanout:@"logs"];
RMQQueue *q = [ch queue:@"" options:RMQQueueDeclareExclusive];
[q bind:x];
NSLog(@"Waiting for logs.");
[q subscribe:^(RMQMessage * _Nonnull message) {
NSLog(@"Received %@", [[NSString alloc] initWithData:message.body encoding:NSUTF8StringEncoding]);
}];
使用 rabbitmqctl list_bindings,你可以验证代码确实按照我们的意愿创建了绑定和队列。运行两个 receive_logs.rb 程序后,你应该会看到类似这样的输出:
sudo rabbitmqctl list_bindings
# => Listing bindings ...
# => logs exchange amq.gen-JzTY20BRgKO-HjmUJj0wLg queue []
# => logs exchange amq.gen-vso0PVvyiRIL2WoV3i48Yg queue []
# => ...done.
结果的解释很简单:来自 logs 交换机的数据被发送到两个具有生成名称的队列。这正是我们想要的。
要了解如何监听消息的子集,让我们继续学习 教程 4。