4.7.5. Subscribe to a Direct Exchange

Subscribing to the Default Exchange using a Copy of Messages

This is the most straight-forward method to implement. Create a receiver using an address comprised of the exchange name and the routing key. For example, create a receiver on direct exchange "finance" using the "reports" key of interest:

C++
Receiver receiver = session.createReceiver("finance/reports")
Python
receiver = session.receiver('finance/reports')
Subscribing to a Direct Exchange using a Shared Queue

Subscription using a shared queue may be created by naming the subscription queue and defining it non-exclusive. For example:

C++
Receiver receiver = session.createReceiver("finance/quick-publish;{link:{name:my-subscription, x-declare:{exclusive:False}}}");
Python
receiver = session.receiver('finance/quick-publish;{link:{name:my-subscription, x-declare:{exclusive:False}}}')
Alternatively, you may create a queue and bind it to the direct exchange using a routing key. You can do that using x-bindings. For example:
C++
Receiver receiver = session.createReceiver("my-subscription;{create: always, node:{x-bindings: [{exchange: 'finance', key: 'quick-publish'}]}}");
Python
receiver = session.receiver('my-subscription;{create: always, node:{x-bindings: [{exchange: 'finance', key: 'quick-publish'}]}}')
We have created a shared queue named "my-subscription" and bound it to the direct exchange "finance" with the key "quick-publish".
AMQP 1.0

Both Link-scoped x-declare and Node-scoped x-bindings clauses are not supported in AMQP 1.0, hence we request the capability of a shared subscription:

C++
Receiver receiver = session.createReceiver("finance/quick-publish;{node: {capabilities:[shared]}, link: {name: 'my-subscription'}}");

See Also:

Report a bug