|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.activemq.message.AbstractPacket
org.activemq.message.ActiveMQMessage
org.activemq.message.ActiveMQObjectMessage
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 class org.activemq.message.AbstractPacket |
bitArray, BROKERS_VISITED_INDEX, cachedHashCode, RECEIPT_REQUIRED_INDEX |
Fields inherited from interface javax.jms.Message |
DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE |
Constructor Summary | |
ActiveMQObjectMessage()
|
Method Summary | |
void |
clearBody()
Clears out the message body. |
protected javax.jms.JMSException |
createFailedToBuildBodyException(java.io.IOException ioe)
|
ActiveMQMessage |
deepCopy()
|
java.io.Serializable |
getObject()
Gets the serializable object containing this message's data. |
int |
getPacketType()
Return the type of Packet |
void |
prepareMessageBody()
Prepare a message body for delivery |
void |
readBody(java.io.DataInput dataIn)
Used to help build the body from an input stream |
void |
setObject(java.io.Serializable newObject)
Sets the serializable object containing this message's data. |
void |
setObjectPayload(java.lang.Object newObject)
|
ActiveMQMessage |
shallowCopy()
|
java.lang.String |
toString()
|
void |
writeBody(java.io.DataOutput dataOut)
Used serialize the message body to an output stream |
Methods inherited from class org.activemq.message.AbstractPacket |
addBrokerVisited, clearBrokersVisited, decrementMemoryReferenceCount, equals, getBitArray, getBrokersVisited, getBrokersVisitedAsString, getId, getMemoryUsage, getMemoryUsageReferenceCount, getPacketTypeAsString, hasVisited, incrementMemoryReferenceCount, initializeOther, isReceipt, isReceiptRequired, setBitArray, setBrokersVisitedAsString, setId, setMemoryUsage, setReceiptRequired |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface javax.jms.Message |
acknowledge, 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 |
Methods inherited from interface org.activemq.io.util.MemoryManageable |
decrementMemoryReferenceCount, getMemoryUsage, getMemoryUsageReferenceCount, incrementMemoryReferenceCount |
Constructor Detail |
public ActiveMQObjectMessage()
Method Detail |
public int getPacketType()
getPacketType
in interface Packet
getPacketType
in class ActiveMQMessage
public ActiveMQMessage shallowCopy() throws javax.jms.JMSException
shallowCopy
in class ActiveMQMessage
javax.jms.JMSException
public ActiveMQMessage deepCopy() throws javax.jms.JMSException
deepCopy
in class ActiveMQMessage
javax.jms.JMSException
public void clearBody() throws javax.jms.JMSException
If this message body was read-only, calling this method leaves the message body in the same state as an empty body in a newly created message.
clearBody
in interface javax.jms.Message
clearBody
in class ActiveMQMessage
javax.jms.JMSException
- if the JMS provider fails to clear the message
body due to some internal error.public void setObject(java.io.Serializable newObject) throws javax.jms.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.
setObject
in interface javax.jms.ObjectMessage
newObject
- the message's data
javax.jms.JMSException
- if the JMS provider fails to set the object
due to some internal error.
javax.jms.MessageFormatException
- if object serialization fails.
javax.jms.MessageNotWriteableException
- if the message is in read-only
mode.public void setObjectPayload(java.lang.Object newObject)
public java.io.Serializable getObject() throws javax.jms.JMSException
getObject
in interface javax.jms.ObjectMessage
javax.jms.JMSException
public void prepareMessageBody() throws javax.jms.JMSException
prepareMessageBody
in class ActiveMQMessage
javax.jms.JMSException
public void writeBody(java.io.DataOutput dataOut) throws java.io.IOException
writeBody
in interface BodyPacket
writeBody
in class ActiveMQMessage
dataOut
-
java.io.IOException
public void readBody(java.io.DataInput dataIn) throws java.io.IOException
readBody
in interface BodyPacket
readBody
in class ActiveMQMessage
dataIn
-
java.io.IOException
public java.lang.String toString()
toString
in class ActiveMQMessage
protected javax.jms.JMSException createFailedToBuildBodyException(java.io.IOException ioe)
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |