RabbitMQ

喜夏-厌秋 提交于 2021-01-09 02:51:49

注:本文为翻译

原文地址:

https://www.rabbitmq.com/tutorials/tutorial-three-java.html

发布 / 订阅

在前一章中,我们创建了工作队列。工作队列背后的假设是,每个任务只交付给一个工作者。在这一部分中,我们将做一些完全不同的事情:我们将向多个消费者传递消息,这种模式称为「发布 / 订阅」

为了演示该模式,我们将构建一个简单的日志系统,它将由两个程序组成:第一个程序将发出日志消息,第二个程序将接受并打印它们。

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

实际上,发布的日志消息将广播给所有接收方。

交换器

在前一几章,我们向队列发送和接收消息。现在是时候在 Rabbit 中引入完整的消息模型了。

让我们快速回顾一下我们在之前的章节中介绍的内容:

  • 生产者是发送消息的用户应用程序

  • 队列是存储消息的缓冲区

  • 消费者是接收消息的用户应用程序

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

相反,生产者只能向交换器发送消息。交换是一件很简单的事情。一方面,它接收来自生产者的消息,另一个方面,它将消息推送到队列中,交换器必须明确地知道如何处理它接受到的消息。是否应该将其附加到特定队列中?它应该添加到许多队列中吗?或者它应该被丢弃。这些规则都由交换类型来定义。

img

有几种可用的交换类型:direct、topic、headers 和 fanout。我们将关注最后一个 fanout。让我们创建这种类型的交换,并将其称为 logs:

channel.exchangeDeclare("logs""fanout");

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

列出交换器

要列出服务器上的交换器,可以使用非常有用的 rabbitmqctl 工具:

sudo rabbitmqctl list_exchanges

在这个列表中会有一些 amq.* 交换器和默认(未命名)的交换器,这些都是默认创建的,但是您现在不太可能需要使用它们。

无名交换器

在前面的章节中,我们对交换器一无所知,但仍然能够将消息发送到队列。这是可能的,因为我们使用的是默认交换器,它由空字符串("")标识。

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

channel.basicPublish("""hello"null, message.getBytes());

第一个参数是交换器的名称。空字符串标识默认的或没有名称的交换器:如果消息存在,则将使用路由关键字(队列名称)指定的名称将消息路由到队列。

现在,我们可以发布消息到有名称的交换器:

channel.basicPublish( "logs"""null, message.getBytes());

临时队列

您可能还记的,以前我们使用具有特定名称的队列(还记得 hello 和 task_queue 吗?)。能够命名队列对我们来说非常重要 -- 我们需要将 worker 指向相同的队列。当您希望在生产者和消费者之间共享队列时,为队列指定名称非常重要。

但对于我们的日志记录器来说,情况并非如此。我们希望了解所有日志消息,而不仅仅是其中的一个子集。我们还只对当前的消息流感兴趣,而对旧消息不感兴趣。要解决这个问题,我们需要如下两件事:

  • 首先,当我们连接到 Rabbit 时,我们需要一个全新的空队列。为此,我们可以创建一个具有随机名称的队列,或者更好的方法是:让服务器为我们选择一个随机队列名称。

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

在 Java 客户端中,当我们不向 queueDeclare() 提供参数时,我们将创建一个非持久的、自动删除队列,并使用生成的名称:

String queueName = channel.queueDeclare().getQueue();

你可以在队列指南中了解关于 exclusive 标志和其他队列属性的更多信息。

此时,队列名称包含一个随机的队列名称。例如,它可能看起来像 amq.gen-JzTY20BRgKO-HjmUJj0wLg。

Bindings

img

我们已经创建了一个 fanout 交换器和一个队列。现在我们需要告诉交换器向队列发送消息。交换器和队列之间的关系成为绑定(binding)。

channel.queueBind(queueName, "logs""");

从现在开始,日志交换器将向队列添加消息。

列出 Bindings

你可以列出现有的 bindings

rabbitmqctl list_bindings

将整个模型组装起来

img

生产者发出日志消息,它看起来与前一章没有太大的不同。最重要的修改是,我们现在希望将消息发布到命名为 logs 的日志交换器中,而不是将消息发布到无名的交换器中。我们需要在发送时提供一个 routingKey,但是对于 fanout 类型的交换器,它的值被忽略了,不生效。下面是 EmitLog.java 程序代码:

public class EmitLog {

  private static final String EXCHANGE_NAME = "logs";

  public static void main(String[] argv) throws Exception {
    ConnectionFactory factory = new ConnectionFactory();
    factory.setHost("localhost");
    try (Connection connection = factory.newConnection();
         Channel channel = connection.createChannel()) {
        channel.exchangeDeclare(EXCHANGE_NAME, "fanout");

        String message = argv.length < 1 ? "info: Hello World!" :
                            String.join(" ", argv);

        channel.basicPublish(EXCHANGE_NAME, ""null, message.getBytes("UTF-8"));
        System.out.println(" [x] Sent '" + message + "'");
    }
  }
}

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

如果还没有队列绑定到交换器,则消息将丢失,但现在这对我们来说没问题,如果没有消费者在监听,我们可以安全地丢弃消息。

消费者 ReceiveLogs.java 代码如下:

import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.DeliverCallback;

public class ReceiveLogs {
  private static final String EXCHANGE_NAME = "logs";

  public static void main(String[] argv) throws Exception {
    ConnectionFactory factory = new ConnectionFactory();
    factory.setHost("localhost");
    Connection connection = factory.newConnection();
    Channel channel = connection.createChannel();

    channel.exchangeDeclare(EXCHANGE_NAME, "fanout");
    String queueName = channel.queueDeclare().getQueue();
    channel.queueBind(queueName, EXCHANGE_NAME, "");

    System.out.println(" [*] Waiting for messages. To exit press CTRL+C");

    DeliverCallback deliverCallback = (consumerTag, delivery) -> {
        String message = new String(delivery.getBody(), "UTF-8");
        System.out.println(" [x] Received '" + message + "'");
    };
    channel.basicConsume(queueName, true, deliverCallback, consumerTag -> { });
  }
}

像之前一样进行编译

javac -cp $CP EmitLog.java ReceiveLogs.java

如果您想将日志保存到文件中,只需打开控制台并输入:

java -cp $CP ReceiveLogs > logs_from_rabbit.log

如果您希望在屏幕上看到日志,打开一个新的终端并运行:

java -cp $CP ReceiveLogs

当然,要发送日志:

java -cp $CP EmitLog

使用 rabbitmqctl list_bindings 命令,您可以验证是否按预期创建了 bindings 和 队列。运行两个 ReceiveLogs.java 程序你应该会看到如下结果:

sudo rabbitmqctl list_bindings
# => Listing bindings ...
# => logs    exchange        amq.gen-JzTY20BRgKO-HjmUJj0wLg  queue           []
# => logs    exchange        amq.gen-vso0PVvyiRIL2WoV3i48Yg  queue           []
# => ...done.

结果很明显:来自日志交换器的数据进入两个具有服务器分配名称的队列,这正是我们预期的结果。


本文分享自微信公众号 - 云大数据社区(DeveloperLeo)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

标签
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!