public interface ObjectMessage extends Message
ObjectMessage object is used to send a message that contains a serializable object in the Java programming
language ("Java 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.
If a collection of Java objects must be sent, one of the Collection classes provided since JDK 1.2 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.
Session.createObjectMessage(),
Session.createObjectMessage(Serializable),
BytesMessage,
MapMessage,
Message,
StreamMessage,
TextMessageDEFAULT_DELIVERY_DELAY, DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE| Modifier and Type | Method and Description |
|---|---|
java.io.Serializable |
getObject()
Gets the serializable object containing this message's data.
|
void |
setObject(java.io.Serializable object)
Sets the serializable object containing this message's data.
|
acknowledge, clearBody, clearProperties, getBody, getBooleanProperty, getByteProperty, getDoubleProperty, getFloatProperty, getIntProperty, getJMSCorrelationID, getJMSCorrelationIDAsBytes, getJMSDeliveryMode, getJMSDeliveryTime, getJMSDestination, getJMSExpiration, getJMSMessageID, getJMSPriority, getJMSRedelivered, getJMSReplyTo, getJMSTimestamp, getJMSType, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, isBodyAssignableTo, propertyExists, setBooleanProperty, setByteProperty, setDoubleProperty, setFloatProperty, setIntProperty, setJMSCorrelationID, setJMSCorrelationIDAsBytes, setJMSDeliveryMode, setJMSDeliveryTime, setJMSDestination, setJMSExpiration, setJMSMessageID, setJMSPriority, setJMSRedelivered, setJMSReplyTo, setJMSTimestamp, setJMSType, setLongProperty, setObjectProperty, setShortProperty, setStringPropertyvoid setObject(java.io.Serializable object)
throws JMSException
ObjectMessage
contains a snapshot of the object at the time setObject() is called; subsequent modifications of the object
will have no effect on the ObjectMessage body.object - the message's dataJMSException - if the Jakarta Messaging provider fails to set the object due to some internal error.MessageFormatException - if object serialization fails.MessageNotWriteableException - if the message is in read-only mode.java.io.Serializable getObject()
throws JMSException
JMSException - if the Jakarta Messaging provider fails to get the object due to some internal error.MessageFormatException - if object deserialization fails.