RabbitMQ 教程 - 主题
主题
(使用 amqp Elixir 库)
前提条件
本教程假设您已安装 RabbitMQ 并在 localhost
上标准端口 (5672) 上运行。如果您使用不同的主机、端口或凭据,则需要调整连接设置。
在哪里获得帮助
如果您在学习本教程时遇到问题,可以通过 GitHub Discussions 或 RabbitMQ 社区 Discord 联系我们。
在上一个教程中,我们改进了日志系统。我们没有使用只能进行虚拟广播的 fanout
交换机,而是使用了 direct
交换机,并获得了选择性接收日志的可能性。
虽然使用 direct
交换机改进了我们的系统,但它仍然存在局限性 - 它无法根据多个标准进行路由。
在我们的日志系统中,我们可能希望不仅根据严重性订阅日志,还希望根据发出日志的来源订阅日志。您可能从 syslog
unix 工具中了解了这个概念,该工具根据严重性(info/warn/crit...)和设施(auth/cron/kern...)路由日志。
这将为我们提供很大的灵活性 - 我们可能只想监听来自“cron”的严重错误,但也想监听来自“kern”的所有日志。
为了在我们的日志系统中实现这一点,我们需要了解更复杂的 topic
交换机。
主题交换机
发送到 topic
交换机的消息不能具有任意的 routing_key
- 它必须是由点分隔的单词列表。单词可以是任何内容,但通常它们指定与消息相关联的某些特征。一些有效的路由键示例:stock.usd.nyse
、nyse.vmw
、quick.orange.rabbit
。路由键中可以包含任意数量的单词,最多 255 字节。
绑定键也必须采用相同的形式。topic
交换机背后的逻辑与 direct
交换机类似 - 使用特定路由键发送的消息将被传递到所有使用匹配绑定键绑定的队列。但是,绑定键有两种重要的特殊情况
*
(星号)可以代替正好一个单词。#
(井号)可以代替零个或多个单词。
通过一个例子最容易解释这一点
在这个例子中,我们将发送所有描述动物的消息。这些消息将使用包含三个单词(两个点)的路由键发送。路由键中的第一个单词将描述速度,第二个单词描述颜色,第三个单词描述物种:<速度>.<颜色>.<物种>
。
我们创建了三个绑定:Q1 绑定了绑定键 *.orange.*
,Q2 绑定了 *.*.rabbit
和 lazy.#
。
这些绑定可以总结为
- Q1 对所有橙色动物感兴趣。
- Q2 想听到关于兔子的一切,以及关于懒惰动物的一切。
路由键设置为 quick.orange.rabbit
的消息将传递到两个队列。消息 lazy.orange.elephant
也将发送到这两个队列。另一方面,quick.orange.fox
将仅发送到第一个队列,而 lazy.brown.fox
仅发送到第二个队列。lazy.pink.rabbit
将仅传递到第二个队列一次,即使它匹配两个绑定。quick.brown.fox
不匹配任何绑定,因此将被丢弃。
如果我们违反约定并发送一个或四个单词的消息,例如 orange
或 quick.orange.new.rabbit
会发生什么?好吧,这些消息将不匹配任何绑定,并将丢失。
另一方面,lazy.orange.new.rabbit
,即使它有四个单词,也将匹配最后一个绑定并将传递到第二个队列。
主题交换机
主题交换机功能强大,可以像其他交换机一样工作。
当队列绑定了
#
(井号)绑定键时 - 它将接收所有消息,而不管路由键如何 - 就像fanout
交换机一样。当绑定中未使用特殊字符
*
(星号)和#
(井号)时,主题交换机的行为将就像direct
交换机一样。
将它们放在一起
我们将在日志系统中使用 topic
交换机。我们将从一个工作假设开始,即日志的路由键将有两个单词:<设施>.<严重性>
。
代码几乎与上一个教程中的代码相同。
emit_log_topic.exs
的代码
{:ok, connection} = AMQP.Connection.open
{:ok, channel} = AMQP.Channel.open(connection)
{topic, message} =
System.argv
|> case do
[] -> {"anonymous.info", "Hello World!"}
[message] -> {"anonymous.info", message}
[topic|words] -> {topic, Enum.join(words, " ")}
end
AMQP.Exchange.declare(channel, "topic_logs", :topic)
AMQP.Basic.publish(channel, "topic_logs", topic, message)
IO.puts " [x] Sent '[#{topic}] #{message}'"
AMQP.Connection.close(connection)
receive_logs_topic.exs
的代码
defmodule ReceiveLogsTopic do
def wait_for_messages(channel) do
receive do
{:basic_deliver, payload, meta} ->
IO.puts " [x] Received [#{meta.routing_key}] #{payload}"
wait_for_messages(channel)
end
end
end
{:ok, connection} = AMQP.Connection.open
{:ok, channel} = AMQP.Channel.open(connection)
AMQP.Exchange.declare(channel, "topic_logs", :topic)
{:ok, %{queue: queue_name}} = AMQP.Queue.declare(channel, "", exclusive: true)
if length(System.argv) == 0 do
IO.puts "Usage: mix run receive_logs_topic.exs [binding_key]..."
System.halt(1)
end
for binding_key <- System.argv do
AMQP.Queue.bind(channel, queue_name, "topic_logs", routing_key: binding_key)
end
AMQP.Basic.consume(channel, queue_name, nil, no_ack: true)
IO.puts " [*] Waiting for messages. To exit press CTRL+C, CTRL+C"
ReceiveLogsTopic.wait_for_messages(channel)
要接收所有日志,请运行
mix run receive_logs_topic.exs "#"
要接收来自设施 kern
的所有日志
mix run receive_logs_topic.exs "kern.*"
或者,如果您只想听到关于 critical
日志的信息
mix run receive_logs_topic.exs "*.critical"
您可以创建多个绑定
mix run receive_logs_topic.exs "kern.*" "*.critical"
要使用路由键 kern.critical
发送日志,请键入
mix run emit_log_topic.exs "kern.critical" "A critical kernel error"
尽情玩这些程序。请注意,代码不对路由键或绑定键做任何假设,您可能想尝试使用两个以上的路由键参数。
(emit_logs_topic.exs 和 receive_logs_topic.exs 的完整源代码)
继续学习教程 6,了解 RPC。