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

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