|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.codehaus.activemq.message.AbstractPacket
org.codehaus.activemq.message.ActiveMQMessage
org.codehaus.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.codehaus.activemq.message.ActiveMQMessage |
BOOLEAN, BROKER_NAME_INDEX, BYTE, BYTES, CHAR, CID_INDEX, CLUSTER_NAME_INDEX, CORRELATION_INDEX, DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE, DOUBLE, EOF, EXPIRATION_INDEX, FLOAT, INT, LONG, NULL, PAYLOAD_INDEX, PROPERTIES_INDEX, readOnlyMessage, REDELIVERED_INDEX, REPLY_TO_INDEX, SHORT, STRING, TIMESTAMP_INDEX, TRANSACTION_ID_INDEX, TYPE_INDEX, XA_TRANS_INDEX |
Fields inherited from class org.codehaus.activemq.message.AbstractPacket |
bitArray, BROKERS_VISITED_INDEX, RECEIPT_REQUIRED_INDEX |
Fields inherited from interface javax.jms.Message |
DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE |
Fields inherited from interface org.codehaus.activemq.message.Packet |
ACTIVEMQ_BROKER_INFO, ACTIVEMQ_BYTES_MESSAGE, ACTIVEMQ_CONNECTION_INFO, ACTIVEMQ_MAP_MESSAGE, ACTIVEMQ_MESSAGE, ACTIVEMQ_MSG_ACK, ACTIVEMQ_OBJECT_MESSAGE, ACTIVEMQ_STREAM_MESSAGE, ACTIVEMQ_TEXT_MESSAGE, CAPACITY_INFO, CAPACITY_INFO_REQUEST, CONSUMER_INFO, DURABLE_UNSUBSCRIBE, INT_RESPONSE_RECEIPT_INFO, PRODUCER_INFO, RECEIPT_INFO, RESPONSE_RECEIPT_INFO, SESSION_INFO, TRANSACTION_INFO, WIRE_FORMAT_INFO, XA_TRANSACTION_INFO |
Constructor Summary | |
ActiveMQObjectMessage()
|
Method Summary | |
void |
clearBody()
Clears out the message body. |
ActiveMQMessage |
deepCopy()
|
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 |
protected void |
readBody(DataInput dataIn)
Used to help build the body from an input stream |
void |
setObject(Serializable newObject)
Sets the serializable object containing this message's data. |
(package private) void |
setObjectPayload(Object newObject)
|
ActiveMQMessage |
shallowCopy()
|
protected void |
writeBody(DataOutput dataOut)
Used serialize the message body to an output stream |
Methods inherited from class org.codehaus.activemq.message.AbstractPacket |
addBrokerVisited, decrementMemoryReferenceCount, equals, getBitArray, getBrokersVisited, getBrokersVisitedAsString, getId, getMemoryUsage, getMemoryUsageReferenceCount, getPacketTypeAsString, hasVisited, incrementMemoryReferenceCount, initializeBrokersVisited, initializeOther, isReceipt, isReceiptRequired, setBitArray, setId, setMemoryUsage, setReceiptRequired |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public ActiveMQObjectMessage()
Method Detail |
public int getPacketType()
getPacketType
in interface Packet
getPacketType
in class ActiveMQMessage
public ActiveMQMessage shallowCopy() throws JMSException
shallowCopy
in class ActiveMQMessage
JMSException
public ActiveMQMessage deepCopy() throws JMSException
deepCopy
in class ActiveMQMessage
JMSException
public void clearBody() throws 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 Message
clearBody
in class ActiveMQMessage
JMSException
- if the JMS provider fails to clear the message
body due to some internal error.public void setObject(Serializable newObject) 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.
setObject
in interface ObjectMessage
newObject
- 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.void setObjectPayload(Object newObject)
public Serializable getObject() throws JMSException
getObject
in interface ObjectMessage
JMSException
public void prepareMessageBody() throws JMSException
prepareMessageBody
in class ActiveMQMessage
JMSException
protected void writeBody(DataOutput dataOut) throws IOException
writeBody
in class ActiveMQMessage
dataOut
-
IOException
protected void readBody(DataInput dataIn) throws IOException
readBody
in class ActiveMQMessage
dataIn
-
IOException
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |