javax.jms
Interface QueueConnection

All Superinterfaces:

Connection (src)

All Known Subinterfaces:

JmsSessionFactory (src) , XAQueueConnection (src)

All Known Implementing Classes:

JBossConnection (src) , JmsSessionFactoryImpl (src) , SpyConnection (src) , SpyXAConnection (src)

public interface QueueConnection

extends Connection (src)

A QueueConnection object is an active connection to a point-to-point JMS provider. A client uses a QueueConnection object to create one or more QueueSession objects for producing and consuming messages.

A QueueConnection can be used to create a QueueSession, from which specialized queue-related objects can be created. A more general, and recommended, approach is to use the Connection object.

The QueueConnection object should be used to support existing code that has already used it.

A QueueConnection cannot be used to create objects specific to the publish/subscribe domain. The createDurableConnectionConsumer method inherits from Connection, but must throw an IllegalStateException if used from QueueConnection.

See Also:

Connection (src) , ConnectionFactory (src) , QueueConnectionFactory (src)

createQueueSession

public QueueSession (src)  createQueueSession(boolean transacted,
                                       int acknowledgeMode)
                                throws JMSException (src) 

Creates a QueueSession object.

Parameters:

transacted - indicates whether the session is transacted

acknowledgeMode - indicates whether the consumer or the client will acknowledge any messages it receives; ignored if the session is transacted. Legal values are Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, and Session.DUPS_OK_ACKNOWLEDGE.

Returns:

a newly created queue session

Throws:

JMSException (src) - if the QueueConnection object fails to create a session due to some internal error or lack of support for the specific transaction and acknowledgement mode.

See Also:

Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, Session.DUPS_OK_ACKNOWLEDGE

createConnectionConsumer

public ConnectionConsumer (src)  createConnectionConsumer(Queue (src)  queue,
                                                   java.lang.String messageSelector,
                                                   ServerSessionPool (src)  sessionPool,
                                                   int maxMessages)
                                            throws JMSException (src) 

Creates a connection consumer for this connection (optional operation). This is an expert facility not used by regular JMS clients.

Parameters:

queue - the queue to access

messageSelector - only messages with properties matching the message selector expression are delivered. A value of null or an empty string indicates that there is no message selector for the message consumer.

sessionPool - the server session pool to associate with this connection consumer

maxMessages - the maximum number of messages that can be assigned to a server session at one time

Returns:

the connection consumer

Throws:

JMSException (src) - if the QueueConnection object fails to create a connection consumer due to some internal error or invalid arguments for sessionPool and messageSelector.

InvalidDestinationException (src) - if an invalid queue is specified.

InvalidSelectorException (src) - if the message selector is invalid.

See Also:

ConnectionConsumer (src)