| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
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.
Connection, 
ConnectionFactory, 
QueueConnectionFactory| Method Summary | |
|  ConnectionConsumer | createConnectionConsumer(Queue queue,
                         java.lang.String messageSelector,
                         ServerSessionPool sessionPool,
                         int maxMessages)Creates a connection consumer for this connection (optional operation). | 
|  QueueSession | createQueueSession(boolean transacted,
                   int acknowledgeMode)Creates a QueueSessionobject. | 
| Methods inherited from interface javax.jms.Connection | 
| close, createConnectionConsumer, createDurableConnectionConsumer, createSession, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop | 
| Method Detail | 
public QueueSession createQueueSession(boolean transacted,
                                       int acknowledgeMode)
                                throws JMSException
QueueSession object.
transacted - indicates whether the session is transactedacknowledgeMode - 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.
JMSException - 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.Session.AUTO_ACKNOWLEDGE, 
Session.CLIENT_ACKNOWLEDGE, 
Session.DUPS_OK_ACKNOWLEDGE
public ConnectionConsumer createConnectionConsumer(Queue queue,
                                                   java.lang.String messageSelector,
                                                   ServerSessionPool sessionPool,
                                                   int maxMessages)
                                            throws JMSException
queue - the queue to accessmessageSelector - 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 consumermaxMessages - the maximum number of messages that can be
 assigned to a server session at one time
JMSException - if the QueueConnection object fails
                         to create a connection consumer due to some
                         internal error or invalid arguments for 
                         sessionPool and 
                         messageSelector.
InvalidDestinationException - if an invalid queue is specified.
InvalidSelectorException - if the message selector is invalid.ConnectionConsumer| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved.