|
Java EE 5 SDK | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
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| Field Summary |
|---|
| Fields inherited from interface javax.jms.Message |
|---|
DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE |
| Method Summary | |
|---|---|
Serializable |
getObject()
Gets the serializable object containing this message's data. |
void |
setObject(Serializable object)
Sets the serializable object containing this message's data. |
| Method Detail |
|---|
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.
|
Java EE 5 SDK | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved.