原文来自 RabbitMQ 英文官网教程(5.Topics),其示例代码采用了 .NET C# 语言。

In the previous tutorial we improved our logging system. Instead of using a fanout exchange only capable of dummy broadcasting, we used a direct one, and gained a possibility of selectively receiving the logs.

在之前的教程中,我们改进了日志系统。比起只能够单一广播的 fanout 型交换机,我们现在采用了 direct 型,从而获得了选择性接收日志的可能性。

Although using the direct exchange improved our system, it still has limitations - it can't do routing based on multiple criteria.

尽管使用 direct 型交换机对系统有所改进,但仍然有其局限性 - 即在多重条件下没办法进行路由。

In our logging system we might want to subscribe to not only logs based on severity, but also based on the source which emitted the log. You might know this concept from the syslog unix tool, which routes logs based on both severity (info/warn/crit...) and facility (auth/cron/kern...).

在该日志系统中,我们可能希望不仅仅订阅基于严重性(这一项指标)的日志,也希望能基于产生日志的源头。你大概会知道这个概念来自于 syslog unix 工具,它可以针对严重性(info/warn/crit...)和设备(auth/cron/kern...)进行路由。

That would give us a lot of flexibility - we may want to listen to just critical errors coming from 'cron' but also all logs from 'kern'.

这便给了我们许多灵活性 - 我们可以做到监听“cron”类型的严重错误,以及所有来自于“kern”设备的日志。

To implement that in our logging system we need to learn about a more complex topic exchange.

为了在我们的日志系统中实现上述功能,我们需要学习更为复杂的话题(Topic)交换机。

Topic exchange

话题交换机

Messages sent to a topic exchange can't have an arbitrary routing_key - it must be a list of words, delimited by dots. The words can be anything, but usually they specify some features connected to the message. A few valid routing key examples: "stock.usd.nyse", "nyse.vmw", "quick.orange.rabbit". There can be as many words in the routing key as you like, up to the limit of 255 bytes.

发送至 topic 型交换机的消息已不能携带任意的 routing_key - 而必须是一个字符串列表,并基于小数点来分隔。

The binding key must also be in the same form. The logic behind the topic exchange is similar to a direct one - a message sent with a particular routing key will be delivered to all the queues that are bound with a matching binding key. However there are two important special cases for binding keys:

  • * (star) can substitute for exactly one word.
  • # (hash) can substitute for zero or more words.

“绑定键”也必须是相同的格式。topic 型交换机背后的逻辑与 direct 型交换机相似 - 采用指定 routing key 所发送的消息将会被递送到与 binding key 相匹配的队列中,然而针对 binding key 有两个非常重要且特殊的情形:

  • * (星号)可以替代一个明确的字符串。
  • # (哈希,井号)可以替代 0 至多个字符串。

It's easiest to explain this in an example:

在示例中可以很容易的对其解释:

In this example, we're going to send messages which all describe animals. The messages will be sent with a routing key that consists of three words (two dots). The first word in the routing key will describe speed, second a colour and third a species: "..".

在这个示例中,我们打算发送用来描述动物的消息,它是基于三个字符串(包含两个小数点)组成的 routing key,其第一个字符串将用来描述速度,第二个是颜色,第三个是物种,如下:“<速度>.<颜色>.<物种>”。

We created three bindings: Q1 is bound with binding key ".orange." and Q2 with "..rabbit" and "lazy.#".

我们创建了三个绑定,队列 Q1 将关联到绑定键“*.orange.*”,队列 Q2 则关联到“*.*.rabbit”和“lazy.#”。

These bindings can be summarised as:

  • Q1 is interested in all the orange animals.
  • Q2 wants to hear everything about rabbits, and everything about lazy animals.

这些绑定可以概括为:

  • 队列 Q1 对所有桔黄色(orange)的动物感兴趣。
  • 队列 Q2 期望监听到所有 rabbit 后缀,以及所有 lazy 前缀的动物。

A message with a routing key set to "quick.orange.rabbit" will be delivered to both queues. Message "lazy.orange.elephant" also will go to both of them. On the other hand "quick.orange.fox" will only go to the first queue, and "lazy.brown.fox" only to the second. "lazy.pink.rabbit" will be delivered to the second queue only once, even though it matches two bindings. "quick.brown.fox" doesn't match any binding so it will be discarded.

routing key 设置为"quick.orange.rabbit"的消息将会被递送到两个队列。消息"lazy.orange.elephant"同样也会去往两个队列。另一方面,"quick.orange.fox"将只会去往第一个队列,"lazy.brown.fox"则只会去第二个队列。"lazy.pink.rabbit",尽管它匹配了两个绑定,但只会被递送到第二个队列一次(而不会是两次)。"quick.brown.fox"则不匹配任何绑定,所以将会被丢弃。

What happens if we break our contract and send a message with one or four words, like "orange" or "quick.orange.male.rabbit"? Well, these messages won't match any bindings and will be lost.

如果我们打破约定将会发生什么呢?比如发送一个字符串或者四个字符串,类似于“orange”或者“quick.orange.male.rabbit”。

On the other hand "lazy.orange.male.rabbit", even though it has four words, will match the last binding and will be delivered to the second queue.

另一方面像“lazy.orange.male.rabbit”,即使它有四个字符串,但仍然会匹配最后一个绑定(lazy.#)并被递送到第二个队列。

Topic exchange
话题交换机

Topic exchange is powerful and can behave like other exchanges.

话题(Topic)交换机很强大,它可以表现得类似其他交换机。

When a queue is bound with "#" (hash) binding key - it will receive all the messages, regardless of the routing key - like in fanout exchange.

当一个队列采用"#"作为绑定键时,它将接收到所有的消息而忽略掉路由键,这就像是 fanout 型交换机一样。

When special characters "*" (star) and "#" (hash) aren't used in bindings, the topic exchange will behave just like a direct one.

当特殊字符"*" (星号) and "#" (哈希,井号)都没有应用到绑定中时,topic 型交换机将表现得与 direct 型一样。

Putting it all together

融合一起

We're going to use a topic exchange in our logging system. We'll start off with a working assumption that the routing keys of logs will have two words: ".".

我们即将在日志系统中使用 topic 型交换机,首先从一个假定的工作前替起步,即拟定日志的路由键为两个字符串:"."

The code is almost the same as in the previous tutorial.

其代码与之前教程几乎相同。

The code for EmitLogTopic.cs:

EmitLogTopic.cs 类文件代码:

using System;
using System.Linq;
using RabbitMQ.Client;
using System.Text; class EmitLogTopic
{
public static void Main(string[] args)
{
var factory = new ConnectionFactory() { HostName = "localhost" };
using(var connection = factory.CreateConnection())
using(var channel = connection.CreateModel())
{
channel.ExchangeDeclare(exchange: "topic_logs",
type: "topic"); var routingKey = (args.Length > 0) ? args[0] : "anonymous.info";
var message = (args.Length > 1)
? string.Join(" ", args.Skip( 1 ).ToArray())
: "Hello World!";
var body = Encoding.UTF8.GetBytes(message);
channel.BasicPublish(exchange: "topic_logs",
routingKey: routingKey,
basicProperties: null,
body: body);
Console.WriteLine(" [x] Sent '{0}':'{1}'", routingKey, message);
}
}
}

The code for ReceiveLogsTopic.cs:

ReceiveLogsTopic.cs 类文件代码:

using System;
using RabbitMQ.Client;
using RabbitMQ.Client.Events;
using System.Text; class ReceiveLogsTopic
{
public static void Main(string[] args)
{
var factory = new ConnectionFactory() { HostName = "localhost" };
using(var connection = factory.CreateConnection())
using(var channel = connection.CreateModel())
{
channel.ExchangeDeclare(exchange: "topic_logs", type: "topic");
var queueName = channel.QueueDeclare().QueueName; if(args.Length < 1)
{
Console.Error.WriteLine("Usage: {0} [binding_key...]",
Environment.GetCommandLineArgs()[0]);
Console.WriteLine(" Press [enter] to exit.");
Console.ReadLine();
Environment.ExitCode = 1;
return;
} foreach(var bindingKey in args)
{
channel.QueueBind(queue: queueName,
exchange: "topic_logs",
routingKey: bindingKey);
} Console.WriteLine(" [*] Waiting for messages. To exit press CTRL+C"); var consumer = new EventingBasicConsumer(channel);
consumer.Received += (model, ea) =>
{
var body = ea.Body;
var message = Encoding.UTF8.GetString(body);
var routingKey = ea.RoutingKey;
Console.WriteLine(" [x] Received '{0}':'{1}'",
routingKey,
message);
};
channel.BasicConsume(queue: queueName,
autoAck: true,
consumer: consumer); Console.WriteLine(" Press [enter] to exit.");
Console.ReadLine();
}
}
}

Run the following examples:

运行示例:

To receive all the logs:

接收所有的日志:

cd ReceiveLogsTopic
dotnet run "#"

To receive all logs from the facility "kern":

只接收来自“kern”设备的日志:

cd ReceiveLogsTopic
dotnet run "kern.*"

Or if you want to hear only about "critical" logs:

或者你只想关心“critical”级别的日志:

ReceiveLogsTopic.exe "*.critical"

You can create multiple bindings:

你可以创建多重绑定:

cd ReceiveLogsTopic
dotnet run "kern.*" "*.critical"

And to emit a log with a routing key "kern.critical" type:

基于路由键“kern.critical”来产生日志,可以输入:

cd EmitLogTopic
dotnet run "kern.critical" "A critical kernel error"

Have fun playing with these programs. Note that the code doesn't make any assumption about the routing or binding keys, you may want to play with more than two routing key parameters.

程序执行起来还是很令人愉快的,要注意的是,这些代码并没有针对路由键或者绑定键做任何预设 ,你可能会需要用到超出两个以上的路由键参数。

(Full source code for EmitLogTopic.cs and ReceiveLogsTopic.cs)

( EmitLogTopic.csReceiveLogsTopic.cs 完整代码)

《RabbitMQ Tutorial》译文 第 5 章 主题的更多相关文章

  1. 《RabbitMQ Tutorial》第 1 章 简介

    本文来自英文官网,其示例代码采用了 .NET C# 语言. <RabbitMQ Tutorial>第 1 章 简介(Introduction) RabbitMQ is a message ...

  2. Ext JS 6学习文档-第8章-主题和响应式设计

    Ext JS 6学习文档-第8章-主题和响应式设计 主题和响应式设计 本章重点在 ExtJS 应用的主题和响应式设计.主要有以下几点内容: SASS 介绍和入门 主题 响应式设计 SASS 介绍和入门 ...

  3. 《RabbitMQ Tutorial》译文 第 2 章 工作队列

    源文来自 RabbitMQ 英文官网的教程(2.Work Queues),其示例代码采用了 .NET C# 语言. In the first tutorial we wrote programs to ...

  4. 《RabbitMQ Tutorial》译文 第 3 章 发布和订阅

    原文来自 RabbitMQ 英文官网的教程(3.Publish and Subscribe),其示例代码采用了 .NET C# 语言. In the previous tutorial we crea ...

  5. 《RabbitMQ Tutorial》译文 第 4 章 路由

    原文来自 RabbitMQ 英文官网的教程(4.Routing),其示例代码采用了 .NET C# 语言. In the previous tutorial we built a simple log ...

  6. 《RabbitMQ Tutorial》译文 第 6 章 远程过程调用(RPC)

    原文来自 RabbitMQ 英文官网的教程(6.Remote procedure call - RPC),其示例代码采用了 .NET C# 语言. In the second tutorial we ...

  7. 《RabbitMQ Tutorial》译文 第 1 章 简介

    原文来自 RabbitMQ 英文官网的教程(1.Introduction),其示例代码采用了 .NET C# 语言. RabbitMQ is a message broker: it accepts ...

  8. 译:5.RabbitMQ Java Client 之 Topics (主题)

    在 上篇博文 译:4.RabbitMQ 之Routing(路由) 中,我们改进了日志系统. 我们使用的是direct(直接交换),而不是使用只能进行虚拟广播的 fanout(扇出交换) ,并且有可能选 ...

  9. RabbitMQ 消息队列 入门 第二章(交换类型fanout)

    1.安装完 RabbitMQ 之后,我们可以点击  http://localhost:15672/#/  默认账号:guest  密码: guest  在这上面我们可以查看执行情况.管理连接.管理队列 ...

随机推荐

  1. 补写:Best Coder #85 1001 Sum(前缀和)

    sum Accepts: 640 Submissions: 1744 Time Limit: 2000/1000 MS (Java/Others) Memory Limit: 131072/13107 ...

  2. C# linq对分组操作执行子查询

    本主题演示创建查询的两种不同方式,此查询将源数据排序成组,然后分别对每个组执行子查询. 每个示例中的基本方法是使用名为 newGroup 的"接续块"对源元素进行分组,然后针对 n ...

  3. HTML5 input事件检测输入框变化[转载]

    原文:http://www.linuxidc.com/Linux/2015-07/119984.htm 之前一直用change事件来监听输入框内容是否发生变化,只有当输入框失去焦点时才会触发,没想到h ...

  4. NFS服务安装及配置

    服务器环境:CentOS6.9  Linux 2.6.32-696.el6.x86_64 安装NFS服务 nfs客户端和服务端都只需要安装nfs-utils包即可,并且yum安装时会连带安装rpcbi ...

  5. Python爬虫小实践:寻找失踪人口,爬取失踪儿童信息并写成csv文件,方便存入数据库

    前两天有人私信我,让我爬这个网站,http://bbs.baobeihuijia.com/forum-191-1.html上的失踪儿童信息,准备根据失踪儿童的失踪时的地理位置来更好的寻找失踪儿童,这种 ...

  6. java 中 针对数组进行的工具类

    1.遍历数组的方法: public static void printfArray(int[] arr)  2. 获取数组中最大值: public static int getMax(int[] ar ...

  7. Lucene全文检索引擎

    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/20 ...

  8. DbContext 和ObjectContext

    近日学习新知识,用到CallContext数据槽,一直使用ObjectContext 但同时又在学习EF CodeFirst,上下文定义使用的 DbContext 这时问题来了,如何把DbContex ...

  9. Verilog中变量位宽注意

    Verilog中,变量定义方式可以为:reg[位宽-1:0] 数据名:reg[位宽:1] 数据名.其他变量也类似. 以reg变量cnt为例,当cnt位宽为4时,可定义为reg[3:0] cnt,或者定 ...

  10. Java并发之线程管理(线程基础知识)

    因为书中涵盖的知识点比较全,所以就以书中的目录来学习和记录.当然,学习书中知识的时候自己的思考和实践是最重要的.说到线程,脑子里大概知道是个什么东西,但很多东西都还是懵懵懂懂,这是最可怕的.所以想着细 ...