ATextMessage
object is used to send a message containing ajava.lang.String
. It inherits from theMessage
interface and adds a text message body.
The inclusion of this message type is based on the presumption that XML will likely become a popular mechanism for representing content of all kinds, including the content of JMS messages.
When a client receives aTextMessage
, it is in read-only mode. If a client attempts to write to the message at this point, aMessageNotWriteableException
is thrown. IfclearBody
is called, the message can now be both read from and written to.
Session.createTextMessage()
,Session.createTextMessage(String)
,BytesMessage
,MapMessage
,Message
,ObjectMessage
,StreamMessage
,String
Fields inherited from interface javax.jms.Message |
DEFAULT_DELIVERY_MODE,DEFAULT_PRIORITY,DEFAULT_TIME_TO_LIVE |
getText() Gets the string containing this message's data. | |
setText(java.lang.String string) Sets the string containing this message's data. |
public voidsetText(java.lang.String string) throwsJMSException
string
- theString
containing the message's dataJMSException
- if the JMS provider fails to set the text due to some internal error.MessageNotWriteableException
- if the message is in read-only mode.public java.lang.StringgetText() throwsJMSException
String
containing the message's dataJMSException
- if the JMS provider fails to get the text due to some internal error.