Skip to content

Spring JMS(ActiveMQ) delayed delivery of messages

We’re trying to set a delay on some JMS messages, so that a message will only be added to the queue/ received by the listener after x time. So far we’ve tried 2 approaches that didn’t work.

1) According to the spring documentation, we can set the delivery delay on the JMSTemplate. This is the sample code we tried:

private JmsTemplate jmsTemplate;

long deliveryDelay = ...;

However, we get the following exception, even though our spring jms version is 4.0.5:

java.lang.IllegalStateException: setDeliveryDelay requires JMS 2.0

2) We also tried setting the delay on the message itself, but it looks like the delay was ignored, and the message was delivered immediately anyway.

public class MyMessageConverter implements MessageConverter {


public Message toMessage(Object eventObject, Session session) throws JMSException, MessageConversionException {

long deliveryDelay = ...;
return objectMessage;

The jmsTemplate definition in the spring xml:

<bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">
    <property name="connectionFactory" ref="cachingConnectionFactory" />
    <property name="messageConverter" ref="myMessageConverter" />
    <property name="sessionTransacted" value="true" />

Does anyone has any suggestions on what the problems are / other ideas on how to achieve delayed messaging? Thanks!



The comments give the answer. By default scheduled message support is disabled. You must enabled it in the broker XML configuration file as mentioned on the documentation page.

An example Broker tag with scheduler support enabled:

<broker xmlns="" brokerName="localhost" dataDirectory="${}" schedulerSupport="true">

You must of course restart the broker in order for configuration changes to take affect. Then when you send a message you need to add the JMS headers that tell the broker what type of delay you want.

message.setIntProperty(ScheduledMessage.AMQ_SCHEDULED_DELAY, scheduledDelay);
User contributions licensed under: CC BY-SA
2 People found this is helpful