Topics
在之前的笔记中,我们改进了日志系统。我们使用了一个 direct 交换器,而不是使用一个只能够进行虚拟广播的 fanout 交换器,实现了有选择性地接收日志。
尽管使用 direct 交换器改进了我们的系统,但它仍然有局限性——它不能基于多个标准进行选择指定路线(routing)。
在我们的日志系统中,我们可能希望订阅的不仅是基于性质的日志,还需要基于发出日志的源。您可能从名为 syslog 的unix工具中了解这个概念,该工具根据日志的性质(info /warning/ crit…)和设施(auth / cron / kern…)来选择路线发送日志。
这将给我们带来很大的灵活性——我们可能想要倾听来自“cron”的一些关键错误,但也有来自“kern”的所有日志信息。
为了在我们的日志系统中实现这一点,我们需要了解一个更复杂的交换器 —— topic交换器。
topic交换器
发送到topic交换器的消息不能有一个任意的routing key——它必须是一个单词列表,由点“.”分隔。单词可以是任何东西,但通常它们指定与消息连接的一些特性。一些有效的routing key示例:“stock.usd.nyse”, “nyse.vmw”, “quick.orange.rabbit”。在routing key中可以有任意数量的单词,最多可以达到255个字节。
binding key也必须以相同的形式出现。topic 交换器背后的逻辑类似于direct 交换器——发送带有特定 routing_key 的消息将被传送到绑定具有匹配 binding key 的所有队列。但是有两种重要的 binding key 特殊情况:
* 可以代替一个词。
# 可以替代零个或多个单词。
在如下一个例子中比较容易解释:
在本例中,我们将发送所有描述动物的消息。消息将发送带有三个单词(两个点)的 routing key。routing key中的第一个词将描述速度、第二个颜色和第三个物种:“ speed . color . species ”。
我们创建了三个绑定,Q1与binding key “*.orange.*”绑定,Q2与binding key “*.*.rabbit” 和 “lazy.#”绑定
这些绑定可以概括为:
Q1对所有的橙色动物都感兴趣。
Q2想接收关于兔子的一切,关于 lazy 动物的一切。
一个routing key为“quick. orange.rabbit”的消息,将被送到两个队列中。消息“lazy.orange.elephant”也会被送到两个队列中。另一方面,“quick.orange.fox”只会进入第一个队列,然后“lazy.brown.fox”只会进入第二个队列。“lazy.pink.rabbit”只会被发送到第二个队列,即使它匹配两个绑定。“quick.brown.fox”不匹配任何绑定,所以它将被丢弃。
如果我们违反规定,用一个或四个单词作为routing key发送信息,比如“orange”或“quick. orange . male.rabbit”,会发生什么情况呢?答案是:这些消息不匹配任何绑定,将被丢弃。
另一方面,“lazy.orange.male.rabbit”尽管它有四个单词,但它将匹配最后一个绑定,并将被传递到第二个队列。
Topic 交换器
Topic 交换器是强大的,可以表现得像其他交换器一样(通用)。
当队列与“#”绑定键绑定时,它将接收所有消息,不管routing key是什么,比如在fanout 交换器中。
当特殊字符“*”和“#”不用于绑定时,topic 交换器就会像 direct 一样。
编译运行
我们将在我们的日志系统中使用一个topic交换器。我们将从一个工作假设开始,即日志的routing key将有两个单词:“<设施> . <严重性>”。
代码几乎和前一笔记中的一样。
EmitLogTopic.java 的代码如下:
import com.rabbitmq.client.BuiltinExchangeType;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.Channel;
public class EmitLogTopic {
private static final String EXCHANGE_NAME = "topic_logs";
public static void main(String[] argv) {
Connection connection = null;
Channel channel = null;
try {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
connection = factory.newConnection();
channel = connection.createChannel();
channel.exchangeDeclare(EXCHANGE_NAME, BuiltinExchangeType.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 + "'");
}
catch (Exception e) {
e.printStackTrace();
}
finally {
if (connection != null) {
try {
connection.close();
}
catch (Exception ignore) {}
}
}
}
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.*;
import java.io.IOException;
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, BuiltinExchangeType.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");
Consumer consumer = new DefaultConsumer(channel) {
@Override
public void handleDelivery(String consumerTag, Envelope envelope,
AMQP.BasicProperties properties, byte[] body) throws IOException {
String message = new String(body, "UTF-8");
System.out.println(" [x] Received '" + envelope.getRoutingKey() + "':'" + message + "'");
}
};
channel.basicConsume(queueName, true, consumer);
}
}
编译并运行示例,包括笔记一中的类路径
编译:
javac -cp $CP ReceiveLogsTopic.java EmitLogTopic.java
接收所有的日志:
java -cp $CP ReceiveLogsTopic “#”
接收来自设备“kern”的所有日志:
java -cp $CP ReceiveLogsTopic “kern.*”
或者,如果你只想收到一些“critical”的日志:
java -cp $CP ReceiveLogsTopic “*.critical”
你可以创建多重绑定:
java -cp $CP ReceiveLogsTopic “kern.” “.critical”
并发送routing key为“kern.critical”的日志:
java -cp $CP EmitLogTopic “kern.critical” “A critical kernel error”
请注意,代码没有对 routing key 或 binding key 做出任何约束,你可以使用两个以上的 routing key 参数。
相关链接
rabbitmq-c++(SimpleAmqpClient) 笔记代码系列:
rabbitmq-c++(SimpleAmqpClient) 笔记代码一
rabbitmq-c++(SimpleAmqpClient) 笔记代码二
rabbitmq-c++(SimpleAmqpClient) 笔记代码三
rabbitmq-c++(SimpleAmqpClient) 笔记代码四
rabbitmq-c++(SimpleAmqpClient) 笔记代码五
rabbitmq-c++(SimpleAmqpClient) 笔记代码六
RabbitMQ 学习笔记系列:
RabbitMQ 学习笔记(一):简单介绍及”Hello World”
RabbitMQ 学习笔记(二):work queues
RabbitMQ 学习笔记(三):Publish/Subscribe
RabbitMQ 学习笔记(四):Routing
RabbitMQ 学习笔记(五):Topics
RabbitMQ 学习笔记(六):RPC