public interface ObjectMessage
An 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
, TextMessage
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
setObject
void setObject(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 data
JMSException
- if the JMS 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.
Serializable getObject() throws JMSException
JMSException
- if the JMS provider fails to get the object due to some internal error.
MessageFormatException
- if object deserialization fails.
Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.
Scripting on this page tracks web page traffic, but does not change the content in any way.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4