javax.jms
Interface QueueConnection
- All Known Subinterfaces:
- XAQueueConnection
- public interface QueueConnection
- extends Connection
A QueueConnection is an active connection to a JMS PTP provider. A
client uses a QueueConnection to create one or more QueueSessions
for producing and consuming messages.
- See Also:
Connection
,
QueueConnectionFactory
createQueueSession
public QueueSession createQueueSession(boolean transacted,
int acknowledgeMode)
throws JMSException
- Create a QueueSession.
- Parameters:
transacted
- if true, the session is transacted.acknowledgeMode
- indicates whether the consumer or the
client will acknowledge any messages it receives. This parameter
will be 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 - if JMS Connection fails to create a
session due to some internal error or
lack of support for specific transaction
and acknowledgement mode.
- See Also:
Session.AUTO_ACKNOWLEDGE
,
Session.CLIENT_ACKNOWLEDGE
,
Session.DUPS_OK_ACKNOWLEDGE
createConnectionConsumer
public ConnectionConsumer createConnectionConsumer(Queue queue,
java.lang.String messageSelector,
ServerSessionPool sessionPool,
int maxMessages)
throws JMSException
- Create a connection consumer for this connection (optional operation).
This is an expert facility not used by regular JMS clients.
- Parameters:
queue
- the queue to accessmessageSelector
- only messages with properties matching the
message selector expression are deliveredsessionPool
- 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 - if JMS Connection fails to create a
a connection consumer due to some internal
error or invalid arguments for sessionPool
and message selector.
- InvalidSelectorException - if the message selector is invalid.
- See Also:
ConnectionConsumer