com.amazon.sqs.javamessaging.message

Class SQSObjectMessage

java.lang.Object

com.amazon.sqs.javamessaging.message.SQSMessage

com.amazon.sqs.javamessaging.message.SQSObjectMessage

public class SQSObjectMessage
extends SQSMessage

An ObjectMessage object is used to send a message that contains a Java serializable object.

It inherits from the Message interface and adds a body containing a single reference to an object. Only Serializable Java objects can be used.

When a client receives an ObjectMessage, 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, JMS_SQS_REPLY_TO_QUEUE_NAME, JMS_SQS_REPLY_TO_QUEUE_URL, OBJECT_MESSAGE_TYPE, TEXT_MESSAGE_TYPE

Constructor Summary

Constructors

Constructor and Description
SQSObjectMessage() Create new empty ObjectMessage to send.
SQSObjectMessage(Acknowledger acknowledger, java.lang.String queueUrl, Message sqsMessage) Convert received SQSMessage into ObjectMessage
SQSObjectMessage(java.io.Serializable payload) Create new ObjectMessage 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 object body to null
protected static java.io.Serializable	deserialize(java.lang.String serialized) Deserialize the String into Serializable object.
java.lang.String	getMessageBody()
java.io.Serializable	getObject() Gets the Serializable containing this message's body
protected static java.lang.String	serialize(java.io.Serializable serializable) Serialize the Serializable object to String.
void	setObject(java.io.Serializable payload) Sets the Serializable 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

Constructor Detail

SQSObjectMessage

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

Convert received SQSMessage into ObjectMessage

Throws:

JMSException

SQSObjectMessage

public SQSObjectMessage()
                 throws JMSException

Create new empty ObjectMessage to send.

Throws:

JMSException

SQSObjectMessage

public SQSObjectMessage(java.io.Serializable payload)
                 throws JMSException

Create new ObjectMessage with payload to send.

Throws:

JMSException

Method Detail

setObject

public void setObject(java.io.Serializable payload)
               throws JMSException

Sets the Serializable containing this message's body

Parameters:

payload - The Serializable containing the message's body

Throws:

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

MessageFormatException - If object serialization fails.

JMSException

getObject

public java.io.Serializable getObject()
                               throws JMSException

Gets the Serializable containing this message's body

Throws:

MessageFormatException - If object deserialization fails.

JMSException

clearBody

public void clearBody()
               throws JMSException

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

Overrides:

clearBody in class SQSMessage

Throws:

JMSException - If directly called

deserialize

protected static java.io.Serializable deserialize(java.lang.String serialized)
                                           throws JMSException

Deserialize the String into Serializable object.

Throws:

JMSException

serialize

protected static java.lang.String serialize(java.io.Serializable serializable)
                                     throws JMSException

Serialize the Serializable object to String.

Throws:

JMSException

getMessageBody

public java.lang.String getMessageBody()