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

Field Summary

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

DAEMON_DISPATCHER_THREAD, DISPATCHER_SHUTDOWN_TIMEOUT_MS, DISPATCHER_SHUTDOWN_TIMEOUT_MS_DEFAULT, 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, 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, Map<String,Object> arguments, boolean noConsume, boolean autoClose)
BasicMessageProducer_0_8	createMessageProducer(javax.jms.Destination destination, Boolean mandatory, Boolean immediate, long producerId)
protected String	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	ensureCreditForReceive()
protected boolean	exchangeExists(String exchangeName)
protected void	flushAcknowledgments()
QpidException	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 void	incUnacknowledgedMessages()
protected boolean	isBound(String exchangeName, String queueName, String 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(String exchangeName, String queueName, String 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.
protected void	reduceCreditToOriginalSize()
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, String queueName, boolean nowait, int tag)
void	sendCreateQueue(String name, boolean autoDelete, boolean durable, boolean exclusive, Map<String,Object> arguments)
void	sendExchangeDeclare(String name, String type, boolean nowait, boolean durable, boolean autoDelete, boolean internal)
void	sendExchangeDeclare(String name, String type, boolean nowait, boolean durable, boolean autoDelete, Map<String,Object> arguments, boolean passive)
void	sendExchangeDelete(String name, boolean nowait)
void	sendQueueBind(String queueName, String routingKey, Map<String,Object> arguments, String exchangeName, AMQDestination destination, boolean nowait)
void	sendQueueDelete(String queueName)
void	sendRecover()
void	sendRollback()
void	sendSuspendChannel(boolean suspend)
void	setFlowControl(boolean active)
void	setPrefetchLimits(int messagePrefetch, long sizePrefetch)
protected void	stopFlowIfNeccessary()
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, clearDispatchQueue, 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, createTemporaryQueueName, createTemporaryTopic, createTextMessage, createTextMessage, createTopic, declareAndBind, declareAndBind, declareExchange, declareQueue, declareQueue, deleteExchange, deleteQueue, dispatch, drainDispatchQueueWithDispatcher, getAcknowledgeMode, getAMQConnection, getChannelId, getConsumers, getDefaultPrefetch, getDefaultPrefetchHigh, getDefaultPrefetchLow, getDefaultQueueExchangeName, getDefaultTopicExchangeName, getDeliveredMessageTags, getDispatcher, getDispatcherThread, getFailoverMutex, getHighestDeliveryTag, getMessageEncryptionHelper, 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, stopExistingDispatcher, suspendChannel, suspendChannelIfNotClosing, unsubscribe, verifySubject

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

setClosed, setClosing

Methods inherited from class java.lang.Object

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

Constructor Detail

AMQSession_0_8

protected AMQSession_0_8(AMQConnection con,
              int channelId,
              boolean transacted,
              int acknowledgeMode,
              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.

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(String queueName,
                 String routingKey,
                 Map<String,Object> arguments,
                 String exchangeName,
                 AMQDestination destination,
                 boolean nowait)
                   throws QpidException,
                          FailoverException

Specified by:

sendQueueBind in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

sendClose

public void sendClose(long timeout)
               throws QpidException,
                      FailoverException

Specified by:

sendClose in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

commitImpl

public void commitImpl()
                throws QpidException,
                       FailoverException,
                       TransportException

Specified by:

commitImpl in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

TransportException

sendCreateQueue

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

Specified by:

sendCreateQueue in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

sendRecover

public void sendRecover()
                 throws QpidException,
                        FailoverException

Specified by:

sendRecover in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

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(String exchangeName,
                   String queueName,
                   String 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(String exchangeName,
              String queueName,
              String routingKey)
                   throws QpidException

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:

QpidException

exchangeExists

protected boolean exchangeExists(String exchangeName)
                          throws QpidException

Throws:

QpidException

sendConsume

public void sendConsume(BasicMessageConsumer_0_8 consumer,
               String queueName,
               boolean nowait,
               int tag)
                 throws QpidException,
                        FailoverException

Specified by:

sendConsume in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

sendExchangeDeclare

public void sendExchangeDeclare(String name,
                       String type,
                       boolean nowait,
                       boolean durable,
                       boolean autoDelete,
                       boolean internal)
                         throws QpidException,
                                FailoverException

Specified by:

sendExchangeDeclare in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

sendExchangeDeclare

public void sendExchangeDeclare(String name,
                       String type,
                       boolean nowait,
                       boolean durable,
                       boolean autoDelete,
                       Map<String,Object> arguments,
                       boolean passive)
                         throws QpidException,
                                FailoverException

Specified by:

sendExchangeDeclare in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

sendExchangeDelete

public void sendExchangeDelete(String name,
                      boolean nowait)
                        throws QpidException,
                               FailoverException

Throws:

QpidException

FailoverException

declareQueue

protected String declareQueue(AMQDestination amqd,
                  boolean noLocal,
                  boolean nowait,
                  boolean passive)
                       throws QpidException

Specified by:

declareQueue in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

sendQueueDelete

public void sendQueueDelete(String queueName)
                     throws QpidException,
                            FailoverException

Specified by:

sendQueueDelete in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

sendSuspendChannel

public void sendSuspendChannel(boolean suspend)
                        throws QpidException,
                               FailoverException

Specified by:

sendSuspendChannel in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

createMessageConsumer

public BasicMessageConsumer_0_8 createMessageConsumer(AMQDestination destination,
                                             int prefetchHigh,
                                             int prefetchLow,
                                             boolean noLocal,
                                             boolean exclusive,
                                             String messageSelector,
                                             Map<String,Object> 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 QpidException,
                         FailoverException

Specified by:

sendRollback in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

FailoverException

setPrefetchLimits

public void setPrefetchLimits(int messagePrefetch,
                     long sizePrefetch)
                       throws QpidException,
                              FailoverException

Throws:

QpidException

FailoverException

ensureCreditForReceive

protected boolean ensureCreditForReceive()
                                  throws QpidException

Throws:

QpidException

reduceCreditToOriginalSize

protected void reduceCreditToOriginalSize()
                                   throws QpidException

Throws:

QpidException

stopFlowIfNeccessary

protected void stopFlowIfNeccessary()

incUnacknowledgedMessages

protected void incUnacknowledgedMessages()

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 QpidException,
                                 FailoverException

Specified by:

requestQueueDepth in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

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 QpidException

Specified by:

sync in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

resolveAddress

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

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:

QpidException

resolveAddressType

public int resolveAddressType(AMQDestination dest)
                       throws QpidException

Specified by:

resolveAddressType in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

handleQueueNodeCreation

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

Specified by:

handleQueueNodeCreation in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

doBind

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

Specified by:

doBind in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

doUnbind

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

Throws:

QpidException

isQueueExist

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

Specified by:

isQueueExist in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

isQueueExist

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

Throws:

QpidException

isExchangeExist

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

Specified by:

isExchangeExist in class AMQSession<BasicMessageConsumer_0_8,BasicMessageProducer_0_8>

Throws:

QpidException

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 QpidException 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>