org.apache.qpid.client

Class AMQSession_0_10

java.lang.Object

org.apache.qpid.client.Closeable

org.apache.qpid.client.AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

org.apache.qpid.client.AMQSession_0_10

All Implemented Interfaces:

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

Direct Known Subclasses:

XASessionImpl

public class AMQSession_0_10
extends AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>
implements SessionListener

This is a 0.10 Session

Nested Class Summary

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

Method Summary

Methods

Modifier and Type	Method and Description
protected void	acknowledgeImpl()
void	acknowledgeMessage(long deliveryTag, boolean multiple) Acknowledge one or many messages.
protected void	addDeliveredMessage(long id) Store non committed messages for this session
void	closed(Session ssn)
void	commitImpl()
BasicMessageConsumer_0_10	createMessageConsumer(AMQDestination destination, int prefetchHigh, int prefetchLow, boolean noLocal, boolean exclusive, String messageSelector, Map<String,Object> rawSelector, boolean noConsume, boolean autoClose) Create an 0_10 message consumer
BasicMessageProducer_0_10	createMessageProducer(javax.jms.Destination destination, Boolean mandatory, Boolean immediate, long producerId) Create an 0_10 message producer
protected Session	createSession()
protected String	declareQueue(AMQDestination amqd, boolean noLocal, boolean nowait, boolean passive)
protected void	doBind(AMQDestination dest, AMQDestination.Binding binding, String queue, String exchange)
void	exception(Session ssn, SessionException exc)
protected void	flushAcknowledgments()
QpidException	getCurrentException() Get the latest thrown exception.
QpidException	getLastException()
AMQMessageDelegateFactory	getMessageDelegateFactory()
protected Connection	getQpidConnection()
protected Session	getQpidSession() Access to the underlying Qpid Session
protected void	handleQueueNodeCreation(AMQDestination dest, boolean noLocal)
protected boolean	isBound(String exchangeName, String amqQueueName, String routingKey)
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) Bind a queue with an exchange.
boolean	isQueueBound(String exchangeName, String queueName, String bindingKey, Map<String,Object> args)
boolean	isQueueBound(String exchangeName, String queueName, String routingKey, String[] bindingKeys)
boolean	isQueueExist(AMQDestination dest, boolean assertNode)
boolean	isQueueExist(String queueName, boolean assertNode, boolean durable, boolean autoDelete, boolean exclusive, Map<String,Object> args)
void	message(Session ssn, MessageTransfer xfr)
void	opened(Session ssn)
void	rejectMessage(long deliveryTag, boolean requeue) Release (0_8 notion of Reject) an acquired message
void	releaseForRollback()
protected Long	requestQueueDepth(AMQDestination amqd, boolean sync)
int	resolveAddressType(AMQDestination dest)
void	resumed(Session ssn)
String	send0_10QueueDeclare(AMQDestination amqd, boolean noLocal, boolean nowait, boolean passive) Declare a queue with the given queueName
void	sendClose(long timeout) Close this session.
void	sendConsume(BasicMessageConsumer_0_10 consumer, String queueName, boolean nowait, int tag) This method is invoked when a consumer is created Registers the consumer with the broker
void	sendCreateQueue(String name, boolean autoDelete, boolean durable, boolean exclusive, Map<String,Object> arguments) Create a queue with a given name.
void	sendExchangeDeclare(String name, String type, boolean nowait, boolean durable, boolean autoDelete, boolean internal) creates an exchange if it does not already exist
void	sendExchangeDeclare(String name, String type, boolean nowait, boolean durable, boolean autoDelete, Map<String,Object> arguments, boolean passive)
void	sendExchangeDeclare(String name, String type, String alternateExchange, Map<String,Object> args, boolean nowait, boolean durable, boolean autoDelete)
void	sendExchangeDelete(String name, boolean nowait) deletes an exchange
void	sendQueueBind(String queueName, String routingKey, Map<String,Object> arguments, String exchangeName, AMQDestination destination, boolean nowait) Bind a queue with an exchange.
void	sendQueueDelete(String queueName) deletes a queue
void	sendRecover() This method asks the broker to redeliver all unacknowledged messages
void	sendRollback()
void	sendSuspendChannel(boolean suspend) Activate/deactivate the message flow for all the consumers of this session.
protected void	sendTxCompletionsIfNecessary() With 0.10 messages are consumed with window mode, we must send a completion before the window size is reached so credits don't dry up.
void	setCurrentException(SessionException se)
void	setFlowControl(boolean active)
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, 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, deleteTemporaryDestination, 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, messageReceived, prefetch, preprocessAddressTopic, recover, rejectMessage, rejectMessage, resolveAddress, 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

Method Detail

createSession

protected Session createSession()

getQpidConnection

protected Connection getQpidConnection()

acknowledgeMessage

public void acknowledgeMessage(long deliveryTag,
                      boolean multiple)

Acknowledge one or many messages.

Specified by:

acknowledgeMessage in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

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.

flushAcknowledgments

protected void flushAcknowledgments()

Specified by:

flushAcknowledgments in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

sendQueueBind

public void sendQueueBind(String queueName,
                 String routingKey,
                 Map<String,Object> arguments,
                 String exchangeName,
                 AMQDestination destination,
                 boolean nowait)
                   throws QpidException

Bind a queue with an exchange.

Specified by:

sendQueueBind in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Parameters:

queueName - Specifies the name of the queue to bind. If the queue name is empty, refers to the current queue for the session, which is the last declared queue.

exchangeName - The exchange name.

routingKey - Specifies the routing key for the binding.

arguments - 0_8 specific

Throws:

QpidException

sendClose

public void sendClose(long timeout)
               throws QpidException,
                      FailoverException

Close this session.

Specified by:

sendClose in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Parameters:

timeout - no used / 0_8 specific

Throws:

QpidException

FailoverException

sendCreateQueue

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

Create a queue with a given name.

Specified by:

sendCreateQueue in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Parameters:

name - The queue name

autoDelete - If this field is set and the exclusive field is also set, then the queue is deleted when the connection closes.

durable - If set when creating a new queue, the queue will be marked as durable.

exclusive - Exclusive queues can only be used from one connection at a time.

arguments - Exclusive queues can only be used from one connection at a time.

Throws:

QpidException

FailoverException

sendRecover

public void sendRecover()
                 throws QpidException,
                        FailoverException

This method asks the broker to redeliver all unacknowledged messages

Specified by:

sendRecover in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

FailoverException

releaseForRollback

public void releaseForRollback()

Specified by:

releaseForRollback in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

rejectMessage

public void rejectMessage(long deliveryTag,
                 boolean requeue)

Release (0_8 notion of Reject) an acquired message

Specified by:

rejectMessage in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Parameters:

deliveryTag - the message ID

requeue - always true

createMessageConsumer

public BasicMessageConsumer_0_10 createMessageConsumer(AMQDestination destination,
                                              int prefetchHigh,
                                              int prefetchLow,
                                              boolean noLocal,
                                              boolean exclusive,
                                              String messageSelector,
                                              Map<String,Object> rawSelector,
                                              boolean noConsume,
                                              boolean autoClose)
                                                throws javax.jms.JMSException

Create an 0_10 message consumer

Specified by:

createMessageConsumer in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

javax.jms.JMSException

isQueueBound

public boolean isQueueBound(String exchangeName,
                   String queueName,
                   String routingKey)

Bind a queue with an exchange.

Specified by:

isQueueBound in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

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.

isQueueBound

public boolean isQueueBound(AMQDestination destination)

Specified by:

isQueueBound in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

isQueueBound

public boolean isQueueBound(String exchangeName,
                   String queueName,
                   String routingKey,
                   String[] bindingKeys)

isQueueBound

public boolean isQueueBound(String exchangeName,
                   String queueName,
                   String bindingKey,
                   Map<String,Object> args)

Specified by:

isQueueBound in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

isBound

protected boolean isBound(String exchangeName,
              String amqQueueName,
              String routingKey)

Specified by:

isBound in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

sendConsume

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

This method is invoked when a consumer is created Registers the consumer with the broker

Specified by:

sendConsume in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

FailoverException

createMessageProducer

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

Create an 0_10 message producer

Specified by:

createMessageProducer in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

javax.jms.JMSException

sendExchangeDeclare

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

creates an exchange if it does not already exist

Specified by:

sendExchangeDeclare in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

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_10,BasicMessageProducer_0_10>

Throws:

QpidException

FailoverException

sendExchangeDeclare

public void sendExchangeDeclare(String name,
                       String type,
                       String alternateExchange,
                       Map<String,Object> args,
                       boolean nowait,
                       boolean durable,
                       boolean autoDelete)
                         throws QpidException

Throws:

QpidException

sendExchangeDelete

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

deletes an exchange

Throws:

QpidException

FailoverException

send0_10QueueDeclare

public String send0_10QueueDeclare(AMQDestination amqd,
                          boolean noLocal,
                          boolean nowait,
                          boolean passive)
                            throws QpidException

Declare a queue with the given queueName

Throws:

QpidException

sendQueueDelete

public void sendQueueDelete(String queueName)
                     throws QpidException,
                            FailoverException

deletes a queue

Specified by:

sendQueueDelete in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

FailoverException

sendSuspendChannel

public void sendSuspendChannel(boolean suspend)
                        throws QpidException,
                               FailoverException

Activate/deactivate the message flow for all the consumers of this session.

Specified by:

sendSuspendChannel in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

FailoverException

sendRollback

public void sendRollback()
                  throws QpidException,
                         FailoverException

Specified by:

sendRollback in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

FailoverException

getQpidSession

protected Session getQpidSession()

Access to the underlying Qpid Session

Returns:

The associated Qpid Session.

getCurrentException

public QpidException getCurrentException()

Get the latest thrown exception.

Throws:

SessionException - get the latest thrown error.

opened

public void opened(Session ssn)

Specified by:

opened in interface SessionListener

resumed

public void resumed(Session ssn)

Specified by:

resumed in interface SessionListener

message

public void message(Session ssn,
           MessageTransfer xfr)

Specified by:

message in interface SessionListener

exception

public void exception(Session ssn,
             SessionException exc)

Specified by:

exception in interface SessionListener

closed

public void closed(Session ssn)

Specified by:

closed in interface SessionListener

getLastException

public QpidException getLastException()

Specified by:

getLastException in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

declareQueue

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

Specified by:

declareQueue in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

requestQueueDepth

protected Long requestQueueDepth(AMQDestination amqd,
                     boolean sync)

Specified by:

requestQueueDepth in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

addDeliveredMessage

protected void addDeliveredMessage(long id)

Store non committed messages for this session

Overrides:

addDeliveredMessage in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Parameters:

id -

sendTxCompletionsIfNecessary

protected void sendTxCompletionsIfNecessary()

With 0.10 messages are consumed with window mode, we must send a completion before the window size is reached so credits don't dry up.

commitImpl

public void commitImpl()
                throws QpidException,
                       FailoverException,
                       TransportException

Specified by:

commitImpl in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

FailoverException

TransportException

tagLE

protected final boolean tagLE(long tag1,
            long tag2)

Specified by:

tagLE in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

updateRollbackMark

protected final boolean updateRollbackMark(long currentMark,
                         long deliveryTag)

Specified by:

updateRollbackMark in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

sync

public void sync()
          throws QpidException

Specified by:

sync in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

setCurrentException

public void setCurrentException(SessionException se)

getMessageDelegateFactory

public AMQMessageDelegateFactory getMessageDelegateFactory()

Specified by:

getMessageDelegateFactory in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

isExchangeExist

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

Specified by:

isExchangeExist in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

isQueueExist

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

Specified by:

isQueueExist in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

isQueueExist

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

Throws:

QpidException

resolveAddressType

public int resolveAddressType(AMQDestination dest)
                       throws QpidException

Specified by:

resolveAddressType in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

acknowledgeImpl

protected void acknowledgeImpl()

Specified by:

acknowledgeImpl in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

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_10,BasicMessageProducer_0_10>

Returns:

true if flow is blocked or false otherwise.

setFlowControl

public void setFlowControl(boolean active)

Specified by:

setFlowControl in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

handleQueueNodeCreation

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

Specified by:

handleQueueNodeCreation in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>

Throws:

QpidException

doBind

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

Specified by:

doBind in class AMQSession<BasicMessageConsumer_0_10,BasicMessageProducer_0_10>