[译]RabbitMQ教程C#版

先决条件

本教程假定 RabbitMQ 已经安装，并运行在localhost 标准端口（5672）。如果你使用不同的主机、端口或证书，则需要调整连接设置。

从哪里获得帮助

如果您在阅读本教程时遇到困难，可以通过邮件列表联系我们。

路由

（使用.NET客户端）

在教程[3] 中，我们构建了一个简单的日志系统，可以向多个接收者广播消息。

在本教程中，我们会为日志系统再添加一个特性，使其可以只订阅消息的一个子集。例如，将所有日志消息打印到

控制台，同时只会将严重错误消息写入日志文件（保存到磁盘空间）。

绑定

在前面的例子中，我们创建过绑定。不知道您是否还记得下面的代码：

channel.QueueBind(queue: queueName,

                  exchange: "logs",

                  routingKey: "");

绑定是指交换器和队列之间的关联关系。可以简单地理解为：某个队列对来自此交换器的消息感兴趣。

绑定可以采用额外的routingKey参数，为了避免与BasicPublish方法中相同参数混淆，我们将其称为binding key（这里是指路由键从声明角度的一种别称，绑定键）。下面即是如何使用绑定键建立一个绑定：

channel.QueueBind(queue: queueName,

                  exchange: "direct_logs",

                  routingKey: "black");

绑定键的含义取决于交换器类型。像我们前面使用的fanout 交换器，忽略了它的值（依据fanout交换器的特性，它会把消息广播到所有订阅的队列，所以就算指定routingKey也不会根据其过滤消息）。

Direct交换器

在上篇教程中，我们的日志系统会把所有消息广播给所有消费者，现在我们想要扩展使其可以根据消息的严重性过滤消息。例如，我们希望将日志消息写入磁盘的脚本仅接收严重错误的消息，而不是在警告或者信息类型的消息上浪费磁盘空间。

之前我们使用的是fanout交换器，它没有给我们足够的灵活性 - 它只能进行无意识的广播。

现在我们要用direct交换器替换它，direct交换器背后的路由算法很简单 - 消息会进入其binding key恰好与routing key相匹配的队列。

为了说明这一点，请参考以下设置：

在上面的设置中，我们可以看到direct交换器X与两个队列绑定。第一个队列通过键orange绑定，第二个队列有两个绑定，一个通过键black绑定、另外一个通过键green绑定。

如此设置，发布使用路由键orange的消息到交换器最终会被路由到队列Q1，路由键为black或green的消息会去向队列Q2，而其他所有的消息会被丢弃。

多重绑定

使用相同的绑定键绑定多个队列是完全合法的。在示例中，我们可以在X和Q1之间添加一个键为black的绑定。这种情况下，direct交换器会像fanout交换器一样，把消息广播到所有匹配的队列，路由键为black的消息会被分别发送到队列Q1和Q2。

发送日志

我们将在日志系统中使用上述消息模型，在发送消息时使用direct交换机来替换fanout交换器。同时我们会把日志的严重性作为路由键，这样的话，接收脚本就可以选择性地接收它期望严重性的消息。首先我们来关注如何发送日志。

同样地，我们需要先创建一个交换器：

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

准备好发送消息：

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

channel.BasicPublish(exchange: "direct_logs",

                     routingKey: severity,

                     basicProperties: null,

                     body: body);

简单起见，我们先假定severity可以是info、warning或error任意一值。

组合在一起

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 > 0) ? args[0] : "info";

            var message = (args.Length > 1)

                          ? string.Join(" ", args.Skip(1).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 < 1)

            {

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

                                        Environment.GetCommandLineArgs()[0]);

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

                Console.ReadLine();

                Environment.ExitCode = 1;

                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,

                                 autoAck: true,

                                 consumer: consumer);

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

            Console.ReadLine();

        }

    }

}

请像往常一样创建项目（请参阅教程[1]）。

如果您想将warning和error（不包括info）日志消息保存到文件，只需打开控制台并输入：

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

例如，想要发出error日志消息，只需要输入：

cd EmitLogDirect

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

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

EmitLogDirect.cs 和 ReceiveLogsDirect.cs 的完整源代码。

跳转到教程[5]，了解如何基于模式监听消息。

写在最后

本文翻译自 RabbitMQ 官方教程 C# 版本。如本文介绍内容与官方有所出入，请以官方最新内容为准。水平有限，翻译的不好请见谅，如有翻译错误还请指正。

原文链接：RabbitMQ tutorial - Routing
实验环境：RabbitMQ 3.7.4 、.NET Core 2.1.3、Visual Studio Code
最后更新：2018-08-31