org.hornetq.jms.client

Class HornetQObjectMessage

java.lang.Object

org.hornetq.jms.client.HornetQMessage

org.hornetq.jms.client.HornetQObjectMessage

All Implemented Interfaces:

Message, ObjectMessage

public class HornetQObjectMessage
extends HornetQMessage
implements ObjectMessage

HornetQ implementation of a JMS ObjectMessage.
Don't used ObjectMessage if you want good performance! Serialization is slooooow!

Version:

$Revision: 3412 $ $Id: HornetQRAObjectMessage.java 3412 2007-12-05 19:41:47Z timfox $

Author:

Tim Fox, Ovidiu Feodorov, Andy Taylor

Field Summary

Fields

Modifier and Type	Field and Description
static byte	TYPE

Fields inherited from class org.hornetq.jms.client.HornetQMessage

message, propertiesReadOnly, readOnly

Fields inherited from interface javax.jms.Message

DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HornetQObjectMessage(ClientMessage message, ClientSession session)
protected	HornetQObjectMessage(ClientSession session)
	HornetQObjectMessage(ObjectMessage foreign, ClientSession session) A copy constructor for foreign JMS ObjectMessages.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearBody() Clears out the message body.
void	doBeforeReceive()
void	doBeforeSend()
Serializable	getObject() Gets the serializable object containing this message's data.
byte	getType()
void	setObject(Serializable object) Sets the serializable object containing this message's data.

Methods inherited from class org.hornetq.jms.client.HornetQMessage

acknowledge, checkBuffer, checkRead, checkWrite, clearProperties, coreMaptoJMSMap, createMessage, getBooleanProperty, getByteProperty, getCoreMessage, getDoubleProperty, getFloatProperty, getIntProperty, getJMSCorrelationID, getJMSCorrelationIDAsBytes, getJMSDeliveryMode, getJMSDestination, getJMSExpiration, getJMSMessageID, getJMSPriority, getJMSRedelivered, getJMSReplyTo, getJMSTimestamp, getJMSType, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, propertyExists, resetMessageID, saveToOutputStream, setBooleanProperty, setByteProperty, setDoubleProperty, setFloatProperty, setInputStream, setIntProperty, setJMSCorrelationID, setJMSCorrelationIDAsBytes, setJMSDeliveryMode, setJMSDestination, setJMSExpiration, setJMSMessageID, setJMSPriority, setJMSRedelivered, setJMSReplyTo, setJMSTimestamp, setJMSType, setLongProperty, setObjectProperty, setOutputStream, setShortProperty, setStringProperty, toString, waitCompletionOnStream

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, 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

Field Detail

TYPE

public static final byte TYPE

See Also:

Constant Field Values

Constructor Detail

HornetQObjectMessage

protected HornetQObjectMessage(ClientSession session)

HornetQObjectMessage

protected HornetQObjectMessage(ClientMessage message,
                    ClientSession session)

HornetQObjectMessage

public HornetQObjectMessage(ObjectMessage foreign,
                    ClientSession session)
                     throws JMSException

A copy constructor for foreign JMS ObjectMessages.

Throws:

JMSException

Method Detail

getType

public byte getType()

Overrides:

getType in class HornetQMessage

doBeforeSend

public void doBeforeSend()
                  throws Exception

Overrides:

doBeforeSend in class HornetQMessage

Throws:

Exception

doBeforeReceive

public void doBeforeReceive()
                     throws Exception

Overrides:

doBeforeReceive in class HornetQMessage

Throws:

Exception

setObject

public void setObject(Serializable object)
               throws JMSException

Description copied from interface: ObjectMessage

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.

Specified by:

setObject in interface ObjectMessage

Parameters:

object - the message's data

Throws:

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.

getObject

public Serializable getObject()
                       throws JMSException

Description copied from interface: ObjectMessage

Gets the serializable object containing this message's data. The default value is null.

Specified by:

getObject in interface ObjectMessage

Returns:

the serializable object containing this message's data

Throws:

JMSException - if the JMS provider fails to get the object due to some internal error.

MessageFormatException - if object deserialization fails.

clearBody

public void clearBody()
               throws JMSException

Description copied from interface: Message

Clears out the message body. Clearing a message's body does not clear its header values or property entries.

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.

Specified by:

clearBody in interface Message

Overrides:

clearBody in class HornetQMessage

Throws:

JMSException - if the JMS provider fails to clear the message body due to some internal error.