The Spring Framework

Interface SessionAwareMessageListener

All Known Implementing Classes:
JmsInvokerServiceExporter, MessageListenerAdapter, MessageListenerAdapter102

public interface SessionAwareMessageListener

Variant of the standard JMS MessageListener interface, offering not only the received Message but also the underlying JMS Session object. The latter can be used to send reply messages, without the need to access an external Connection/Session, i.e. without the need to access the underlying ConnectionFactory.

Supported by Spring's DefaultMessageListenerContainer, SimpleMessageListenerContainer and ServerSessionMessageListenerContainer, as direct alternative to the standard JMS MessageListener interface. Typically not supported by JCA-based listener containers: For maximum compatibility, implement a standard JMS MessageListener instead.

Juergen Hoeller
See Also:
AbstractMessageListenerContainer.setMessageListener(java.lang.Object), DefaultMessageListenerContainer, SimpleMessageListenerContainer, ServerSessionMessageListenerContainer, MessageListener

Method Summary
 void onMessage(Message message, Session session)
          Callback for processing a received JMS message.

Method Detail


void onMessage(Message message,
               Session session)
               throws JMSException
Callback for processing a received JMS message.

Implementors are supposed to process the given Message, typically sending reply messages through the given Session.

message - the received JMS message (never null)
session - the underlying JMS Session (never null)
JMSException - if thrown by JMS methods

The Spring Framework

Copyright © 2002-2007 The Spring Framework.