RabbitMQ 教程譯文（五） + 學習

原文地址
https://www.rabbitmq.com/tutorials/tutorial-five-java.html

Topics

在之前的教程中，我們改進了日誌系統，我們使用direct exchange代替fanout exchange，不使用廣播的形式發送日誌。而且我們可以挑選感興趣的日誌接收。

雖然使用direct exchange改進了我們的日誌系統，但是還是有限制的，在多個條件下direct無法執行。

在我們的日誌系統中，我們可能不只是根據日誌嚴重級別來接收，可能還需要考慮日誌的發送源。你可能從UNIX的工具syslog中知道這個概念，在這個工具中我們可以根據嚴重級別（info/warn/crit…）和設備（auth/cron/kern…）獲取信息。

這會帶給我們更多的靈活性，我們可能想接收cron 的嚴重錯誤日誌和kern的全部日誌。

爲了在我們的日子系統中實現這個功能，我們需要學習一個更復雜的exchange topic。

Topic exchange

消息發送給topic exchange不能是一個任意的routing_key，而是一個單詞列表，單詞通過‘.’分割。單詞可以隨便寫，但是一般會和信息相關。比如"stock.usd.nyse", “nyse.vmw”, “quick.orange.rabbit”。routing_key的最大長度是255bytes，在範圍內，單詞數量沒有限制。

binding key格式必須和routing_key一樣。topic exchange的邏輯和direct exchange類似：一個帶着特殊routing_key的信息將會發送給所有綁定了這個特殊binding key的隊列。但是對於binding key有兩個特殊的情況：

*（星號）可以代替一個完整的單詞

#（哈希）可以代替0個或多個單詞

在下面的例子中會很容易解釋這些

在這個例子中我們會發送一些描述動物的信息。這些信息的routing_key有三個單詞組成（兩個分隔符’.’），第一個單詞描述“速度”，第二個“顏色”，第三個“品種”： “..”。

我們創建三種綁定：隊列Q1使用" *.orange.* “綁定，隊列Q2使用”..rabbit" 和 “lazy.#”。

這些綁定關係可以解釋爲：

隊列Q1對所有橘色的動物感興趣；

隊列Q2對所有的兔子和所有的懶得的動物感興趣；

一個routing key爲"quick.orange.rabbit"的信息將會發送給Q1和Q2。"lazy.orange.elephant"的信息也會發送這兩個隊列。另一方面，"quick.orange.fox"將會只發送給Q1，"lazy.brown.fox"只發送給Q2。“lazy.pink.rabbit” 將會發送給Q2，但是隻發送一次，儘管它匹配了兩個binding key。 "quick.brown.fox"沒有匹配任何binding key，所以會被拋棄。

如果我們打破之前的約定，發送了一個或者四個單詞的routing key的信息會怎麼辦？比如"orange" 或者 “quick.orange.male.rabbit”。這些routing key不會匹配任何binding 所以會被丟棄。

然而 “lazy.orange.male.rabbit"儘管包含四個單詞，但是會匹配"lazy.#”，所以會發送給Q2。

Topic Exchange

topic exchange功能很強大，而且它可以表現的和其他exchange一樣。當一個隊列的binding key是"#"，它會接收所有的信息，而並不會關心routing key，就像fanout exchange一樣。當特殊字符"#" ""沒有出現在binding key中，那麼此時的topic exchange就像direct exchange*一樣。

合體~

我們將會在日誌系統中使用topic exchange。開始之前，我們約定日誌信息的routing key是兩個單詞： “.”。

EmitLogTopic.java代碼如下

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

public class EmitLogTopic {

    private static final String EXCHANGE_NAME = "topic_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, "topic");

            String routingKey = getRouting(argv);
            String message = getMessage(argv);

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

    private static String getRouting(String[] strings) {
        if (strings.length < 1)
            return "anonymous.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();
    }
}

ReceiveLogsTopic.java代碼如下

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

public class ReceiveLogsTopic {

    private static final String EXCHANGE_NAME = "topic_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, "topic");
        String queueName = channel.queueDeclare().getQueue();

        if (argv.length < 1) {
            System.err.println("Usage: ReceiveLogsTopic [binding_key]...");
            System.exit(1);
        }

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

        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 '" + delivery.getEnvelope().getRoutingKey() + "':'" + message + "'");
        };
        channel.basicConsume(queueName, true, deliverCallback, consumerTag -> { });
    }
}