javax.jms.ObjectMessage Maven / Gradle / Ivy
/*
* @(#)ObjectMessage.java 1.19 02/04/09
*
* Copyright 1997-2002 Sun Microsystems, Inc. All Rights Reserved.
*
* SUN PROPRIETARY/CONFIDENTIAL.
* This software is the proprietary information of Sun Microsystems, Inc.
* Use is subject to license terms.
*
*/
package javax.jms;
import java.io.Serializable;
/** 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.
*
* @version 1.0 - 6 August 1998
* @author Mark Hapner
* @author Rich Burridge
*
* @see javax.jms.Session#createObjectMessage()
* @see javax.jms.Session#createObjectMessage(Serializable)
* @see javax.jms.BytesMessage
* @see javax.jms.MapMessage
* @see javax.jms.Message
* @see javax.jms.StreamMessage
* @see javax.jms.TextMessage
*/
public interface ObjectMessage extends Message {
/** Sets the serializable object containing this message's data.
* It is important to note that an 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.
*
* @param object the message's data
*
* @exception JMSException if the JMS provider fails to set the object
* due to some internal error.
* @exception MessageFormatException if object serialization fails.
* @exception MessageNotWriteableException if the message is in read-only
* mode.
*/
void
setObject(Serializable object) throws JMSException;
/** Gets the serializable object containing this message's data. The
* default value is null.
*
* @return the serializable object containing this message's data
*
* @exception JMSException if the JMS provider fails to get the object
* due to some internal error.
* @exception MessageFormatException if object deserialization fails.
*/
Serializable
getObject() throws JMSException;
}