RabbitMQ队列声明channel.queueDeclare()参数解析

channel.queueDeclare(String queue, boolean durable, boolean exclusive, boolean autoDelete, Map<String, Object> arguments)

1. queue: 队列的名称 ;

2. durable: 是否持久化 ;

当durable = false时,队列非持久化。因为队列是存放在内存中的,所以当RabbitMQ重启或者服务器重启时该队列就会丢失 ;
当durable = true时,队列持久化。当RabbitMQ重启后队列不会丢失。RabbitMQ退出时它会将队列信息保存到 Erlang自带的Mnesia数据库 中,当RabbitMQ重启之后会读取该数据库 ;
3. exclusive: 是否排外的 ;

当exclusive = true则设置队列为排他的。如果一个队列被声明为排他队列,该队列 仅对首次声明它的连接(Connection)可见,是该Connection私有的,类似于加锁,并在连接断开connection.close()时自动删除 ;
当exclusive = false则设置队列为非排他的,此时不同连接(Connection)的管道Channel可以使用该队列 ;
注意2点:

排他队列是 基于连接(Connection) 可见的,同个连接(Connection)的不同管道 (Channel) 是可以同时访问同一连接创建的排他队列 。其他连接是访问不了的 ,强制访问将报错:com.rabbitmq.client.ShutdownSignalException: channel error; protocol method: #method<channel.close>(reply-code=405, reply-text=RESOURCE_LOCKED - cannot obtain exclusive access to locked queue 'hello-testExclusice' in vhost '/'.;以下声明是没问题的:

Channel channel = connection.createChannel();
    Channel channel2 = connection.createChannel();
    channel.queueDeclare(QUEUE_NAME, false, true, false, null);
    channel2.queueDeclare(QUEUE_NAME, false, true, false, null);

    =》如果是不同的 connection 创建的 channel 和 channel2,那么以上的
    =》channel2.queueDeclare()是会报错的!!!!!!

"首次" 是指如果某个连接(Connection)已经声明了排他队列,其他连接是不允许建立同名的排他队列的。这个与普通队列不同:即使该队列是持久化的(durable = true),一旦连接关闭或者客户端退出,该排他队列都会被自动删除,这种队列适用于一个客户端同时发送和读取消息的应用场景。
4. autoDelete: 是否自动删除 ;如果autoDelete = true,当所有消费者都与这个队列断开连接时,这个队列会自动删除。注意: 不是说该队列没有消费者连接时该队列就会自动删除,因为当生产者声明了该队列且没有消费者连接消费时,该队列是不会自动删除的。

5. arguments: 设置队列的其他一些参数,如 x-rnessage-ttl 、x-expires 、x-rnax-length 、x-rnax-length-bytes、 x-dead-letter-exchange、 x-deadletter-routing-key 、 x-rnax-priority 等。

1、x-max-length:

消息条数限制,该参数是非负整数值。限制加入queue中消息的条数。先进先出原则,超过10条后面的消息会顶替前面的消息。

2、x-max-length-bytes

 消息容量限制,该参数是非负整数值。该参数和x-max-length目的一样限制队列的容量,但是这个是靠队列大小(bytes)来达到限制。

3、x-message-ttl

 消息存活时间,该参数是非负整数值.创建queue时设置该参数可指定消息在该queue中待多久,可根据x-dead-letter-routing-key和x-dead-letter-exchange生成可延迟的死信队列。

4、x-max-priority

 消息优先级,创建queue时arguments可以使用x-max-priority参数声明优先级队列 。该参数应该是一个整数,表示队列应该支持的最大优先级。建议使用1到10之间。目前使用更多的优先级将消耗更多的资源(Erlang进程)。

 设置该参数同时设置死信队列时或造成已过期的低优先级消息会在未过期的高优先级消息后面执行。该参数会造成额外的CPU消耗。

5、x-expires

存活时间,创建queue时参数arguments设置了x-expires参数,该queue会在x-expires到期后queue消息,亲身测试直接消失(哪怕里面有未消费的消息)。

6、x-dead-letter-exchange和x-dead-letter-routing-key

创建queue时参数arguments设置了x-dead-letter-routing-key和x-dead-letter-exchange,会在x-message-ttl时间到期后把消息放到x-dead-letter-routing-key和x-dead-letter-exchange指定的队列中达到延迟队列的目的。

创建queue的时候,就可以设置以上参数

@Bean
    public Queue queue() {
        Map<String, Object> arguments = new HashMap<>();
        //消息条数限制,该参数是非负整数值。限制加入queue中消息的条数。先进先出原则,超过10条后面的消息会顶替前面的消息。
        arguments.put("x-max-length", 10);
        //消息容量限制,该参数是非负整数值。该参数和x-max-length目的一样限制队列的容量,但是这个是靠队列大小(bytes)来达到限制。
        arguments.put("x-max-length-bytes", 1024);
  
        /**
         * 消息存活时间,该参数是非负整数值.创建queue时设置该参数可指定消息在该queue中待多久,
         * 可根据x-dead-letter-routing-key和x-dead-letter-exchange生成可延迟的死信队列。
         */
        arguments.put("x-message-ttl", 10000);
         * 消息优先级,创建queue时arguments可以使用x-max-priority参数声明优先级队列 。该参数应该是一个整数,表示队列应该支持的最大优先级。
         * ​​建议使用1到10之间。目前使用更多的优先级将消耗更多的资源(Erlang进程)。
         * 设置该参数同时设置死信队列时或造成已过期的低优先级消息会在未过期的高优先级消息后面执行。
         * 该参数会造成额外的CPU消耗。
        arguments.put("x-max-priority", 5);
         * 存活时间,创建queue时参数arguments设置了x-expires参数,该queue会在x-expires到期后queue消息,
         * 亲身测试直接消失(哪怕里面有未消费的消息)。
        arguments.put("x-expires", 60000);
         * 创建queue时参数arguments设置了x-dead-letter-routing-key和x-dead-letter-exchange,
         * 会在x-message-ttl时间到期后把消息放到x-dead-letter-routing-key和x-dead-letter-exchange指定的队列中达到延迟队列的目的。
        arguments.put("x-dead-letter-exchange", "TopExchangeName");
        arguments.put("x-dead-letter-routing-key", "ttl.*.value");//这里的routing-key也可以是队列名称,当消息过期后会转发到这个exchange对应的routing-key,达到延时队列效果
        return new Queue(topDDL, true, false, false, arguments); //队列持久
    }

 

 
posted @ 2022-05-11 23:44  yl_diao  阅读(1521)  评论(1编辑  收藏  举报