org.apache.qpid.jms.provider.amqp.message

Class AmqpJmsObjectMessageFacade

java.lang.Object

org.apache.qpid.jms.provider.amqp.message.AmqpJmsMessageFacade

org.apache.qpid.jms.provider.amqp.message.AmqpJmsObjectMessageFacade

All Implemented Interfaces:

JmsMessageFacade, JmsObjectMessageFacade

public class AmqpJmsObjectMessageFacade
extends AmqpJmsMessageFacade
implements JmsObjectMessageFacade

Wrapper around an AMQP Message instance that will be treated as a JMS ObjectMessage type.

Field Summary

Fields inherited from class org.apache.qpid.jms.provider.amqp.message.AmqpJmsMessageFacade

connection, message

Constructor Summary

Constructors

Constructor and Description
AmqpJmsObjectMessageFacade(AmqpConnection connection, boolean isAmqpTypeEncoded) Creates a new facade instance
AmqpJmsObjectMessageFacade(AmqpConsumer consumer, org.apache.qpid.proton.message.Message message) Creates a new Facade around an incoming AMQP Message for dispatch to the JMS Consumer instance.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearBody() Clears the contents of this Message.
AmqpJmsObjectMessageFacade	copy() Create a new instance and perform a deep copy of this object's contents.
byte	getJmsMsgType()
Serializable	getObject() Gets the Object value that is contained in the provider message.
boolean	isAmqpTypedEncoding()
void	onSend(long producerTtl) Called before a message is sent to allow a Message instance to move the contents from a logical data structure to a binary form for transmission, or other processing such as setting proper message headers etc.
void	setObject(Serializable value) Stores the given object into the provider Message.

Methods inherited from class org.apache.qpid.jms.provider.amqp.message.AmqpJmsMessageFacade

applicationPropertyExists, clearProperties, copyInto, getAmqpMessage, getAmqpTimeToLiveOverride, getApplicationProperty, getApplicationPropertyNames, getConnection, getContentType, getCorrelationId, getCorrelationIdBytes, getDeliveryCount, getDestination, getExpiration, getGroupId, getGroupSequence, getMessageId, getPriority, getProperty, getPropertyNames, getProviderMessageIdObject, getRedeliveryCount, getReplyTo, getReplyToGroupId, getTimestamp, getType, getUserId, hasAmqpTimeToLiveOverride, isPersistent, isRedelivered, onDispatch, propertyExists, setAmqpTimeToLiveOverride, setApplicationProperty, setContentType, setCorrelationId, setCorrelationIdBytes, setDeliveryCount, setDestination, setExpiration, setGroupId, setGroupSequence, setMessageId, setPersistent, setPriority, setProperty, setProviderMessageIdObject, setRedelivered, setRedeliveryCount, setReplyTo, setReplyToGroupId, setTimestamp, setType, setUserId

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.qpid.jms.message.facade.JmsMessageFacade

clearProperties, getCorrelationId, getCorrelationIdBytes, getDeliveryCount, getDestination, getExpiration, getGroupId, getGroupSequence, getMessageId, getPriority, getProperty, getPropertyNames, getProviderMessageIdObject, getRedeliveryCount, getReplyTo, getTimestamp, getType, getUserId, isPersistent, isRedelivered, onDispatch, propertyExists, setCorrelationId, setCorrelationIdBytes, setDeliveryCount, setDestination, setExpiration, setGroupId, setGroupSequence, setMessageId, setPersistent, setPriority, setProperty, setProviderMessageIdObject, setRedelivered, setRedeliveryCount, setReplyTo, setTimestamp, setType, setUserId

Constructor Detail

AmqpJmsObjectMessageFacade

public AmqpJmsObjectMessageFacade(AmqpConnection connection,
                          boolean isAmqpTypeEncoded)

Creates a new facade instance

Parameters:

connection - the AmqpConnection that under which this facade was created.

isAmqpTypeEncoded - controls the type used to encode the body.

AmqpJmsObjectMessageFacade

public AmqpJmsObjectMessageFacade(AmqpConsumer consumer,
                          org.apache.qpid.proton.message.Message message)

Creates a new Facade around an incoming AMQP Message for dispatch to the JMS Consumer instance.

Parameters:

consumer - the consumer that received this message.

message - the incoming Message instance that is being wrapped.

Method Detail

getJmsMsgType

public byte getJmsMsgType()

Overrides:

getJmsMsgType in class AmqpJmsMessageFacade

Returns:

the appropriate byte value that indicates the type of message this is.

isAmqpTypedEncoding

public boolean isAmqpTypedEncoding()

copy

public AmqpJmsObjectMessageFacade copy()
                                throws javax.jms.JMSException

Description copied from interface: JmsMessageFacade

Create a new instance and perform a deep copy of this object's contents.

Specified by:

copy in interface JmsMessageFacade

Specified by:

copy in interface JmsObjectMessageFacade

Overrides:

copy in class AmqpJmsMessageFacade

Returns:

a copy of this JmsMessageFacade instance.

Throws:

javax.jms.JMSException - if an error occurs while copying the message.

getObject

public Serializable getObject()
                       throws IOException,
                              ClassNotFoundException

Description copied from interface: JmsObjectMessageFacade

Gets the Object value that is contained in the provider message. If the Object is stored in some serialized form then the Provider must de-serialize the object prior to returning it.

Specified by:

getObject in interface JmsObjectMessageFacade

Returns:

the de-serialized version of the contained object.

Throws:

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

ClassNotFoundException - if object de-serialization fails because the ClassLoader cannot find the Class locally.

setObject

public void setObject(Serializable value)
               throws IOException

Description copied from interface: JmsObjectMessageFacade

Stores the given object into the provider Message. In order for the provider to be fully JMS compliant the set Object should be immediately serialized and stored so that future modifications to the object are not reflected in the stored version of the object.

Specified by:

setObject in interface JmsObjectMessageFacade

Parameters:

value - the new value to write to the provider message.

Throws:

IOException - if the provider fails to store the object due to some internal error.

clearBody

public void clearBody()

Description copied from interface: JmsMessageFacade

Clears the contents of this Message.

Specified by:

clearBody in interface JmsMessageFacade

Overrides:

clearBody in class AmqpJmsMessageFacade

onSend

public void onSend(long producerTtl)
            throws javax.jms.JMSException

Description copied from interface: JmsMessageFacade

Called before a message is sent to allow a Message instance to move the contents from a logical data structure to a binary form for transmission, or other processing such as setting proper message headers etc. The method allows for passing through producer configuration details not explicitly mapped into the JMS Message allowing the facade to create the most correct and compact message on the wire.

Specified by:

onSend in interface JmsMessageFacade

Overrides:

onSend in class AmqpJmsMessageFacade

Parameters:

producerTtl - the time to live value configured on the producer when sent.

Throws:

javax.jms.JMSException - if an error occurs while preparing the message for send.