javax.jms

Interface TextMessage

All Superinterfaces:

Message

public interface TextMessage
extends Message

A TextMessage object is used to send a message containing a java.lang.String. It inherits from the Message interface and adds a text message body.

This message type can be used to transport text-based messages, including those with XML content.

When a client receives a TextMessage, it is in read-only mode. If a client attempts to write to the message at this point, a MessageNotWriteableException is thrown. If clearBody is called, the message can now be both read from and written to.

Version:

1.1 - February 2, 2002

See Also:

Session.createTextMessage(), Session.createTextMessage(String), BytesMessage, MapMessage, Message, ObjectMessage, StreamMessage, String

Field Summary

Fields

Modifier and Type	Field and Description
static String	SOLACE_JMS_PROP_ISXML Solace defined boolean property indicating that a TextMessage contains XML content.

Fields inherited from interface javax.jms.Message

DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE

Method Summary

Modifier and Type	Method and Description
String	getText() Gets the string containing this message's data.
void	setText(String string) Sets the string containing this message's data.

Methods inherited from interface javax.jms.Message

acknowledge, clearBody, clearProperties, getBooleanProperty, getByteProperty, getDoubleProperty, getFloatProperty, getIntProperty, getJMSCorrelationID, getJMSCorrelationIDAsBytes, getJMSDeliveryMode, getJMSDestination, getJMSExpiration, getJMSMessageID, getJMSPriority, getJMSRedelivered, getJMSReplyTo, getJMSTimestamp, getJMSType, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, propertyExists, setBooleanProperty, setByteProperty, setDoubleProperty, setFloatProperty, setIntProperty, setJMSCorrelationID, setJMSCorrelationIDAsBytes, setJMSDeliveryMode, setJMSDestination, setJMSExpiration, setJMSMessageID, setJMSPriority, setJMSRedelivered, setJMSReplyTo, setJMSTimestamp, setJMSType, setLongProperty, setObjectProperty, setShortProperty, setStringProperty

Field Detail

SOLACE_JMS_PROP_ISXML

static final String SOLACE_JMS_PROP_ISXML

Solace defined boolean property indicating that a TextMessage contains XML content.

This causes the TextMessage to be put in the XML payload of the Solace message rather than the binary attachment. This value is defined in com.solacesystems.jms.SupportedProperty

See Also:

Constant Field Values

Method Detail

setText

void setText(String string)
      throws JMSException

Sets the string containing this message's data.

Parameters:

string - the String containing the message's data

Throws:

JMSException - if the JMS provider fails to set the text due to some internal error.

MessageNotWriteableException - if the message is in read-only mode.

getText

String getText()
        throws JMSException

Gets the string containing this message's data. The default value is null.

Returns:

the String containing the message's data

Throws:

JMSException - if the JMS provider fails to get the text due to some internal error.