Java Message Service, 2nd Edition

Name

JMSExpiration — Purpose: Routing

A Message object can have an expiration date, the same as on a carton of milk. The expiration date is useful for messages that are only relevant for a fixed amount of time. The expiration time for messages is set in milliseconds by the producer using the setTimeToLive() method on either the QueueSender or TopicPublisher as shown below:

// Publish-and-subscribe
TopicPublisher topicPublisher = topicSession.createPublisher(topic);
// Set time to live as 1 hour (1000 millis x 60 sec x 60 min)
topicPublisher.setTimeToLive(3600000);

// Point-to-point
QueueSender queueSender = queueSession.createSender(topic);
// Set time to live as 2 days (1000 millis x 60 sec x 60 min x 48 hours)
queueSender.setTimeToLive(172800000);            

By default the timeToLive is zero, which indicates that the message doesn’t expire. Calling setTimeToLive() with a zero value as the argument ensures that message is created without an expiration date. The message expiration can also be set on the send() or publish() method of the message producer as well:

// Publish-and-subscribe
// Set time to live as 1 hour (1000 millis x 60 sec x 60 min)
Message message = topicSession.createMessage();
topicPublisher.publish(message, DeliveryMode.PERSISTENT, 5, 3600000);

// Point-to-point
// Set time to live as 2 days (1000 millis x 60 sec x 60 min x 48 hours)
Message message = queueSession.createMessage();
queueSender.send(message, DeliveryMode.NON_PERSISTENT, 5, 172800000);

The JMSExpiration date itself ...