| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
A TopicConnection object is an active connection to a 
 publish/subscribe JMS provider. A client uses a TopicConnection 
 object to create one or more TopicSession objects
 for producing and consuming messages.
A TopicConnection can be used to create a 
TopicSession, from which
 specialized topic-related objects can be created. 
 A more general, and recommended approach is to use the 
 Connection object. 
 
The TopicConnection object
 should be used to support existing code.
Connection, 
ConnectionFactory, 
TopicConnectionFactory| Method Summary | |
|  ConnectionConsumer | createConnectionConsumer(Topic topic,
                         java.lang.String messageSelector,
                         ServerSessionPool sessionPool,
                         int maxMessages)Creates a connection consumer for this connection (optional operation). | 
|  ConnectionConsumer | createDurableConnectionConsumer(Topic topic,
                                java.lang.String subscriptionName,
                                java.lang.String messageSelector,
                                ServerSessionPool sessionPool,
                                int maxMessages)Create a durable connection consumer for this connection (optional operation). | 
|  TopicSession | createTopicSession(boolean transacted,
                   int acknowledgeMode)Creates a TopicSessionobject. | 
| Methods inherited from interface javax.jms.Connection | 
| close, createConnectionConsumer, createSession, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop | 
| Method Detail | 
public TopicSession createTopicSession(boolean transacted,
                                       int acknowledgeMode)
                                throws JMSException
TopicSession 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 TopicConnection 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(Topic topic,
                                                   java.lang.String messageSelector,
                                                   ServerSessionPool sessionPool,
                                                   int maxMessages)
                                            throws JMSException
topic - the topic 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 TopicConnection object fails
                         to create a connection consumer due to some
                         internal error or invalid arguments for 
                         sessionPool and 
                         messageSelector.
InvalidDestinationException - if an invalid topic is specified.
InvalidSelectorException - if the message selector is invalid.ConnectionConsumer
public ConnectionConsumer createDurableConnectionConsumer(Topic topic,
                                                          java.lang.String subscriptionName,
                                                          java.lang.String messageSelector,
                                                          ServerSessionPool sessionPool,
                                                          int maxMessages)
                                                   throws JMSException
createDurableConnectionConsumer in interface Connectiontopic - the topic to accesssubscriptionName - durable subscription namemessageSelector - 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 
 durable connection consumermaxMessages - the maximum number of messages that can be
 assigned to a server session at one time
JMSException - if the TopicConnection object fails
                         to create a connection consumer due to some
                         internal error or invalid arguments for 
                         sessionPool and 
                         messageSelector.
InvalidDestinationException - if an invalid topic 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.