.Net RabbitMQ实战指南——客户端开发

开发中关键的Class和Interface有Channel、Connection、ConnectionFactory、Consumer等，与RabbitMQ相关的开发工作，基本上是围绕Connection和Channel这两个类展开的。

连接RabbitMQ

一个Connection可以创建多个Channel实例，但Channel实例不能在线程间共享，应用程序应该为每一个线程开辟一个Channel。

Channel或者Connection中有个isOpen方法可以用来检测其是否已处于开启状态。但并不推荐使用，这个方法的返回值依赖于shutdownCause的存在，有可能会产生竞争。更多的是捕获ShutdownSignalException，IOException或SocketException等异常判断RabbitMq的连接状态。

实际操作过程中遇到BrokerUnreachableException异常

因为我使用的账号是guest，guest账号默认是不支持远程连接，需要在http://localhost:15672（前提是安装了web插件）的Admin选项卡中添加一个新用户（或者使用命令行添加）。

安装web插件

rabbitmq-plugins enable rabbitmq_management

添加新用户：

sudo rabbitmqctl add_user  user_admin  passwd_admin

如上图所示，新添加的用户没有任何权限，需要点击用户名设置权限。

示例代码：

var factory = new ConnectionFactory {
    HostName = "localhost",   //主机名
    UserName = "mymq",        //默认用户名
    Password = "123456",      //默认密码
    RequestedHeartbeat = TimeSpan.FromSeconds(30)
};

using (var connection = factory.CreateConnection())//连接服务器
{
    //创建一个通道
    using (var channel = connection.CreateModel())
    {
        channel.QueueDeclare("stacking", false, false, false, null);//创建消息队列
        var properties = channel.CreateBasicProperties();
        properties.DeliveryMode = 1;
        string message = "RabbitMQ Test"; //传递的消息内容
        channel.BasicPublish("", "stacking", properties, Encoding.UTF8.GetBytes(message)); //生产消息
        Console.WriteLine($"Send:{message}");
    }
}

在管理界面处看到消息插入成功

使用新加的账号链接MQ还会提示BrokerUnreachableException异常，很纳闷。折腾了半天把WSL升级到WSL2就链接成功。

交换器和队列

交换器和队列是应用层面的构建模块，使用前应对其进行声明确保其存在。

 var exchangeName = "exchange_name";
 channel.ExchangeDeclare(exchangeName, "direct", true);//创建一个持久化的、非自动删除的、绑定类型为direct的交换器
 var queueName = channel.QueueDeclare().QueueName;   //创建一个非持久化的、排他的、自动删除的队列(队列名由RabbitMQ自动生成)
 channel.QueueBind(queueName, exchangeName, "routing_key");  //使用路由键(routing_key)将队列和交换器绑定

 channel.QueueDeclare("queue_name", true);   // QueueDeclare拥有多个重载

ExchangeDeclare方法详解

各个参数详细说明如下：

exchange：交换器的名称。

type：交换器的类型，常见的如fanout、direct、topic。

durable：设置是否持久化。durable设置为true表示持久化，反之是非持久化。持久化可以将交换器存盘，在服务器重启的时候不会丢失相关信息。

autoDelete：设置是否自动删除。autoDelete设置为true则表示自动删除。自动删除的前提是至少有一个队列或者交换器与这个交换器绑定，之后所有与这个交换器绑定的队列或者交换器都与此解绑才会删除。

internal：设置是否是内置的。如果设置为true，则表示是内置的交换器，客户端程序无法直接发送消息到这个交换器中，只能通过交换器路由到交换器这种方式。

argument：其他一些结构化参数

QueueDeclareNoWait方法实现设置了一个nowait参数（AMQP中Exchange.Declare命令的参数），意思是不需要等待服务区返回结果。

ExchangeDeclarePassive方法用来检测相应的交换器是否存在。如果存在则正常返回；如果不存在则抛出异常。

QueueDeclare方法详解

方法的参数详细说明如下:

queue：队列的名称。

durable：设置是否持久化。为true则设置队列为持久化。持久化的队列会存盘，在服务器重启的时候可以保证不丢失相关信息。

exclusive：设置是否排他。为true则设置队列为排他的。

autoDelete：设置是否自动删除。为true则设置队列为自动删除。自动删除的前提是：至少有一个消费者连接到这个队列，之后所有与这个队列连接的消费者都断开时，才会自动删除。

arguments：设置队列的其他一些参数，如x-message-ttl、x-expires、x-max-length、x-max-length-bytes、x-dead-letter-exchange、x-dead-letter-routing-key、x-max-priority等。

如果一个队列被声明为排他队列，则该队列仅对首次声明它的连接可见，并在连接断开时自动删除。需要注意：排他队列是基于连接（Connection）可见的，同一个连接的不同信道（Channel）可以访问同一连接创建的排他队列；“首次”是指如果一个连接已经声明了一个排他队列，其他连接不允许再建立同名的排他队列；即使该队列是持久化的，一旦连接关闭或客户端退出，该排他队列都会被自动删除，这种队列适用于一个客户端同时发送和读取消息的应用场景。

QueueDeclareNoWait方法实现设置了一个nowait参数，意思是不需要等待服务区返回结果。

QueueDeclarePassive方法用来检测相应的队列是否存在。如果存在则正常返回；如果不存在则抛出异常。

QueueBind方法详解

方法中涉及的参数:

queue：队列名称；

exchange：交换器的名称；

routingKey：用来绑定队列和交换器的路由键；

argument：定义绑定的一些参数。

ExchangeBind方法详解

不仅可以将交换器与队列绑定，也可以将交换器与交换器绑定。绑定之后，消息从source交换器转发到destination交换器

方法中涉及的参数:

destination：目的交换器名；

source：源交换器的名称；

routingKey：用来绑定队列和交换器的路由键；

argument：定义绑定的一些参数。

交换器的使用并不会真正耗费服务器的性能，而队列会。要衡量RabbitMQ当前的QPS只需看队列的即可。

发送消息

BasicPublish方法用来发送一条消息到。为了更好地控制发送，可以使用mandatory这个参数

对应的具体参数解释如下：

exchange：交换器的名称，指明消息需要发送到哪个交换器中。如果设置为空字符串，则消息会被发送到RabbitMQ默认的交换器中。

routingKey：路由键，交换器根据路由键将消息存储到相应的队列之中。

basicProperties：消息的基本属性集，其包含14个属性成员，分别有contentType、contentEncoding、headers（Map&lt；String，Object&gt；）、deliveryMode、priority、correlationId、replyTo、expiration、messageId、timestamp、type、userId、appId、clusterId。

byte[] body：消息体（payload），真正需要发送的消息。

mandatory：设置为true时，如果exchange根据自身类型和消息routeKey无法找到一个符合条件的queue，会调用basic.return方法将消息返还给生产者；设为false时，出现上述情形broker会直接将消息扔掉。

丰富了一下第一部分的代码：

var properties = channel.CreateBasicProperties();
properties.DeliveryMode = 1;
properties.Priority = 2;
properties.ContentType = "text/plain";
properties.Expiration = "60000";
string message = "RabbitMQ Test"; //传递的消息内容
channel.BasicPublish("", "stacking", properties, Encoding.UTF8.GetBytes(message)); //生产消息

消费消息

RabbitMQ的消费模式分两种：推（Push）模式和拉（Pull）模式。推模式采用Basic.Consume进行消费，而拉模式则是调用Basic.Get进行消费。

推模式

推模式接收消息需要实例化一个EventingBasicConsumer类，订阅Received事件来接收消息。EventingBasicConsumer实现了DefaultBasicConsumer类，实际使用中如果不满足需求可以继承该类。

示例代码：

var consumer = new EventingBasicConsumer(channel);
                    consumer.Received += (ch, ea) =>
                    {
                        var body = ea.Body.ToArray();
                        Console.WriteLine($"Received:{Encoding.UTF8.GetString(body)}");
                        channel.BasicAck(ea.DeliveryTag, false);
                    };
                    var consumerTag = channel.BasicConsume("stacking", false, consumer);

BasicConsume方法对应的参数说明如下：

queue：队列的名称；

autoAck：设置是否自动确认。建议设成false，即不自动确认；

consumerTag：消费者标签，用来区分多个消费者；

arguments：设置消费者的其他参数；

callback：设置消费者的回调函数。

BasicConsume返回字符串类型consumerTag，可以通过调用channel.BasicCancel(consumerTag)显式地取消一个消费者的订阅。BasicCancel方法会首先触发HandleConsumerOk方法，之后触发HandleDelivery方法，最后才触发HandleCancelOk方法.

拉模式

拉模式通过channel.BasicGet方法可以单条地获取消息。

示例代码：

var result = channel.BasicGet("stacking",false);
Console.WriteLine($"Received:{Encoding.UTF8.GetString(result.Body.ToArray())}");
channel.BasicAck(result.DeliveryTag, false);

Basic.Consume将信道（Channel）置为接收模式，直到取消队列的订阅，RabbitMQ会不断地推送消息给消费者，当然推送消息的个数还是会受到Basic.Qos的限制。如果只想从队列获得单条消息而不是持续订阅，建议使用Basic.Get进行消费。但是不能将Basic.Get放在一个循环里来代替Basic.Consume，这样做会严重影响RabbitMQ的性能。

消费端的确认与拒绝

为了保证消息从队列可靠地达到消费者，RabbitMQ提供了消息确认机制（message acknowledgement）。消费者在订阅队列时指定autoAck参数，当autoAck为false时，RabbitMQ会等待消费者显式地回复确认信号后才从内存（或者磁盘）中移去消息（实质上是先打上删除标记，之后再删除）。当autoAck为true时，RabbitMQ会自动把发送出去的消息置为确认，然后从内存（或者磁盘）中删除，而不管消费者是否真正地消费到了这些消息。

当autoAck参数设置为false，消费者就有足够的时间处理消息（任务），不用担心处理消息过程中消费者进程挂掉后消息丢失的问题。

当autoAck参数设置为false，对于RabbitMQ服务端而言，队列中的消息分为两部分：一部分是等待投递给消费者的消息；一部分是已投递给消费者，但是还没有收到消费者确认信号的消息。如果RabbitMQ一直没有收到消费者的确认信号，并且此消息的消费者断开连接，则RabbitMQ会安排该消息重新进入队列，等待投递给下一个消费者（可能还是原来的那个消费者 ），并且RabbitMQ不会为未确认的消息设置过期时间。

消费消息时autoAck参数设置为false需要主动调用channel.BasicAck对消息进行确认，以便RabbitMQ删除消息，对应的也可以调用channel.BasicReject方法拒绝消息，由其他消费端处理或者丢弃。

deliveryTag可以看作消息的编号。如果requeue参数设置为true，则RabbitMQ会重新将这条消息存入队列；如果requeue参数设置为false，则RabbitMQ立即会把消息从队列中移除，不会把它发送给新的消费者。

Basic.Reject命令一次只能拒绝一条消息，如果想要批量拒绝消息，则可以使用Basic.Nack这个命令，对应的实现方法为channel.BasicNack.

其中deliveryTag和requeue的含义可以参考BasicReject方法。multiple参数设置为false则表示仅拒绝编号为deliveryTag的单条消息；multiple参数设置为true则表示拒绝deliveryTag编号之前所有未被当前消费者确认的消息。

channel.BasicReject或者channel.BasicNack中的requeue设置为false，可以启用“死信队列”的功能。死信队列可以通过检测被拒绝或者未送达的消息来追踪问题。

关闭连接

可以显示的调用Connection和Channel的Close方法来关闭连接，也可以借助using来管理连接。

Connection和Channel所具备的生命周期如下：

Open：开启状态，代表当前对象可以使用。

Closing：正在关闭状态。当前对象被显式地通知调用关闭方法（shutdown），这样就产生了一个关闭请求让其内部对象进行相应的操作，并等待这些关闭操作的完成。

Closed：已经关闭状态。当前对象已经接收到所有的内部对象已完成关闭动作的通知，并且其也关闭了自身。

在Connection和Channel中都定义了对应实现监听状态的改变。

Connection

Channel

Github

示例代码地址：https://github.com/MayueCif/RabbitMQ