org.apache.qpid.client

Class AMQSession_0_8

java.lang.Object

org.apache.qpid.client.Closeable

org.apache.qpid.client.AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

org.apache.qpid.client.AMQSession_0_8

All Implemented Interfaces:

Runnable, javax.jms.QueueSession, javax.jms.Session, javax.jms.TopicSession

public class AMQSession_0_8
extends AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AMQSession_0_8.DestinationCache<T extends AMQDestination>

Nested classes/interfaces inherited from class org.apache.qpid.client.AMQSession

AMQSession.Dispatchable, AMQSession.IdToConsumerMap<C extends BasicMessageConsumer>

Field Summary

Fields

Modifier and Type	Field and Description
static String	QPID_SYNC_AFTER_CLIENT_ACK

Fields inherited from class org.apache.qpid.client.AMQSession

DEAMON_DISPATCHER_THREAD, IMMEDIATE_PREFETCH, IMMEDIATE_PREFETCH_DEFAULT, STRICT_AMQP, STRICT_AMQP_DEFAULT, STRICT_AMQP_FATAL, STRICT_AMQP_FATAL_DEFAULT

Fields inherited from interface org.apache.qpid.jms.Session

NO_ACKNOWLEDGE, PRE_ACKNOWLEDGE

Fields inherited from interface javax.jms.Session

AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTED

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AMQSession_0_8(AMQConnection con, int channelId, boolean transacted, int acknowledgeMode, MessageFactoryRegistry messageFactoryRegistry, int defaultPrefetchHighMark, int defaultPrefetchLowMark) Creates a new session on a connection.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	acknowledgeImpl()
void	acknowledgeMessage(long deliveryTag, boolean multiple) Acknowledge one or many messages.
void	commitImpl()
BasicMessageConsumer_0_8	createMessageConsumer(AMQDestination destination, int prefetchHigh, int prefetchLow, boolean noLocal, boolean exclusive, String messageSelector, FieldTable arguments, boolean noConsume, boolean autoClose)
BasicMessageProducer_0_8	createMessageProducer(javax.jms.Destination destination, Boolean mandatory, Boolean immediate, long producerId)
protected AMQShortString	declareQueue(AMQDestination amqd, boolean noLocal, boolean nowait, boolean passive)
protected void	deleteTemporaryDestination(org.apache.qpid.client.TemporaryDestination amqQueue) Undeclares the specified temporary queue/topic.
protected void	doBind(AMQDestination dest, AMQDestination.Binding binding, String queue, String exchange)
protected void	doUnbind(AMQDestination.Binding binding, String queue, String exchange)
protected boolean	exchangeExists(AMQShortString exchangeName)
protected void	flushAcknowledgments()
AMQException	getLastException()
AMQMessageDelegateFactory	getMessageDelegateFactory()
MethodRegistry	getMethodRegistry()
AMQSession_0_8.DestinationCache<AMQQueue>	getQueueDestinationCache()
AMQSession_0_8.DestinationCache<AMQTopic>	getTopicDestinationCache()
protected void	handleQueueNodeCreation(AMQDestination dest, boolean noLocal)
protected boolean	isBound(AMQShortString exchangeName, AMQShortString queueName, AMQShortString routingKey) Checks if a particular queue is bound to an exchange with a given key.
boolean	isExchangeExist(AMQDestination dest, boolean assertNode)
boolean	isFlowBlocked() Tests whether flow to this session is blocked.
boolean	isQueueBound(AMQDestination destination)
boolean	isQueueBound(AMQShortString exchangeName, AMQShortString queueName, AMQShortString routingKey) Tests whether or not the specified queue is bound to the specified exchange under a particular routing key.
boolean	isQueueBound(String exchangeName, String queueName, String bindingKey, Map<String,Object> args)
boolean	isQueueExist(AMQDestination dest, boolean assertNode)
boolean	isQueueExist(String queueName, boolean assertNode, boolean durable, boolean autoDelete, boolean exclusive, Map<String,Object> args)
void	messageReceived(UnprocessedMessage message) Invoked by the MINA IO thread (indirectly) when a message is received from the transport.
void	rejectMessage(long deliveryTag, boolean requeue)
void	releaseForRollback()
protected Long	requestQueueDepth(AMQDestination amqd, boolean sync)
void	resolveAddress(AMQDestination dest, boolean isConsumer, boolean noLocal) 1.
int	resolveAddressType(AMQDestination dest)
void	sendClose(long timeout)
void	sendConsume(BasicMessageConsumer_0_8 consumer, AMQShortString queueName, boolean nowait, int tag)
void	sendCreateQueue(AMQShortString name, boolean autoDelete, boolean durable, boolean exclusive, Map<String,Object> arguments)
void	sendExchangeDeclare(AMQShortString name, AMQShortString type, boolean nowait, boolean durable, boolean autoDelete, boolean internal)
void	sendExchangeDeclare(AMQShortString name, AMQShortString type, boolean nowait, boolean durable, boolean autoDelete, FieldTable arguments, boolean passive)
void	sendExchangeDelete(String name)
void	sendQueueBind(AMQShortString queueName, AMQShortString routingKey, FieldTable arguments, AMQShortString exchangeName, AMQDestination destination, boolean nowait)
void	sendQueueDelete(AMQShortString queueName)
void	sendRecover()
void	sendRollback()
void	sendSuspendChannel(boolean suspend)
void	setFlowControl(boolean active)
void	setPrefetchLimits(int messagePrefetch, long sizePrefetch)
void	sync()
protected boolean	tagLE(long tag1, long tag2)
protected boolean	updateRollbackMark(long currentMark, long deliveryTag)

Methods inherited from class org.apache.qpid.client.AMQSession

acknowledge, addBindingKey, addDeliveredMessage, addUnacknowledgedMessage, bindQueue, bindQueue, checkNotClosed, checkTransacted, checkValidTopic, checkValidTopic, close, close, closed, commit, confirmConsumerCancelled, createBrowser, createBrowser, createBrowserConsumer, createBytesMessage, createConsumer, createConsumer, createConsumer, createConsumer, createConsumer, createConsumer, createConsumerImpl, createDurableSubscriber, createDurableSubscriber, createListMessage, createMapMessage, createMessage, createObjectMessage, createObjectMessage, createProducer, createProducer, createProducer, createPublisher, createQueue, createQueue, createQueue, createQueueReceiver, createQueueReceiver, createReceiver, createReceiver, createSender, createStreamMessage, createSubscriber, createSubscriber, createTemporaryQueue, createTemporaryTopic, createTextMessage, createTextMessage, createTopic, declareAndBind, declareAndBind, declareExchange, declareQueue, declareQueue, deleteQueue, dispatch, getAcknowledgeMode, getAMQConnection, getChannelId, getConsumers, getDefaultPrefetch, getDefaultPrefetchHigh, getDefaultPrefetchLow, getDefaultQueueExchangeName, getDefaultTopicExchangeName, getDeliveredMessageTags, getDispatcher, getDispatcherThread, getFailoverMutex, getHighestDeliveryTag, getMessageFactoryRegistry, getMessageListener, getPrefetch, getPrefetchedMessageTags, getQueueDepth, getQueueDepth, getTemporaryQueueExchangeName, getTemporaryTopicExchangeName, getTicket, getTransacted, getUnacknowledgedMessageTags, hasConsumer, hasFailedOverDirty, hasMessageListeners, isClosed, isClosing, isDeclareExchanges, isImmediatePrefetch, isStrictAMQP, isSuspended, isTransacted, markClean, markDirty, prefetch, preprocessAddressTopic, recover, rejectMessage, rejectMessage, rollback, run, setLegacyFieldsForQueueType, setLegacyFieldsForTopicType, setMessageListener, setTicket, setUsingDispatcherForCleanup, stopDispatcherThread, suspendChannel, unsubscribe, verifySubject

Methods inherited from class org.apache.qpid.client.Closeable

resetClosedFlag, setClosed, setClosing

Methods inherited from class java.lang.Object

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

Field Detail

QPID_SYNC_AFTER_CLIENT_ACK

public static final String QPID_SYNC_AFTER_CLIENT_ACK

See Also:

Constant Field Values

Constructor Detail

AMQSession_0_8

protected AMQSession_0_8(AMQConnection con,
              int channelId,
              boolean transacted,
              int acknowledgeMode,
              MessageFactoryRegistry messageFactoryRegistry,
              int defaultPrefetchHighMark,
              int defaultPrefetchLowMark)

Creates a new session on a connection.

Parameters:

con - The connection on which to create the session.

channelId - The unique identifier for the session.

transacted - Indicates whether or not the session is transactional.

acknowledgeMode - The acknowledgement mode for the session.

messageFactoryRegistry - The message factory factory for the session.

defaultPrefetchHighMark - The maximum number of messages to prefetched before suspending the session.

defaultPrefetchLowMark - The number of prefetched messages at which to resume the session.

Method Detail

acknowledgeImpl

protected void acknowledgeImpl()
                        throws javax.jms.JMSException

Specified by:

acknowledgeImpl in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

javax.jms.JMSException

acknowledgeMessage

public void acknowledgeMessage(long deliveryTag,
                      boolean multiple)

Description copied from class: AMQSession

Acknowledge one or many messages.

Specified by:

acknowledgeMessage in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Parameters:

deliveryTag - The tag of the last message to be acknowledged.

multiple - true to acknowledge all messages up to and including the one specified by the delivery tag, false to just acknowledge that message. TODO Be aware of possible changes to parameter order as versions change.

sendQueueBind

public void sendQueueBind(AMQShortString queueName,
                 AMQShortString routingKey,
                 FieldTable arguments,
                 AMQShortString exchangeName,
                 AMQDestination destination,
                 boolean nowait)
                   throws AMQException,
                          FailoverException

Specified by:

sendQueueBind in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

sendClose

public void sendClose(long timeout)
               throws AMQException,
                      FailoverException

Specified by:

sendClose in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

commitImpl

public void commitImpl()
                throws AMQException,
                       FailoverException,
                       TransportException

Specified by:

commitImpl in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

TransportException

sendCreateQueue

public void sendCreateQueue(AMQShortString name,
                   boolean autoDelete,
                   boolean durable,
                   boolean exclusive,
                   Map<String,Object> arguments)
                     throws AMQException,
                            FailoverException

Specified by:

sendCreateQueue in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

sendRecover

public void sendRecover()
                 throws AMQException,
                        FailoverException

Specified by:

sendRecover in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

releaseForRollback

public void releaseForRollback()

Specified by:

releaseForRollback in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

rejectMessage

public void rejectMessage(long deliveryTag,
                 boolean requeue)

Specified by:

rejectMessage in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

isQueueBound

public boolean isQueueBound(AMQDestination destination)
                     throws javax.jms.JMSException

Specified by:

isQueueBound in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

javax.jms.JMSException

isQueueBound

public boolean isQueueBound(AMQShortString exchangeName,
                   AMQShortString queueName,
                   AMQShortString routingKey)
                     throws javax.jms.JMSException

Description copied from class: AMQSession

Tests whether or not the specified queue is bound to the specified exchange under a particular routing key.

Note that this operation automatically retries in the event of fail-over.

Specified by:

isQueueBound in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Parameters:

exchangeName - The exchange name to test for binding against.

queueName - The queue name to check if bound.

routingKey - The routing key to check if the queue is bound under.

Returns:

true if the queue is bound to the exchange and routing key, false if not.

Throws:

javax.jms.JMSException - If the query fails for any reason. TODO Be aware of possible changes to parameter order as versions change.

isBound

protected boolean isBound(AMQShortString exchangeName,
              AMQShortString queueName,
              AMQShortString routingKey)
                   throws AMQException

Checks if a particular queue is bound to an exchange with a given key. Returns false if not connected to a Qpid broker which supports the necessary AMQP extension.

Specified by:

isBound in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

exchangeExists

protected boolean exchangeExists(AMQShortString exchangeName)
                          throws AMQException

Throws:

AMQException

sendConsume

public void sendConsume(BasicMessageConsumer_0_8 consumer,
               AMQShortString queueName,
               boolean nowait,
               int tag)
                 throws AMQException,
                        FailoverException

Specified by:

sendConsume in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

sendExchangeDeclare

public void sendExchangeDeclare(AMQShortString name,
                       AMQShortString type,
                       boolean nowait,
                       boolean durable,
                       boolean autoDelete,
                       boolean internal)
                         throws AMQException,
                                FailoverException

Specified by:

sendExchangeDeclare in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

sendExchangeDeclare

public void sendExchangeDeclare(AMQShortString name,
                       AMQShortString type,
                       boolean nowait,
                       boolean durable,
                       boolean autoDelete,
                       FieldTable arguments,
                       boolean passive)
                         throws AMQException,
                                FailoverException

Specified by:

sendExchangeDeclare in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

sendExchangeDelete

public void sendExchangeDelete(String name)
                        throws AMQException,
                               FailoverException

Throws:

AMQException

FailoverException

declareQueue

protected AMQShortString declareQueue(AMQDestination amqd,
                          boolean noLocal,
                          boolean nowait,
                          boolean passive)
                               throws AMQException

Specified by:

declareQueue in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

sendQueueDelete

public void sendQueueDelete(AMQShortString queueName)
                     throws AMQException,
                            FailoverException

Specified by:

sendQueueDelete in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

sendSuspendChannel

public void sendSuspendChannel(boolean suspend)
                        throws AMQException,
                               FailoverException

Specified by:

sendSuspendChannel in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

createMessageConsumer

public BasicMessageConsumer_0_8 createMessageConsumer(AMQDestination destination,
                                             int prefetchHigh,
                                             int prefetchLow,
                                             boolean noLocal,
                                             boolean exclusive,
                                             String messageSelector,
                                             FieldTable arguments,
                                             boolean noConsume,
                                             boolean autoClose)
                                               throws javax.jms.JMSException

Specified by:

createMessageConsumer in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

javax.jms.JMSException

createMessageProducer

public BasicMessageProducer_0_8 createMessageProducer(javax.jms.Destination destination,
                                             Boolean mandatory,
                                             Boolean immediate,
                                             long producerId)
                                               throws javax.jms.JMSException

Specified by:

createMessageProducer in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

javax.jms.JMSException

messageReceived

public void messageReceived(UnprocessedMessage message)

Description copied from class: AMQSession

Invoked by the MINA IO thread (indirectly) when a message is received from the transport. Puts the message onto the queue read by the dispatcher.

Overrides:

messageReceived in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Parameters:

message - the message that has been received

sendRollback

public void sendRollback()
                  throws AMQException,
                         FailoverException

Specified by:

sendRollback in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

setPrefetchLimits

public void setPrefetchLimits(int messagePrefetch,
                     long sizePrefetch)
                       throws AMQException

Throws:

AMQException

getQueueDestinationCache

public AMQSession_0_8.DestinationCache<AMQQueue> getQueueDestinationCache()

getTopicDestinationCache

public AMQSession_0_8.DestinationCache<AMQTopic> getTopicDestinationCache()

requestQueueDepth

protected Long requestQueueDepth(AMQDestination amqd,
                     boolean sync)
                          throws AMQException,
                                 FailoverException

Specified by:

requestQueueDepth in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

FailoverException

tagLE

protected boolean tagLE(long tag1,
            long tag2)

Specified by:

tagLE in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

updateRollbackMark

protected boolean updateRollbackMark(long currentMark,
                         long deliveryTag)

Specified by:

updateRollbackMark in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

getMessageDelegateFactory

public AMQMessageDelegateFactory getMessageDelegateFactory()

Specified by:

getMessageDelegateFactory in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

sync

public void sync()
          throws AMQException

Specified by:

sync in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

resolveAddress

public void resolveAddress(AMQDestination dest,
                  boolean isConsumer,
                  boolean noLocal)
                    throws AMQException

Description copied from class: AMQSession

1. Try to resolve the address type (queue or exchange) 2. if type == queue, 2.1 verify queue exists or create if create == true 2.2 If not throw exception 3. if type == exchange, 3.1 verify exchange exists or create if create == true 3.2 if not throw exception 3.3 if exchange exists (or created) create subscription queue.

Overrides:

resolveAddress in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

resolveAddressType

public int resolveAddressType(AMQDestination dest)
                       throws AMQException

Specified by:

resolveAddressType in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

handleQueueNodeCreation

protected void handleQueueNodeCreation(AMQDestination dest,
                           boolean noLocal)
                                throws AMQException

Specified by:

handleQueueNodeCreation in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

doBind

protected void doBind(AMQDestination dest,
          AMQDestination.Binding binding,
          String queue,
          String exchange)
               throws AMQException

Specified by:

doBind in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

doUnbind

protected void doUnbind(AMQDestination.Binding binding,
            String queue,
            String exchange)
                 throws AMQException

Throws:

AMQException

isQueueExist

public boolean isQueueExist(AMQDestination dest,
                   boolean assertNode)
                     throws AMQException

Specified by:

isQueueExist in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

isQueueExist

public boolean isQueueExist(String queueName,
                   boolean assertNode,
                   boolean durable,
                   boolean autoDelete,
                   boolean exclusive,
                   Map<String,Object> args)
                     throws AMQException

Throws:

AMQException

isExchangeExist

public boolean isExchangeExist(AMQDestination dest,
                      boolean assertNode)
                        throws AMQException

Specified by:

isExchangeExist in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

AMQException

flushAcknowledgments

protected void flushAcknowledgments()

Specified by:

flushAcknowledgments in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

deleteTemporaryDestination

protected void deleteTemporaryDestination(org.apache.qpid.client.TemporaryDestination amqQueue)
                                   throws javax.jms.JMSException

Description copied from class: AMQSession

Undeclares the specified temporary queue/topic.

Note that this operation automatically retries in the event of fail-over.

Overrides:

deleteTemporaryDestination in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Parameters:

amqQueue - The name of the temporary destination to delete.

Throws:

javax.jms.JMSException - If the queue could not be deleted for any reason. TODO Be aware of possible changes to parameter order as versions change.

isQueueBound

public boolean isQueueBound(String exchangeName,
                   String queueName,
                   String bindingKey,
                   Map<String,Object> args)
                     throws javax.jms.JMSException

Specified by:

isQueueBound in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

javax.jms.JMSException

getMethodRegistry

public MethodRegistry getMethodRegistry()

getLastException

public AMQException getLastException()

Specified by:

getLastException in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

isFlowBlocked

public boolean isFlowBlocked()

Description copied from class: AMQSession

Tests whether flow to this session is blocked.

Specified by:

isFlowBlocked in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Returns:

true if flow is blocked or false otherwise.

setFlowControl

public void setFlowControl(boolean active)

Specified by:

setFlowControl in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>