com.amazon.sqs.javamessaging.message

Class SQSTextMessage

java.lang.Object

com.amazon.sqs.javamessaging.message.SQSMessage

com.amazon.sqs.javamessaging.message.SQSTextMessage

All Implemented Interfaces:

javax.jms.Message, javax.jms.TextMessage

public class SQSTextMessage
extends SQSMessage
implements javax.jms.TextMessage

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_CORRELATION_ID, JMS_SQS_MESSAGE_TYPE, JMS_SQS_REPLY_TO_QUEUE_NAME, JMS_SQS_REPLY_TO_QUEUE_URL, OBJECT_MESSAGE_TYPE, TEXT_MESSAGE_TYPE

Fields inherited from interface javax.jms.Message

DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE

Constructor Summary

Constructors

Constructor and Description
SQSTextMessage() Create new empty TextMessage to send.
SQSTextMessage(Acknowledger acknowledger, String queueUrl, com.amazonaws.services.sqs.model.Message sqsMessage) Convert received SQSMessage into TextMessage.
SQSTextMessage(String payload) Create new TextMessage with payload to send.

Method Summary

Modifier and Type	Method and Description
void	clearBody() Sets the message body to write mode, and sets the text to null
String	getText() Gets the text containing this message's body.
void	setText(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, getSQSMessageDeduplicationId, getSQSMessageGroupId, getSQSMessageId, getSQSMessageSequenceNumber, getStringProperty, propertyExists, setBodyWritePermissions, setBooleanProperty, setByteProperty, setDoubleProperty, setFloatProperty, setIntProperty, setJMSCorrelationID, setJMSCorrelationIDAsBytes, setJMSDeliveryMode, setJMSDestination, setJMSExpiration, setJMSMessageID, setJMSPriority, setJMSRedelivered, setJMSReplyTo, setJMSTimestamp, setJMSType, setLongProperty, setObjectProperty, setSequenceNumber, setShortProperty, setSQSMessageId, setStringProperty

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.jms.Message

acknowledge, 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

Constructor Detail

SQSTextMessage

public SQSTextMessage(Acknowledger acknowledger,
                      String queueUrl,
                      com.amazonaws.services.sqs.model.Message sqsMessage)
               throws javax.jms.JMSException

Convert received SQSMessage into TextMessage.

Throws:

javax.jms.JMSException

SQSTextMessage

public SQSTextMessage()
               throws javax.jms.JMSException

Create new empty TextMessage to send.

Throws:

javax.jms.JMSException

SQSTextMessage

public SQSTextMessage(String payload)
               throws javax.jms.JMSException

Create new TextMessage with payload to send.

Throws:

javax.jms.JMSException

Method Detail

setText

public void setText(String string)
             throws javax.jms.JMSException

Sets the text containing this message's body.

Specified by:

setText in interface javax.jms.TextMessage

Parameters:

string - The String containing the message's body

Throws:

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

javax.jms.JMSException

getText

public String getText()
               throws javax.jms.JMSException

Gets the text containing this message's body.

Specified by:

getText in interface javax.jms.TextMessage

Returns:

The String containing the message's body

Throws:

javax.jms.JMSException

clearBody

public void clearBody()
               throws javax.jms.JMSException

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

Specified by:

clearBody in interface javax.jms.Message

Overrides:

clearBody in class SQSMessage

Throws:

javax.jms.JMSException - If directly called