跳至主要内容

RabbitMQ 教程 - 发布/订阅

发布/订阅

(使用 Bunny 客户端)

信息

先决条件

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

在哪里寻求帮助

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

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

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

在我们的日志系统中,运行的每个接收程序副本都会收到消息。这样,我们就可以运行一个接收程序并将日志发送到磁盘;同时,我们还可以运行另一个接收程序,并在屏幕上查看日志。

本质上,发布的日志消息将广播到所有接收程序。

交换机

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

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

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

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

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

有几种可用的交换机类型:directtopicheadersfanout。我们将重点关注最后一种 - fanout。让我们创建一个这种类型的交换机,并将其命名为 logs

channel.fanout('logs')

fanout 交换机非常简单。正如你可能从它的名字中猜到的那样,它只是将它接收到的所有消息广播到它知道的每个队列。这正是我们的日志记录器所需要的。

列出交换机

要列出服务器上的交换机,你可以运行非常有用的 rabbitmqctl

sudo rabbitmqctl list_exchanges

在这个列表中,将有一些 amq.* 交换机和默认的(未命名)交换机。这些是默认创建的,但你目前不太可能需要使用它们。

默认交换机

在教程的先前部分,我们对交换机一无所知,但仍然能够向队列发送消息。这是因为我们使用了一个默认的交换机,我们通过空字符串 ("") 来识别它。

回想一下我们之前是如何发布消息的

channel.default_exchange.publish('hello', routing_key: 'hello')

在这里,我们使用了默认的或无名 交换机:消息被路由到与 :routing_key 指定的名称匹配的队列(如果存在)。

现在,我们可以改为发布到我们命名的交换机

exchange = channel.fanout('logs')
exchange.publish(message)

临时队列

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

但我们的日志记录器并非如此。我们想要了解所有日志消息,而不仅仅是其中的一部分。我们也只对当前流入的消息感兴趣,而不是旧的消息。为了解决这个问题,我们需要两件事。

首先,每次我们连接到 Rabbit 时,都需要一个新的空队列。为了实现这一点,我们可以创建一个具有随机名称的队列,或者,更重要的是,让服务器为我们选择一个随机的队列名称。

其次,一旦我们断开消费者的连接,队列应该被自动删除。

Bunny 客户端中,当我们将队列名称提供为空字符串时,我们将创建一个具有生成名称的非持久队列

queue = channel.queue('', exclusive: true)

当方法返回时,队列实例将包含由 RabbitMQ 生成的随机队列名称。例如,它可能看起来像 amq.gen-JzTY20BRgKO-HjmUJj0wLg

当声明该队列的连接关闭时,队列将被删除,因为它被声明为独占的。你可以在 队列指南 中了解更多关于 exclusive 标志和其他队列属性的信息。

绑定

我们已经创建了一个 fanout 交换机和一个队列。现在,我们需要告诉交换机将消息发送到我们的队列。交换机和队列之间的这种关系称为绑定

queue.bind('logs')

从现在开始,logs 交换机将把消息追加到我们的队列中。

列出绑定

你可以使用以下命令列出现有绑定,你猜对了,

rabbitmqctl list_bindings

将所有内容整合在一起

生产者程序(发出日志消息)与之前的教程并没有太大区别。最重要的变化是我们现在希望将消息发布到我们的 logs 交换机,而不是无名的交换机。以下是 emit_log.rb 脚本的代码

#!/usr/bin/env ruby
require 'bunny'

connection = Bunny.new
connection.start

channel = connection.create_channel
exchange = channel.fanout('logs')

message = ARGV.empty? ? 'Hello World!' : ARGV.join(' ')

exchange.publish(message)
puts " [x] Sent #{message}"

connection.close

(emit_log.rb 源代码)

如你所见,在建立连接后,我们声明了交换机。此步骤是必要的,因为发布到不存在的交换机是禁止的。

如果还没有将任何队列绑定到交换机,则消息将丢失,但这对我们来说是可以的;如果还没有消费者在监听,我们可以安全地丢弃消息。

receive_logs.rb 的代码

#!/usr/bin/env ruby
require 'bunny'

connection = Bunny.new
connection.start

channel = connection.create_channel
exchange = channel.fanout('logs')
queue = channel.queue('', exclusive: true)

queue.bind(exchange)

puts ' [*] Waiting for logs. To exit press CTRL+C'

begin
queue.subscribe(block: true) do |_delivery_info, _properties, body|
puts " [x] #{body}"
end
rescue Interrupt => _
channel.close
connection.close
end

(receive_logs.rb 源代码)

如果你想将日志保存到文件,只需打开一个控制台并键入

ruby receive_logs.rb > logs_from_rabbit.log

如果你希望在屏幕上查看日志,请启动一个新的终端并运行

ruby receive_logs.rb

当然,要发出日志,请键入

ruby emit_log.rb

使用 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.