4.路由介绍

路由

Routing(using the java client)

在前面的章节中，我们构建了一个简单的日志系统，能够将日志信息广播给许多接收者。
现在我们将为它添加一个特性——将使订阅消息的一个子集成为可能。例如，只将关键错误消息重定向到日志文件(以节省磁盘空间)，同时仍然能够在控制台上打印所有的日志消息。

绑定

在前面的例子中，我们已经创建了绑定：

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

绑定是交换机和队列之间的关系。这可以简单地理解为：队列对来自此交换机的消息感兴趣。
绑定可以接受一个额外的routingKey参数。为了避免与basic_publish参数混淆，将其称为binding key。即使用键创建绑定的方法：

channel.queueBind(queueName, EXCHANGE_NAME, "black");

绑定键的含义取决于交换机的类型。例如之前使用的fanout交换机简单地忽略了它的值。

direct交换机

之前介绍的日志系统将所有消息广播给所有用户。我们希望对其进行扩展，以允许根据其严重性对消息进行过滤。例如，可能希望一个将日志消息写入磁盘的程序只接收严重错误，而不会在警告或信息日志消息上浪费磁盘空间。
之前所使用的是fanout交换机，这并没有给我们太多的灵活性——它只能进行无意识的广播。
现在将使用direct交换机。direct交换机背后的路由算法很简单——消息被发送到队列，其binding key与消息的routing key完全匹配。
为了说明这一点，请考虑以下设置：

在这个设置中，可以看到绑定了两个队列的direct交换机X。第一个队列的绑定键为orange，第二个队列有两个绑定，一个绑定键为black，另一个绑定键为green。在这样的设置中，发布给交换机的带有orange路由键的消息将被路由到队列Q1。带有black或green路由键的消息将发送到Q2。所有其他消息将被丢弃。

多个绑定

使用相同的绑定键绑定多个队列是完全合法的。在我们的例子中，可以用绑定键black在X和Q1之间添加绑定。在这种情况下，direct交换机将像fanout一样工作，并将消息广播到所有匹配的队列。带有路由键black的消息将同时发送到Q1和Q2。

发送日志

我们将在日志系统中使用这个模型，即把消息发送到direct交换机，而不是fanout。提供日志的严重程度作为一个路由键，这样的话接收程序就能选择它想要接收的严重程度的消息。首先来关注发送日志。
和往常一样，需要先创建一个交换机：

channel.exchangeDeclare(EXCHANGE_NAME, "direct");

现在，已经准备好传达一个信息：

channel.basicPublish(EXCHANGE_NAME, severity, null, message.getBytes());

为了简化问题，假设"严重程度"可以是"info"、“warning”、"error"中的一种。

订阅

接收消息的工作方式与前面的章节类似，但有一个例外——我们将为我们感兴趣的每个严重程度创建一个新的绑定。

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

for(String severity : argv){
	channel.queueBind(queueName, EXCHANGE_NAME, severity);
}

整合代码

EmitLogDirect.java类的代码：

public class EmitLogDirect {
    private static final String EXCHANGE_NAME = "direct_logs";

    public static void main(String[] argv) throws Exception {
        var factory = new ConnectionFactory();
        factory.setHost("192.168.1.254");
        factory.setUsername("admin");
        factory.setPassword("admin123");

        try (var connection = factory.newConnection();
             var channel = connection.createChannel()) {
            channel.exchangeDeclare(EXCHANGE_NAME, "direct");

            var severity = getSeverity(argv);
            var message = getMessage(argv);

            channel.basicPublish(EXCHANGE_NAME, severity, null, 
                    message.getBytes(StandardCharsets.UTF_8));
            
            System.out.println(" [x] Sent '" + severity + "':'" + message + "'");
        }
    }

    private static String getSeverity(String[] strings) {
        if (strings.length < 1) {
            return "info";
        }
        return strings[0];
    }

    private static String getMessage(String[] strings) {
        if (strings.length < 2) {
            return "Hello World!";
        }
        return joinStrings(strings, " ", 1);
    }

    private static String joinStrings(String[] strings, String delimiter, int startIndex) {
        int length = strings.length;

        if (length == 0) {
            return "";
        }

        if (length <= startIndex) {
            return "";
        }

        StringBuilder words = new StringBuilder(strings[startIndex]);

        for (int i = startIndex + 1; i < length; i++) {
            words.append(delimiter).append(strings[i]);
        }

        return words.toString();
    }
}

ReceiveLogsDirect.java类的代码：

public class ReceiveLogsDirect {
    private static final String EXCHANGE_NAME = "direct_logs";

    public static void main(String[] argv) throws Exception {
        var factory = new ConnectionFactory();
        factory.setHost("192.168.1.254");
        factory.setUsername("admin");
        factory.setPassword("admin123");

        var connection = factory.newConnection();
        var channel = connection.createChannel();

        channel.exchangeDeclare(EXCHANGE_NAME, BuiltinExchangeType.DIRECT);

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

        if (argv.length < 1) {
            System.err.println("Usage: ReceiveLogsDirect [info] [warning] [error]");
            System.exit(1);
        }

        for (String severity : argv) {
            channel.queueBind(queueName, EXCHANGE_NAME, severity);
        }

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

        DeliverCallback deliverCallback = (consumerTag, delivery) -> {
            String message = new String(delivery.getBody(), StandardCharsets.UTF_8);
            System.out.println(" [x] Received '" + delivery.getEnvelope().getRoutingKey()
                    + "':'" + message + "'");
        };

        channel.basicConsume(queueName, true, deliverCallback, consumerTag -> {
        });
    }
}