|
|||||||||||
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
A simple message converter that can handle TextMessages, BytesMessages,
MapMessages, and ObjectMessages. Used as default by JmsTemplate, for
convertAndSend
and receiveAndConvert
operations.
Converts a String to a JMS TextMessage, a byte array to a JMS BytesMessage, a Map to a JMS MapMessage, and a Serializable object to a JMS ObjectMessage (respectively 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. (JmsTemplate102 uses SimpleMessageConverter102 as default.)
JmsTemplate.convertAndSend(java.lang.Object)
,
JmsTemplate.receiveAndConvert()
,
JmsTemplate102
,
SimpleMessageConverter102
,
TextMessage
,
BytesMessage
,
MapMessage
,
ObjectMessage
Constructor Summary | |
SimpleMessageConverter()
|
Method Summary | |
protected javax.jms.BytesMessage |
createMessageForByteArray(byte[] bytes,
javax.jms.Session session)
Create a JMS BytesMessage for the given byte array. |
protected javax.jms.MapMessage |
createMessageForMap(java.util.Map map,
javax.jms.Session session)
Create a JMS MapMessage for the given Map. |
protected javax.jms.ObjectMessage |
createMessageForSerializable(java.io.Serializable object,
javax.jms.Session session)
Create a JMS ObjectMessage for the given Serializable object. |
protected javax.jms.TextMessage |
createMessageForString(java.lang.String text,
javax.jms.Session session)
Create a JMS TextMessage for the given String. |
protected byte[] |
extractByteArrayFromMessage(javax.jms.BytesMessage message)
Extract a byte array from the given TextMessage. |
protected java.util.Map |
extractMapFromMessage(javax.jms.MapMessage message)
Extract a Map from the given TextMessage. |
protected java.io.Serializable |
extractSerializableFromMessage(javax.jms.ObjectMessage message)
Extract a Serializable object from the given TextMessage. |
protected java.lang.String |
extractStringFromMessage(javax.jms.TextMessage message)
Extract a String from the given TextMessage. |
java.lang.Object |
fromMessage(javax.jms.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. |
javax.jms.Message |
toMessage(java.lang.Object object,
javax.jms.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 javax.jms.Message toMessage(java.lang.Object object, javax.jms.Session session) throws javax.jms.JMSException, MessageConversionException
toMessage
in interface MessageConverter
object
- the object to convertsession
- the Session to use for creating a JMS Message
javax.jms.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 java.lang.Object fromMessage(javax.jms.Message message) throws javax.jms.JMSException, MessageConversionException
fromMessage
in interface MessageConverter
message
- the message to convert
MessageConversionException
- in case of conversion failure
javax.jms.JMSException
extractStringFromMessage(javax.jms.TextMessage)
,
extractByteArrayFromMessage(javax.jms.BytesMessage)
,
extractMapFromMessage(javax.jms.MapMessage)
,
extractSerializableFromMessage(javax.jms.ObjectMessage)
protected javax.jms.TextMessage createMessageForString(java.lang.String text, javax.jms.Session session) throws javax.jms.JMSException
text
- the String to convertsession
- current JMS session
javax.jms.JMSException
- if thrown by JMS methodsSession.createTextMessage()
protected javax.jms.BytesMessage createMessageForByteArray(byte[] bytes, javax.jms.Session session) throws javax.jms.JMSException
bytes
- the byyte array to convertsession
- current JMS session
javax.jms.JMSException
- if thrown by JMS methodsSession.createBytesMessage()
protected javax.jms.MapMessage createMessageForMap(java.util.Map map, javax.jms.Session session) throws javax.jms.JMSException
map
- the Map to convertsession
- current JMS session
javax.jms.JMSException
- if thrown by JMS methodsSession.createMapMessage()
protected javax.jms.ObjectMessage createMessageForSerializable(java.io.Serializable object, javax.jms.Session session) throws javax.jms.JMSException
object
- the Serializable object to convertsession
- current JMS session
javax.jms.JMSException
- if thrown by JMS methodsSession.createObjectMessage()
protected java.lang.String extractStringFromMessage(javax.jms.TextMessage message) throws javax.jms.JMSException
message
- the message to convert
javax.jms.JMSException
- if thrown by JMS methodsprotected byte[] extractByteArrayFromMessage(javax.jms.BytesMessage message) throws javax.jms.JMSException
message
- the message to convert
javax.jms.JMSException
- if thrown by JMS methodsprotected java.util.Map extractMapFromMessage(javax.jms.MapMessage message) throws javax.jms.JMSException
message
- the message to convert
javax.jms.JMSException
- if thrown by JMS methodsprotected java.io.Serializable extractSerializableFromMessage(javax.jms.ObjectMessage message) throws javax.jms.JMSException
message
- the message to convert
javax.jms.JMSException
- if thrown by JMS methods
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |