|
Oracle® Streams Advanced Queuing Java API Reference 10g Release 2 (10.2) B14291-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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
Field Summary |
Fields inherited from interface javax.jms.Message |
DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE |
Method Summary | |
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. |
Method Detail |
public void 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 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.public java.io.Serializable getObject() throws JMSException
JMSException
- if the JMS provider fails to get the object due to some internal error.MessageFormatException
- if object deserialization fails.
|
Oracle® Streams Advanced Queuing Java API Reference 10g Release 2 (10.2) B14291-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |