org.springframework.jms.support.converter

Class MessagingMessageConverter

java.lang.Object

org.springframework.jms.support.converter.MessagingMessageConverter

All Implemented Interfaces:

org.springframework.beans.factory.InitializingBean, MessageConverter

public class MessagingMessageConverter
extends Object
implements MessageConverter, org.springframework.beans.factory.InitializingBean

Convert a Message from the messaging abstraction to and from a Message using an underlying MessageConverter for the payload and a JmsHeaderMapper to map the JMS headers to and from standard message headers.

Since:

4.1

Author:

Stephane Nicoll

Constructor Summary

Constructors

Constructor and Description
MessagingMessageConverter() Create an instance with a default payload converter.
MessagingMessageConverter(MessageConverter payloadConverter, JmsHeaderMapper headerMapper) Create an instance with the specified payload converter and header mapper.

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet()
protected javax.jms.Message	createMessageForPayload(Object payload, javax.jms.Session session) Deprecated. as of 4.3, use createMessageForPayload(Object, Session, Object)
protected javax.jms.Message	createMessageForPayload(Object payload, javax.jms.Session session, Object conversionHint) Create a JMS message for the specified payload and conversionHint.
protected org.springframework.messaging.MessageHeaders	extractHeaders(javax.jms.Message message)
protected Object	extractPayload(javax.jms.Message message) Extract the payload of the specified Message.
Object	fromMessage(javax.jms.Message message) Convert from a JMS Message to a Java object.
void	setHeaderMapper(JmsHeaderMapper headerMapper) Set the JmsHeaderMapper to use to map JMS headers to and from standard message headers.
void	setPayloadConverter(MessageConverter payloadConverter) Set the MessageConverter to use to convert the payload.
javax.jms.Message	toMessage(Object object, javax.jms.Session session) Convert a Java object to a JMS Message using the supplied session to create the message object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MessagingMessageConverter

public MessagingMessageConverter()

Create an instance with a default payload converter.

See Also:

SimpleMessageConverter, SimpleJmsHeaderMapper

MessagingMessageConverter

public MessagingMessageConverter(MessageConverter payloadConverter,
                                 JmsHeaderMapper headerMapper)

Create an instance with the specified payload converter and header mapper.

Method Detail

setPayloadConverter

public void setPayloadConverter(MessageConverter payloadConverter)

Set the MessageConverter to use to convert the payload.

setHeaderMapper

public void setHeaderMapper(JmsHeaderMapper headerMapper)

Set the JmsHeaderMapper to use to map JMS headers to and from standard message headers.

afterPropertiesSet

public void afterPropertiesSet()

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

toMessage

public javax.jms.Message toMessage(Object object,
                                   javax.jms.Session session)
                            throws javax.jms.JMSException,
                                   MessageConversionException

Description copied from interface: MessageConverter

Convert a Java object to a JMS Message using the supplied session to create the message object.

Specified by:

toMessage in interface MessageConverter

Parameters:

object - the object to convert

session - the Session to use for creating a JMS Message

Returns:

the JMS Message

Throws:

javax.jms.JMSException - if thrown by JMS API methods

MessageConversionException - in case of conversion failure

fromMessage

public Object fromMessage(javax.jms.Message message)
                   throws javax.jms.JMSException,
                          MessageConversionException

Description copied from interface: MessageConverter

Convert from a JMS Message to a Java object.

Specified by:

fromMessage in interface MessageConverter

Parameters:

message - the message to convert

Returns:

the converted Java object

Throws:

javax.jms.JMSException - if thrown by JMS API methods

MessageConversionException - in case of conversion failure

extractPayload

protected Object extractPayload(javax.jms.Message message)
                         throws javax.jms.JMSException

Extract the payload of the specified Message.

Throws:

javax.jms.JMSException

createMessageForPayload

@Deprecated
protected javax.jms.Message createMessageForPayload(Object payload,
                                                                javax.jms.Session session)
                                                         throws javax.jms.JMSException

Deprecated. as of 4.3, use createMessageForPayload(Object, Session, Object)

Create a JMS message for the specified payload.

Throws:

javax.jms.JMSException

See Also:

MessageConverter.toMessage(Object, Session)

createMessageForPayload

protected javax.jms.Message createMessageForPayload(Object payload,
                                                    javax.jms.Session session,
                                                    Object conversionHint)
                                             throws javax.jms.JMSException

Create a JMS message for the specified payload and conversionHint. The conversion hint is an extra object passed to the MessageConverter, e.g. the associated MethodParameter (may be null}.

Throws:

javax.jms.JMSException

Since:

4.3

See Also:

MessageConverter.toMessage(Object, Session)

extractHeaders

protected final org.springframework.messaging.MessageHeaders extractHeaders(javax.jms.Message message)