|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.jms.support.converter.SimpleMessageConverter
public class SimpleMessageConverter
A simple message converter which is able to handle TextMessages, BytesMessages,
MapMessages, and ObjectMessages. Used as default conversion strategy
by JmsTemplate
, for
convertAndSend
and receiveAndConvert
operations.
Converts a String to a TextMessage
, a byte array to a
BytesMessage
, a Map to a MapMessage
, and
a Serializable object to a ObjectMessage
(or vice versa).
This converter implementation works for both JMS 1.1 and JMS 1.0.2,
except when extracting a byte array from a BytesMessage. So for converting
BytesMessages with a JMS 1.0.2 provider, use SimpleMessageConverter102
.
(As you would expect, JmsTemplate102
uses SimpleMessageConverter102 as default.)
JmsTemplate.convertAndSend(java.lang.Object)
,
JmsTemplate.receiveAndConvert()
,
SimpleMessageConverter102
Constructor Summary | |
---|---|
SimpleMessageConverter()
|
Method Summary | |
---|---|
protected BytesMessage |
createMessageForByteArray(byte[] bytes,
Session session)
Create a JMS BytesMessage for the given byte array. |
protected MapMessage |
createMessageForMap(Map map,
Session session)
Create a JMS MapMessage for the given Map. |
protected ObjectMessage |
createMessageForSerializable(Serializable object,
Session session)
Create a JMS ObjectMessage for the given Serializable object. |
protected TextMessage |
createMessageForString(String text,
Session session)
Create a JMS TextMessage for the given String. |
protected byte[] |
extractByteArrayFromMessage(BytesMessage message)
Extract a byte array from the given BytesMessage . |
protected Map |
extractMapFromMessage(MapMessage message)
Extract a Map from the given MapMessage . |
protected Serializable |
extractSerializableFromMessage(ObjectMessage message)
Extract a Serializable object from the given ObjectMessage . |
protected String |
extractStringFromMessage(TextMessage message)
Extract a String from the given TextMessage. |
Object |
fromMessage(Message message)
This implementation converts a TextMessage back to a String, a ByteMessage back to a byte array, a MapMessage back to a Map, and an ObjectMessage back to a Serializable object. |
Message |
toMessage(Object object,
Session session)
This implementation creates a TextMessage for a String, a BytesMessage for a byte array, a MapMessage for a Map, and an ObjectMessage for a Serializable object. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SimpleMessageConverter()
Method Detail |
---|
public Message toMessage(Object object, Session session) throws JMSException, MessageConversionException
toMessage
in interface MessageConverter
object
- the object to convertsession
- the Session to use for creating a JMS Message
JMSException
- if thrown by JMS API methods
MessageConversionException
- in case of conversion failurecreateMessageForString(java.lang.String, javax.jms.Session)
,
createMessageForByteArray(byte[], javax.jms.Session)
,
createMessageForMap(java.util.Map, javax.jms.Session)
,
createMessageForSerializable(java.io.Serializable, javax.jms.Session)
public Object fromMessage(Message message) throws JMSException, MessageConversionException
fromMessage
in interface MessageConverter
message
- the message to convert
JMSException
- if thrown by JMS API methods
MessageConversionException
- in case of conversion failureextractStringFromMessage(javax.jms.TextMessage)
,
extractByteArrayFromMessage(javax.jms.BytesMessage)
,
extractMapFromMessage(javax.jms.MapMessage)
,
extractSerializableFromMessage(javax.jms.ObjectMessage)
protected TextMessage createMessageForString(String text, Session session) throws JMSException
text
- the String to convertsession
- current JMS session
JMSException
- if thrown by JMS methodsSession.createTextMessage()
protected BytesMessage createMessageForByteArray(byte[] bytes, Session session) throws JMSException
bytes
- the byyte array to convertsession
- current JMS session
JMSException
- if thrown by JMS methodsSession.createBytesMessage()
protected MapMessage createMessageForMap(Map map, Session session) throws JMSException
map
- the Map to convertsession
- current JMS session
JMSException
- if thrown by JMS methodsSession.createMapMessage()
protected ObjectMessage createMessageForSerializable(Serializable object, Session session) throws JMSException
object
- the Serializable object to convertsession
- current JMS session
JMSException
- if thrown by JMS methodsSession.createObjectMessage()
protected String extractStringFromMessage(TextMessage message) throws JMSException
message
- the message to convert
JMSException
- if thrown by JMS methodsprotected byte[] extractByteArrayFromMessage(BytesMessage message) throws JMSException
BytesMessage
.
message
- the message to convert
JMSException
- if thrown by JMS methodsprotected Map extractMapFromMessage(MapMessage message) throws JMSException
MapMessage
.
message
- the message to convert
JMSException
- if thrown by JMS methodsprotected Serializable extractSerializableFromMessage(ObjectMessage message) throws JMSException
ObjectMessage
.
message
- the message to convert
JMSException
- if thrown by JMS methods
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |