RabbitMQ系列教程之四：路由（Routing）

（使用Net客户端）

在上一个教程中，我们构建了一个简单的日志系统，我们能够向许多消息接受者广播发送日志消息。

在本教程中，我们将为其添加一项功能，这个功能是我们将只订阅消息的一个子集成为可能。例如，我们可以只将关键的错误消息输出到日志文件（以节省磁盘空间），同时仍然可以在控制台上打印所有日志消息。

1、绑定

在以前的例子中，我们已经创建了绑定。你可能会记得如下代码：

channel.QueueBind(queue: queueName, exchange: "logs", routingKey: "");

【绑定】是【消息交换机】和【队列】之间的关系纽带，通过绑定把二者关联起来。这可以简单地理解为：队列可以接收来自此【消息交换机】的消息。

【绑定】可以占用额外的路由选择参数。为了避免与BasicPublish参数混淆，我们将其称为【绑定键】。以下代码就是如何用一个键值来创建一个绑定：

channel.QueueBind(queue: queueName,

                  exchange: "direct_logs",

                  routingKey: "black");

【绑定键】的含义取决于交换类型。以前我们使用的【Fanout】类型的【消息交换机】忽略了它的取值。

2、直接交换

在上一个教程中，我们的日志记录系统向所有【消费者】发送所有消息。我们希望将其扩展为允许基于其严重性过滤消息。例如，我们可能希望将写入磁盘日志消息的脚本仅接受严重错误，而不会在警告或信息日志消息上浪费磁盘空间。

我们正在使用一个【Fanout】类型的【消息交换机】，它不会给我们带来很大的灵活性 - 它只能无意识地发送。

我们将使用一个【Direct】类型的【消息交换机】。直接转换路由的背后的算法其实是很简单的 - 把消息传递到【绑定键 binding key】和消息的【路由键 routing key】完全匹配的队列中。

为了说明，请考虑以下设置：

在这个设置中，我们可以看到【Direct】类型的【消息交换机】X与两个队列相绑定。第一个队列与【绑定键】的值是Orange相绑定的，第二个队列有两个绑定，一个【绑定键】的值是black，另一个【绑定键】的值是green。

在这样的设置中，发布到具有【路由键】为orange的【消息交换机】的消息将被路由到队列Q1。具有black或green【路由键】的消息将转到Q2。所有其他消息将被丢弃。

3、多重绑定

使用相同的【绑定键】绑定多个队列是完全合法的。在我们的示例中，我们可以在X和Q1之间添加【绑定键】是black的绑定。在这种情况下，【direct】类型的【消息交换机】将表现得像【Fanout】类型的【消息交换机】，并将消息发送到所有匹配的队列。具有【路由键】是black的消息将传送到Q1和Q2。

4、发出日志

我们将发送消息到【Direct】类型的【消息交换机】来替换【fanout】类型的【消息交换机】，在我们现在的日志系统将使用此模型。我们将提供日志严重性作为【路由键】。这样接收脚本就能够选择想要接收的严重性。我们首先关注发出日志。

像以前一样，我们首先要建立一个【消息交换机】：

channel.ExchangeDeclare(exchange: "direct_logs", type: "direct");

现在，我们准备发送消息：

var body = Encoding.UTF8.GetBytes(message);

channel.BasicPublish(exchange: "direct_logs",

                     routingKey: severity,

                     basicProperties: null,

                     body: body);

为了简化事情，我们假设“严重性”可以是“信息”，“警告”，“错误”之一。

5、订阅

接收消息将像上一个教程一样工作，除了一个例外 - 我们将为每个我们感兴趣的严重性创建一个新的绑定。

var queueName = channel.QueueDeclare().QueueName;

foreach(var severity in args)

{

    channel.QueueBind(queue: queueName,

                      exchange: "direct_logs",

                      routingKey: severity);

}

6、整合

以下是EmitLogDirect.cs类的代码：

 using System;

 using System.Linq;

 using RabbitMQ.Client;

 using System.Text;

 class EmitLogDirect

 {

     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: "direct_logs",

                                     type: "direct");

             var severity = (args.Length > ) ? args[] : "info";

             var message = (args.Length > )

                           ? string.Join(" ", args.Skip(  ).ToArray())

                           : "Hello World!";

             var body = Encoding.UTF8.GetBytes(message);

             channel.BasicPublish(exchange: "direct_logs",

                                  routingKey: severity,

                                  basicProperties: null,

                                  body: body);

             Console.WriteLine(" [x] Sent '{0}':'{1}'", severity, message);

         }

         Console.WriteLine(" Press [enter] to exit.");

         Console.ReadLine();

     }

 }

以下是ReceiveLogsDirect.cs类的代码：

 using System;

 using RabbitMQ.Client;

 using RabbitMQ.Client.Events;

 using System.Text;

 class ReceiveLogsDirect

 {

     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: "direct_logs",

                                     type: "direct");

             var queueName = channel.QueueDeclare().QueueName;

             if(args.Length < )

             {

                 Console.Error.WriteLine("Usage: {0} [info] [warning] [error]",

                                         Environment.GetCommandLineArgs()[]);

                 Console.WriteLine(" Press [enter] to exit.");

                 Console.ReadLine();

                 Environment.ExitCode = ;

                 return;

             }

             foreach(var severity in args)

             {

                 channel.QueueBind(queue: queueName,

                                   exchange: "direct_logs",

                                   routingKey: severity);

             }

             Console.WriteLine(" [*] Waiting for messages.");

             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,

                                  noAck: true,

                                  consumer: consumer);

             Console.WriteLine(" Press [enter] to exit.");

             Console.ReadLine();

         }

     }

 }

如果您只想将“警告”和“错误”（而不是“信息”）保存到文件中，只需打开控制台并键入：

cd ReceiveLogsDirect

dotnet run warning error > logs_from_rabbit.log

如果您想查看屏幕上的所有日志消息，请打开一个新终端，然后执行以下操作：

cd ReceiveLogsDirect

dotnet run info warning error

# => [*] Waiting for logs. To exit press CTRL+C

而且，例如，要发出错误日志消息，只需键入：

cd EmitLogDirect

dotnet run error "Run. Run. Or it will explode."

# => [x] Sent 'error':'Run. Run. Or it will explode.'

以下是原文地址：http://www.rabbitmq.com/tutorials/tutorial-four-dotnet.html

今天这篇文章终于翻译完了，整个系列还有几篇没翻译。英文水平有限，错误在所难免，欢迎大家提出来，共同学习。

巴特西

RabbitMQ系列教程之四：路由（Routing）

最新文章

热门文章