RabbitMQ系列教程之五:主题(Topic)(转载)
(本实例都是使用的Net的客户端,使用C#编写),说明,中文方括号【】表示名词。
在上一个教程中,我们改进了我们的日志记录系统。 没有使用只能够进行虚拟广播的【Fanout】交换机,而是使用了【Direct】类型的交换机,这样做就可以让我们有可能选择性地接收日志。
虽然使用【Direct】类型的【消息交换机】改进了我们的系统,但它仍然有限制 - 它不能基于多个标准进行路由选择。
在我们的日志记录系统中,我们可能不仅要根据严重性订阅日志,还可以基于发出日志的源进行订阅。 您可能会从syslog unix工具中了解这一概念,该工具根据严重性(info/warn/crit...)和设施(auth / cron / kern ...)路由日志。
这将给我们很大的灵活性 - 我们可能既想监听来自“cron”的重要错误,也可以监听“kern”的所有日志。
要在我们的日志记录系统中实现,我们需要了解一个更为复杂的topic类型的【消息交换机】。
1、Topic类型的【消息交换机】
发送到【Topic】类型【消息交换机】的消息不能有任意的routing_key - 它必须是由点分隔的单词列表。 这些词可以是任何东西,但通常它们指定与消息相关联的一些功能。 几个有效的路由关键字示例:“stock.usd.nyse”,“nyse.vmw”,“quick.orange.rabbit”。 路由关键字中可以有任意多的单词,最多可达255个字节。
绑定键也必须是相同的形式。【Topic】类型的【消息交换机】背后的逻辑类似于【Direct】类型的【消息交换机】 - 使用特定【路由键】发送的消息将被传递到与匹配的【绑定键】绑定的所有队列。 但是,【绑定键】有两个重要的特殊情况:
*(星)可以替代一个字。
#(井号)可以替换零个或多个单词。
在一个例子中最简单的解释一下:
在这个例子中,我们将发送所有描述动物的消息。消息将使用由三个字(两个点)组成的【路由键】发送。【路由键】中的第一个字将描述速度,第二个颜色和第三个种类:“<speed>.<color>.<species>”。
我们创建了三个绑定:Q1绑定键“*.orange.*”和Q2是“*.*.rabbit”和“lazy.#”绑定。
这些【绑定键】所要表达意思可以总结为:
Q1对所有的橙色动物感兴趣。
Q2想听听有关兔子的一切,以及关于lazy动物的一切。
将【路由键】设置为“quick.orange.rabbit”的消息将传递给两个队列。消息“lazy.orange.elephant”也会发送他们那两个队列。另一方面,“quick.orange.fox”只会发送到第一个队列,而“lazy.brown.fox”只能发送到第二个队列。 “lazy.pink.rabbit”将被传递到第二个队列只有一次,即使它匹配两个绑定。 “quick.brown.fox”不匹配任何绑定,所以它将被丢弃。
如果我们违反约定并发送一个或四个字的消息,如“orange”或“quick.orange.male.rabbit”,会发生什么?那么这些消息将不会匹配任何绑定,并将丢失。
另一方面,“lazy.orange.male.rabbit”即使它有四个字,将匹配上一个绑定,并将被传递到第二个队列。
说明:【Topic】类型的【消息交换机】
此类型的【消息交换机】是强大的,可以像其他【消息交换机】一样行事。
当队列用“#”(哈希)【绑定键】绑定时,它将接收所有消息,而不管【路由键】,就像使用【Fanout】类型的【消息交换机】。
当特殊字符“*”(星号)和“#”(哈希)不用于绑定时,【Topic】类型的【消息交换机】将表现得像一个使用【Direct】类型的【消息交换机】。
2、代码整合
我们将在我们的日志记录系统中使用【Topic】类型【消息交换机】。 我们将从一个工作假设开始,日志的【路由键】将有两个单词组成:“<facility>.<severity>”。
代码与上一个教程几乎相同。
EmitLogTopic.cs的代码:
1 using System; 2 using System.Linq; 3 using RabbitMQ.Client; 4 using System.Text; 5 6 class EmitLogTopic 7 { 8 public static void Main(string[] args) 9 { 10 var factory = new ConnectionFactory() { HostName = "localhost" }; 11 using(var connection = factory.CreateConnection()) 12 using(var channel = connection.CreateModel()) 13 { 14 channel.ExchangeDeclare(exchange: "topic_logs", 15 type: "topic"); 16 17 var routingKey = (args.Length > 0) ? args[0] : "anonymous.info"; 18 var message = (args.Length > 1) 19 ? string.Join(" ", args.Skip( 1 ).ToArray()) 20 : "Hello World!"; 21 var body = Encoding.UTF8.GetBytes(message); 22 channel.BasicPublish(exchange: "topic_logs", 23 routingKey: routingKey, 24 basicProperties: null, 25 body: body); 26 Console.WriteLine(" [x] Sent '{0}':'{1}'", routingKey, message); 27 } 28 } 29 }
ReceiveLogsTopic.cs的代码:
1 using System; 2 using RabbitMQ.Client; 3 using RabbitMQ.Client.Events; 4 using System.Text; 5 6 class ReceiveLogsTopic 7 { 8 public static void Main(string[] args) 9 { 10 var factory = new ConnectionFactory() { HostName = "localhost" }; 11 using(var connection = factory.CreateConnection()) 12 using(var channel = connection.CreateModel()) 13 { 14 channel.ExchangeDeclare(exchange: "topic_logs", type: "topic"); 15 var queueName = channel.QueueDeclare().QueueName; 16 17 if(args.Length < 1) 18 { 19 Console.Error.WriteLine("Usage: {0} [binding_key...]", 20 Environment.GetCommandLineArgs()[0]); 21 Console.WriteLine(" Press [enter] to exit."); 22 Console.ReadLine(); 23 Environment.ExitCode = 1; 24 return; 25 } 26 27 foreach(var bindingKey in args) 28 { 29 channel.QueueBind(queue: queueName, 30 exchange: "topic_logs", 31 routingKey: bindingKey); 32 } 33 34 Console.WriteLine(" [*] Waiting for messages. To exit press CTRL+C"); 35 36 var consumer = new EventingBasicConsumer(channel); 37 consumer.Received += (model, ea) => 38 { 39 var body = ea.Body; 40 var message = Encoding.UTF8.GetString(body); 41 var routingKey = ea.RoutingKey; 42 Console.WriteLine(" [x] Received '{0}':'{1}'", 43 routingKey, 44 message); 45 }; 46 channel.BasicConsume(queue: queueName, 47 noAck: true, 48 consumer: consumer); 49 50 Console.WriteLine(" Press [enter] to exit."); 51 Console.ReadLine(); 52 } 53 } 54 }
3、运行以下示例:
收到所有的日志:
cd ReceiveLogsTopic dotnet run“#”
从设备“kern”接收所有日志:
cd ReceiveLogsTopic dotnet run “kern.*”
或者如果您只想听到关于“critical”日志的信息:
ReceiveLogsTopic.exe“* .critical”
您可以创建多个绑定:
cd ReceiveLogsTopic dotnet run“kern.*”“*.critical”
并使用【路由键】“kern.critical”类型发出日志:
cd emitLogTopic dotnet run“kern.critical”“A critial kernel error”
写这些程序很有趣。 请注意,代码不会对【路由键】或【绑定键】做任何假设,您可能希望使用两个以上的【路由键】参数进行操作。
今天就到此为止了,如果英文比较好的,可以查看原文,原文地址是:http://www.rabbitmq.com/tutorials/tutorial-five-dotnet.html