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 :