(本教程是使用Net客户端,也就是针对微软技术平台的)
在前一个教程中,我们创建了一个工作队列。工作队列背后的假设是每个任务会被交付给一个【工人】。在这一部分我们将做一些完全不同的事情--我们将向多个【消费者】传递信息。这种模式被称为“发布/订阅”。
为了说明这种模式,我们将构建一个简单的日志系统。它将包括两个程序,第一个将发出日志消息,第二个将接收并打印它们。
在我们的日志系统中每个接收程序的运行副本都会得到消息。这样我们就可以运行一个接收者程序,将日志记录到磁盘;同时我们可以运行另一个接收者程序,并在屏幕上看到打印出来的日志。
从本质上讲,已发布的日志消息将被广播到所有的接收者程序。
1、消息交换机【Exchange】
在教程的前面部分,我们从队列中发送和接收消息。在RabbitMQ中,现在是时候引入全消息模型。
让我们快速看看我们以前的教程讲了什么:
【生产者】:就是一个用于发送消息的用户程序
【消费者】:就是一个用于接收和使用消息的用户程序
【队列】:是一个暂存消息的缓存区
RabbitMQ消息传递模型的核心思想是,【生产者】不直接发送任何信息到队列。事实上,【生产者】根本就不知道消息是否会被传送到任何队列。
相反,【生产者】只能发送消息到【消息交换机】。交换是件很简单的事。一方面它接收来自【生产者】的消息,另一方面是将接收到消息推送到队列中。【消息交换机】必须知道它如何处理接收消息的确切方法。是否应该发送到特定队列?它应该被发送到多个队列呢?或者它应该被丢弃。该规则由【消息交换机】的类型来定义。
这里有一些可用的【消息交换机】的类型:【Direct】直接,【Topic】主题,【Headers】标题和【Fanout】扇出。我们将集中关注最后一个-【Fanout】扇出。让我们创建一个这种类型的【消息交换机】,并给它命名为Logs:
channel.ExchangeDeclare("logs", "fanout");
【Fanout】类型的【消息交换机】非常简单。正如你从名字可能猜出的,它只是传播它收到的所有消息去它知道所有的队列中。这正是我们需要我们的日志记录器。
显示【消息交换机】的列表:
使用Rabbitmqctl列出在服务器上可以运行的最有用的【消息交换机】
sudo rabbitmqctl list_exchanges
在这个列表中会有一些amq.*【消息交换机】和默认(未命名)消息交换机。这些都是默认创建的,但现在不太可能需要使用它们。
默认的消息交换机
在教程前面的部分我们队【消息交换机】是一无所知,但是我依然可以发送消息去想去的队列,那是因为我们使用了默认的【消息交换机】,这些默认的消息 交换机我用使用两个双引号“”来标识。
我们回忆一下以前是如何发送消息的:
var message = GetMessage(args); var body = Encoding.UTF8.GetBytes(message); channel.BasicPublish(exchange: "", routingKey: "hello", basicProperties: null, body: body);
第一个参数是【消息交换机】的名称。空字符串表示默认或未命名的消息交换机:消息会被路由到指定的routingkey名称的队列,如果它存在的话。
现在,我们可以发布到我们命名的【消息交换机】:
var message = GetMessage(args); var body = Encoding.UTF8.GetBytes(message); channel.BasicPublish(exchange: "logs", routingKey: "", basicProperties: null, body: body);
2、临时队列
也许你还记得以前我们使用的队列所指定的名称(记得Hello和task_queue吗?)对我们来说,能够给一个队列指定名称是至关重要的--因为我们需要把【Worker】指向同一个队列。如果要在【生产者】和【消费者】之间共享队列,给队列命名是很重要的。
但这不是我们的日志记录器的情况。我们想听到所有的日志消息,而不仅仅是其中的一个子集。我们也只对当前刚刚收到的消息感兴趣,而不是对旧的。为了解决上述问题,我们需要做两件事。
首先,无论何时当我们连接到Rabbit的时候,我们都需要一个新的并且是空的队列。要做到这一点,我们可以创建一个具有随机名称的队列,或者,甚至更好一点-让服务器为我们选择一个随机队列名称。
其次,一旦我们断开与【消费者】的队列就应该自动删除该队列。
在.NET客户端中,当我们没有为queueDeclare()提供参数时,我们创建了一个具有生成名称的非持久,排他,自动删除队列:
var queueName = channel.QueueDeclare().QueueName;
在这点上,QueueName包含随机队列名称。例如,它可能看起来像amq.gen-jzty20brgko-hjmujj0wlg。
3、绑定【Binding】
我们已经创建了一个【Fanout】类型的【消息交换机】和队列。现在我们需要告诉【消息交换机】向我们的队列发送消息。【消息交换机】和【队列】之间的关系称为绑定。
channel.QueueBind(queue: queueName, exchange: "logs", routingKey: "");
从现在开始,日志的【消息交换机】就可以将消息推送到我们定义的队列中去了。
我们可以通过以下语句查看【binding】列表数据:
rabbitmqctl list_bindings
4、把所有的代码整合到一起
【生产者】的程序,它发出的日志消息,看起来并没有和以前的教程有很大的不同。最重要的变化是,我们现在想发送的消息是到达我们指定名称的日志【消息交换机】,而不是无名的。我们在发送消息的时候需要提供一个routingkey表示的名称,但【Fanout】类型的【消息交换机】会容忽视该routingKey的值的。这里有EmitLog.cs文件代码:
1 using System; 2 using RabbitMQ.Client; 3 using System.Text; 4 5 class EmitLog 6 { 7 public static void Main(string[] args) 8 { 9 var factory = new ConnectionFactory() { HostName = "localhost" }; 10 using(var connection = factory.CreateConnection()) 11 using(var channel = connection.CreateModel()) 12 { 13 channel.ExchangeDeclare(exchange: "logs", type: "fanout"); 14 15 var message = GetMessage(args); 16 var body = Encoding.UTF8.GetBytes(message); 17 channel.BasicPublish(exchange: "logs", 18 routingKey: "", 19 basicProperties: null, 20 body: body); 21 Console.WriteLine(" [x] Sent {0}", message); 22 } 23 24 Console.WriteLine(" Press [enter] to exit."); 25 Console.ReadLine(); 26 } 27 28 private static string GetMessage(string[] args) 29 { 30 return ((args.Length > 0) 31 ? string.Join(" ", args) 32 : "info: Hello World!"); 33 } 34 }
(EmitLog.cs 的源码)
如你所见,在建立连接后,我们声明了【消息交换机】。此步骤是必要的,因为对非存在【消息交换机】的发送是被禁止的。
如果没有队列绑定到【消息交换机】,消息将会丢失,但对我们来说没有问题;如果没有【消费者】正在侦听,我们可以安全地丢弃消息。
以下是ReceiveLogs.cs的代码:
1 using System; 2 using RabbitMQ.Client; 3 using RabbitMQ.Client.Events; 4 using System.Text; 5 6 class ReceiveLogs 7 { 8 public static void Main() 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: "logs", type: "fanout"); 15 16 var queueName = channel.QueueDeclare().QueueName; 17 channel.QueueBind(queue: queueName, 18 exchange: "logs", 19 routingKey: ""); 20 21 Console.WriteLine(" [*] Waiting for logs."); 22 23 var consumer = new EventingBasicConsumer(channel); 24 consumer.Received += (model, ea) => 25 { 26 var body = ea.Body; 27 var message = Encoding.UTF8.GetString(body); 28 Console.WriteLine(" [x] {0}", message); 29 }; 30 channel.BasicConsume(queue: queueName, 31 noAck: true, 32 consumer: consumer); 33 34 Console.WriteLine(" Press [enter] to exit."); 35 Console.ReadLine(); 36 } 37 } 38 }
(ReceiveLogs.cs 的源码)
按照教程一的安装说明生成的EmitLogs和ReceiveLogs两个项目文件。
如果要将日志保存到文件,只需打开控制台并键入:
cd ReceiveLogs dotnet run > logs_from_rabbit.log
如果你希望看到你的屏幕上的日志,生成一个新的终端和运行:
cd ReceiveLogs dotnet run
当然,要发送日志类型:
cd EmitLog dotnet run
使用rabbitmqctl list_bindings可以验证代码确实创建了我们想要的【绑定】和【队列】。运行两个ReceiveLogs.cs程序时,您应该看到如下所示:
rabbitmqctl list_bindings # => Listing bindings ... # => logs exchange amq.gen-JzTY20BRgKO-HjmUJj0wLg queue [] # => logs exchange amq.gen-vso0PVvyiRIL2WoV3i48Yg queue [] # => ...done.
对结果的解释很简单:来自【消息交换机】日志的数据转到具有服务器分配名称的两个队列。 这正是我们的意图。
好了,终于翻译了第三篇教程了,翻译的不好,请见谅。如有大家英文比较好可以查看原文地址:http://www.rabbitmq.com/tutorials/tutorial-three-dotnet.html