In this example we are showing how to manage unroutable messages. An unroutable message is a message without a destination. For example, a message sent to an exchange without any bound queue.
Unroutable messages are not similar to dead letter messages; the first are messages sent to an exchange without any suitable queue destination. The latter, on the other hand, reach a queue but are rejected because of an explicit consumer decision, expired TTL, or exceeded queue length limit. You can find the source at Chapter01/Recipe13/Java_13/
.
To use this recipe you will need to set up the Java development environment as indicated in the Introduction section.
In order to handle unroutable messages, you need to perform the following steps:
First of all we need to implement the class
ReturnListener
and its interface:public class HandlingReturnListener implements ReturnListener @Override public void handleReturn…
Add the
HandlingReturnListener
class to the channelReturnListener
:channel.addReturnListener(new HandlingReturnListener());
Then create an exchange:
channel.exchangeDeclare(myExchange, "direct", false, false, null);
And finally publish a mandatory message to the exchange:
boolean isMandatory = true; channel.basicPublish(myExchange, "",isMandatory, null, message.getBytes());
When we execute the publisher, the messages sent to myExchange
won't reach any destination since it has no bound queues. However, these messages aren't, they are redirected to an internal queue. The HandlingReturnListener
class will handle such messages using handleReturn()
.
The ReturnListener
class is bound to a publisher channel, and it will trap only its own unroutable messages.
You can also find a consumer in the source code example. Try also to execute the publisher and the consumer together, and then stop the consumer.