09、RabbitMQ 实战 - 消息的参数详解

上篇文章讲了声明一个队列时的参数设置,这篇文章主要说一说发布消息时的参数设置.

发布消息时的完整入参是这样的:

channel.BasicPublish
    (
    exchange: "test_exchange",
    routingKey: "",
    mandatory: false,
    basicProperties: null,
    body: Encoding.Default.GetBytes(msg)
    );

exchange: 交换机名称

routingKey:路由键

路由键的设置跟交换机的类型有关.

• 如果交换机的类型是"fanout",那么不管这个参数传入的是啥,哪怕是个空字符串(不能是null),也不管与这个交换机绑定的队列到底有没有设置路由键,设置的是什么.通通当它们不存在.所有绑定到该交换机的队列都会收到消息;
• 如果交换机的类型是"direct"或者"topic",那么这个参数才有意义.

mandatory:

• 当为true时,如果exchange根据自身类型和第2个参数(routeKey)无法找到一个符合条件的queue,那么会将消息返还给生产者;
• 当为false时,出现上述情形broker会直接将消息扔掉.

测试:

生产者

public class Producer
{
    private const string QueueName = "test_queue";
    private const string ExchangeName = "test_exchange";

    public static void Send()
    {         
        using (IConnection connection = ConnectionHelper.GetConnection())
        using (IModel channel = connection.CreateModel())
        {
            channel.BasicQos(0, 1, false);

            channel.BasicReturn += (s, e) =>
            {
                byte[] bytes = e.Body;
                string str = Encoding.Default.GetString(bytes);
                Console.WriteLine("return message : " + str);
            };

            string msg = "hello world ";
            channel.BasicPublish
                (
                exchange: ExchangeName,
                routingKey: "找不到匹配的队列",
                mandatory: true,
                basicProperties: null,
                body: Encoding.Default.GetBytes(msg)
                );

            Console.WriteLine($"send {msg}");
        }
    }
}

运行结果:

basicProperties:消息的基本属性

该参数是一个 IBasicProperties 类型的对象,具体有哪些属性,我们可以看源代码,不过我觉得通过管理后台来了解这些参数,更直观一些.

实在是有点多啊!

• content_type 消息内容的类型,如 "application/json"
• content_encoding 消息内容的编码格式
• priority 消息的优先级,上面文章已经讲过了.
• correlation_id 用于将RPC响应与请求相关联.
• reply_to 回调队列
• expiration 消息过期时间,单位毫秒.该参数值优先级>队列参数设置中的消息生存期
• message_id 消息id
• timestamp 消息的时间戳
• type： 类型
• user_id: 用户id
• app_id： 应用程序id
• cluster_id: 集群id

有两个属性,persistent 和 DeliveryMode ,它们的作用是一样的.

Persistent : true 表示消息持久化.当然,前提是队列也必须持久化.

管理后台可以直接设置 DeliveryMode :