跳至主要内容

RabbitMQ 教程 - 发布/订阅

发布/订阅

(使用 Objective-C 客户端)

信息

先决条件

本教程假设 RabbitMQ 已 安装 并在 localhost 上运行,位于 标准端口 (5672)。如果你使用的是不同的主机、端口或凭据,则连接设置需要调整。

寻求帮助

如果你在学习本教程时遇到问题,可以通过 GitHub 讨论RabbitMQ 社区 Discord 与我们联系。

上一教程 中,我们创建了一个工作队列。工作队列背后的假设是每个任务只交付给一个工作者。在本节中,我们将做一些完全不同的事情——我们将向多个消费者传递消息。这种模式被称为“发布/订阅”。

为了说明这种模式,我们将构建一个简单的日志系统。它将包含两个程序——第一个将发出日志消息,第二个将接收并打印这些消息。

在我们的日志系统中,接收器的每个运行副本都将获得这些消息。这样,我们就可以运行一个接收器并将日志定向到磁盘;同时,我们也可以运行另一个接收器,并在屏幕上查看日志。

从本质上讲,发布的日志消息将被广播到所有接收器。

交换机

在教程的前几部分中,我们向队列发送和接收消息。现在是时候介绍 Rabbit 中的完整消息传递模型了。

让我们快速回顾一下我们在上一教程中介绍的内容

  • 生产者是发送消息的用户应用程序。
  • 队列是一个缓冲区,用于存储消息。
  • 消费者是接收消息的用户应用程序。

RabbitMQ 中消息传递模型的核心思想是生产者绝不会直接向队列发送消息。实际上,生产者通常甚至不知道是否会将消息传递到任何队列。

相反,生产者只能将消息发送到交换机。交换机是一个非常简单的东西。一方面,它接收来自生产者的消息;另一方面,它将消息推送到队列。交换机必须准确地知道如何处理它收到的消息。它应该被附加到特定的队列吗?它应该被附加到多个队列吗?还是应该被丢弃?这些规则由交换机类型定义。

有几种可用的交换机类型:directtopicheadersfanout。我们将重点介绍最后一种类型——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]];

临时队列

你可能还记得,之前我们使用的是具有特定名称的队列(记住 hellotask_queue?)。能够为队列命名对我们来说至关重要——我们需要将工作者指向同一个队列。当你想要在生产者和消费者之间共享队列时,为队列命名很重要。

但我们的日志记录程序并非如此。我们希望了解所有日志消息,而不仅仅是其中的子集。我们也只对当前正在流动的消息感兴趣,而不是旧的消息。为了解决这个问题,我们需要两件事。

首先,无论何时我们连接到 Rabbit,我们都需要一个新的、空的队列。为此,我们可以创建一个具有随机名称的队列,或者,更好的方法是让库为我们选择一个随机的队列名称(其他客户端将这项工作留给服务器,但由于 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

© 2024 RabbitMQ. All rights reserved.