RabbitMQ 教程譯文（四） + 學習

原文地址
除了特殊聲明，以下所有圖片皆來自教程原文

Routing路由
在之前的章節中，我們創建了一個簡單的日誌系統。我們廣播日誌給多個接收者。

在本章節中，我們會給這個日誌系統增加一個特色功能：我們將會實現日誌信息的訂閱功能。比如，我們可能會將錯誤日誌直接存儲到本地硬盤，但是還會在控制檯打印顯示所有的日誌信息。

Bindings綁定
在之前的例子中，我們已經創建了一個binding，如下：

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

binding維持了exchange和隊列之間的關係。簡單的說就是：隊列對這個exchange的信息感興趣。

binding會接受額外的一個參數routingKey。爲了避免和basic_publish中的參數混淆，我們叫它binding key。下面是使用該參數構建binding的代碼

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

這句話的意思就是binding key會依賴於exchange的類型，對於fanout類型的exchange來說，它會忽略掉這個參數。

Direct exchange
我們之前章節中的日誌系統會廣播所有日誌信息給所有的消費者。我們將會擴展它的功能，允許通過日誌的嚴重程度過濾信息。比如，我們可能想讓一個程序將錯誤日誌信息寫到硬盤，但是不希望將警告或者普通信息寫到硬盤來浪費空間。

我們之前使用的fanout類型的exchange只會無腦廣播，缺少靈活性。

我們將會使用direct類型的exchange來代替。direct的路由算法非常簡單：信息會發送到binding key 和信息的routing key匹配的隊列。

下圖展示了發送過程：

如圖所示，exchange “X”綁定了兩個隊列，第一個隊列通過binding key“orange”綁定，第二個隊列有兩個binding，一個是“black”一個是“green”。

在這個系統中，routing key爲“orange”的信息將會被髮送到Q1隊列，routing key爲“black”和“green”的信息將會被髮送到Q2隊列，其他的信息將會被丟棄。

Multiple bindings 多次綁定

我們可以使用同一個binding key綁定多個隊列。在我們的例子中，我們可以在“X”和Q1隊列之間加一個binding key “black”，在這種情況下direct類型的exchange表現的就和fanout類型的一樣了，也會廣播所有的信息給所有的消費者Q1 ,Q2。

發送日誌
我們將會在我們的日誌系統中使用這個模型。替換之前的fanout類型的exchange爲direct類型。我們會使用日誌嚴重程度作爲binding key。這樣的話，消費者就會選擇他們感興趣的信息接收。現在我們先看看如何發送日誌。
首先我們需要創建一個exchange。

channel.exchangeDeclare(EXCHANGE_NAME, "direct");

然後準備發送信息

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

爲了簡化操作，我們假設日誌程度分爲：錯誤、警告、普通信息。

Subscribing訂閱
接收信息的程序和之前的教程基本一樣，唯一的不同是我們需要根據我們的興趣創建不同的binding。

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

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

合體~~

EmitLogDirect.java完整代碼如下：

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

public class EmitLogDirect {

    private static final String EXCHANGE_NAME = "direct_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, BuiltinExchangeType.DIRECT);

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

            channel.basicPublish(EXCHANGE_NAME, severity, null, message.getBytes("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完整代碼如下

import com.rabbitmq.client.*;

public class ReceiveLogsDirect {

  private static final String EXCHANGE_NAME = "direct_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, "direct");
    String 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(), "UTF-8");
        System.out.println(" [x] Received '" +
            delivery.getEnvelope().getRoutingKey() + "':'" + message + "'");
    };
    channel.basicConsume(queueName, true, deliverCallback, consumerTag -> { });
  }
}

收工~~