Top Description Fields Constructors Methods
org.springframework.jms.support.converter

public Class MessagingMessageConverter

extends Object
implements MessageConverter, InitializingBean
Class Inheritance
All Implemented Interfaces
org.springframework.beans.factory.InitializingBean, org.springframework.jms.support.converter.MessageConverter
Known Direct Subclasses
org.springframework.jms.listener.adapter.AbstractAdaptableMessageListener.MessagingMessageConverterAdapter
Imports
java.util.Map, jakarta.jms.JMSException, .Session, org.springframework.beans.factory.InitializingBean, org.springframework.jms.support.JmsHeaderMapper, .SimpleJmsHeaderMapper, org.springframework.lang.Nullable, org.springframework.messaging.Message, .MessageHeaders, org.springframework.messaging.core.AbstractMessageSendingTemplate, org.springframework.messaging.support.MessageBuilder, org.springframework.util.Assert

Convert a Message from the messaging abstraction to and from a jakarta.jms.Message using an underlying MessageConverter for the payload and a org.springframework.jms.support.JmsHeaderMapper to map the JMS headers to and from standard message headers.
Author
Stephane Nicoll
Since
4.1

Field Summary

Modifier and TypeField and Description
private JmsHeaderMapper
private MessageConverter

Constructor Summary

AccessConstructor and Description
public
MessagingMessageConverter()

Create an instance with a default payload converter.

public
MessagingMessageConverter(MessageConverter
the payload converter to use
payloadConverter
)

Create an instance with the specific payload converter.

public
MessagingMessageConverter(MessageConverter payloadConverter, JmsHeaderMapper headerMapper)

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

Method Summary

Modifier and TypeMethod and Description
public void
afterPropertiesSet()

Implements org.springframework.beans.factory.InitializingBean.afterPropertiesSet.

Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

protected Message
createMessageForPayload(Object payload, Session session, Object conversionHint)

Create a JMS message for the specified payload and conversionHint.

protected final MessageHeaders
protected Object
extractPayload(Message message)

Extract the payload of the specified jakarta.jms.Message.

public Object
fromMessage(Message
the message to convert
message
)

Implements org.springframework.jms.support.converter.MessageConverter.fromMessage.

Convert from a JMS Message to a Java object.

public void
setHeaderMapper(JmsHeaderMapper headerMapper)

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

public void
setPayloadConverter(MessageConverter payloadConverter)

Set the MessageConverter to use to convert the payload.

public Message
toMessage(Object
the object to convert
object
,
Session
the Session to use for creating a JMS Message
session
)

Implements org.springframework.jms.support.converter.MessageConverter.toMessage.

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

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

headerMapperback to summary
private JmsHeaderMapper headerMapper
payloadConverterback to summary
private MessageConverter payloadConverter

Constructor Detail

MessagingMessageConverterback to summary
public MessagingMessageConverter()

Create an instance with a default payload converter.

See Also
org.springframework.jms.support.converter.SimpleMessageConverter, org.springframework.jms.support.SimpleJmsHeaderMapper
MessagingMessageConverterback to summary
public MessagingMessageConverter(MessageConverter payloadConverter)

Create an instance with the specific payload converter.

Parameters
payloadConverter:MessageConverter

the payload converter to use

Since
4.3.12
MessagingMessageConverterback to summary
public MessagingMessageConverter(MessageConverter payloadConverter, JmsHeaderMapper headerMapper)

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

Method Detail

afterPropertiesSetback to summary
public void afterPropertiesSet()

Implements org.springframework.beans.factory.InitializingBean.afterPropertiesSet.

Doc from org.springframework.beans.factory.InitializingBean.afterPropertiesSet.

Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

Annotations
@Override
createMessageForPayloadback to summary
protected Message createMessageForPayload(Object payload, Session session, Object conversionHint) throws 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}.

Since
4.3
See Also
MessageConverter#toMessage(Object, Session)
extractHeadersback to summary
protected final MessageHeaders extractHeaders(Message message)
extractPayloadback to summary
protected Object extractPayload(Message message) throws JMSException

Extract the payload of the specified jakarta.jms.Message.

fromMessageback to summary
public Object fromMessage(Message message) throws JMSException, MessageConversionException

Implements org.springframework.jms.support.converter.MessageConverter.fromMessage.

Doc from org.springframework.jms.support.converter.MessageConverter.fromMessage.

Convert from a JMS Message to a Java object.

Parameters
message:Message

the message to convert

Returns:Object

the converted Java object

Annotations
@Override
@SuppressWarnings:rawtypes, unchecked
Exceptions
JMSException:
if thrown by JMS API methods
MessageConversionException:
in case of conversion failure
setHeaderMapperback to summary
public void setHeaderMapper(JmsHeaderMapper headerMapper)

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

setPayloadConverterback to summary
public void setPayloadConverter(MessageConverter payloadConverter)

Set the MessageConverter to use to convert the payload.

toMessageback to summary
public Message toMessage(Object object, Session session) throws JMSException, MessageConversionException

Implements org.springframework.jms.support.converter.MessageConverter.toMessage.

Doc from org.springframework.jms.support.converter.MessageConverter.toMessage.

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

Parameters
object:Object

the object to convert

session:Session

the Session to use for creating a JMS Message

Returns:Message

the JMS Message

Annotations
@Override
Exceptions
JMSException:
if thrown by JMS API methods
MessageConversionException:
in case of conversion failure