| 
 | J2EE1.4 SDK | |||||||||
| 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 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.
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.| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved.