Destination Options

Features > Destination Features > Destination Options

Background

Destination Options are a way to provide extended configuration options to a JMS consumer without having to extend the JMS API. The options are encoded using URL query syntax in the destination name that the consumer is created on.

Consumer Options

Option Name Default Value Description
consumer.dispatchAsync true Should the broker dispatch messages asynchronously to the consumer.
consumer.exclusive false Is this an Exclusive Consumer.
consumer.maximumPendingMessageLimit 0 Use to control if messages for non-durable topics are dropped if a slow consumer situation exists.
consumer.noLocal false Same as theĀ noLocal flag on a Topic consumer. Exposed here so that it can be used with a queue.
consumer.prefetchSize n/a The number of message the consumer will prefetch.
consumer.priority 0 Allows you to configure a Consumer Priority.
consumer.retroactive false Is this a Retroactive Consumer.
consumer.selector null JMS Selector used with the consumer.

Example

queue = new ActiveMQQueue("TEST.QUEUE?consumer.dispatchAsync=false&consumer.prefetchSize=10");
consumer = session.createConsumer(queue);

Apache, ActiveMQ, Apache ActiveMQ, the Apache feather logo, and the Apache ActiveMQ project logo are trademarks of The Apache Software Foundation. Copyright © 2024, The Apache Software Foundation. Licensed under Apache License 2.0.