com.amazon.sqs.javamessaging.message

Class SQSTextMessage

java.lang.Object

com.amazon.sqs.javamessaging.message.SQSMessage

com.amazon.sqs.javamessaging.message.SQSTextMessage

public class SQSTextMessage
extends SQSMessage

A TextMessage object is used to send a message body containing a java.lang.String. It inherits from the Message interface and adds a text message body. SQS does not accept empty or null message body

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.

Nested Class Summary

Nested classes/interfaces inherited from class com.amazon.sqs.javamessaging.message.SQSMessage

SQSMessage.JMSMessagePropertyValue, SQSMessage.TypeConversionSupport

Field Summary

Fields inherited from class com.amazon.sqs.javamessaging.message.SQSMessage

BYTE_MESSAGE_TYPE, JMS_SQS_MESSAGE_TYPE, OBJECT_MESSAGE_TYPE, TEXT_MESSAGE_TYPE

Constructor Summary

Constructors

Constructor and Description
SQSTextMessage() Create new empty TextMessage to send.
SQSTextMessage(Acknowledger acknowledger, java.lang.String queueUrl, Message sqsMessage) Convert received SQSMessage into TextMessage.
SQSTextMessage(java.lang.String payload) Create new TextMessage with payload to send.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearBody() Sets the message body to write mode, and sets the text to null
java.lang.String	getText() Gets the text containing this message's body.
void	setText(java.lang.String string) Sets the text containing this message's body.

Methods inherited from class com.amazon.sqs.javamessaging.message.SQSMessage

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SQSTextMessage

public SQSTextMessage(Acknowledger acknowledger,
              java.lang.String queueUrl,
              Message sqsMessage)
               throws JMSException

Convert received SQSMessage into TextMessage.

Throws:

JMSException

SQSTextMessage

public SQSTextMessage()
               throws JMSException

Create new empty TextMessage to send.

Throws:

JMSException

SQSTextMessage

public SQSTextMessage(java.lang.String payload)
               throws JMSException

Create new TextMessage with payload to send.

Throws:

JMSException

Method Detail

setText

public void setText(java.lang.String string)
             throws JMSException

Sets the text containing this message's body.

Parameters:

string - The String containing the message's body

Throws:

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

JMSException

getText

public java.lang.String getText()
                         throws JMSException

Gets the text containing this message's body.

Returns:

The String containing the message's body

Throws:

JMSException

clearBody

public void clearBody()
               throws JMSException

Sets the message body to write mode, and sets the text to null

Overrides:

clearBody in class SQSMessage

Throws:

JMSException - If directly called