Skip navigation links

Oracle® Streams Advanced Queuing Java API Reference
11g Release 2 (11.2)

E10768-01


oracle.jms
Class AQjmsTopicConnectionFactory

java.lang.Object
  extended by oracle.jms.AQjmsConnectionFactory
      extended by oracle.jms.AQjmsTopicConnectionFactory

All Implemented Interfaces:
java.io.Serializable, ConnectionFactory, TopicConnectionFactory, javax.naming.spi.ObjectFactory
Direct Known Subclasses:
AQjmsXATopicConnectionFactory

public class AQjmsTopicConnectionFactory
extends AQjmsConnectionFactory
implements TopicConnectionFactory, java.io.Serializable

This is an Oracle class which implements javax.jms.TopicConnectionFactory. A TopicConnectionFactory is an encapsulation of JMS servers to which TopicConnections can be created to access Topics for message distribution.

See Also:
Serialized Form

Constructor Summary
AQjmsTopicConnectionFactory()
          Constructs a TopicConnectionFactory object.

 

Method Summary
 TopicConnection createTopicConnection()
          Creates a topic connection with the default user identity.
static TopicConnection createTopicConnection(java.sql.Connection jdbcConnection)
          Creates a topic connection using an already open JDBC connection.
static TopicConnection createTopicConnection(oracle.jdbc.pool.OracleOCIConnectionPool connectionPool)
          Creates a topic connection using an already open OCI connection pool.
 TopicConnection createTopicConnection(java.lang.String userName, java.lang.String password)
          Creates a topic connection using the specified user identity.

 

Methods inherited from class oracle.jms.AQjmsConnectionFactory
createConnection, createConnection, getDataSource, getJdbcURL, getObjectInstance, getUsername, setDatasource, setJdbcURL, setPassword, setUsername

 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Methods inherited from interface javax.jms.ConnectionFactory
createConnection, createConnection

 

Constructor Detail

AQjmsTopicConnectionFactory

public AQjmsTopicConnectionFactory()
Constructs a TopicConnectionFactory object. Before using the new factory object to create connections, initializes it by setting its properties.

Method Detail

createTopicConnection

public TopicConnection createTopicConnection()
                                      throws JMSException
Creates a topic connection with the default user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.
Specified by:
createTopicConnection in interface TopicConnectionFactory
Returns:
a newly created connection
Throws:
JMSException - if the topic connection is not created due to some error.
JMSSecurityException - if client authentication fails due to an invalid user name or password.

createTopicConnection

public TopicConnection createTopicConnection(java.lang.String userName,
                                             java.lang.String password)
                                      throws JMSException
Creates a topic connection using the specified user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.
Specified by:
createTopicConnection in interface TopicConnectionFactory
Parameters:
userName - the caller's user name
password - the caller's password
Returns:
a newly created topic connection
Throws:
JMSException - if the topic connection is not created due to some error.
JMSSecurityException - if client authentication fails due to an invalid user name or password.

createTopicConnection

public static TopicConnection createTopicConnection(java.sql.Connection jdbcConnection)
                                             throws JMSException
Creates a topic connection using an already open JDBC connection. This creation does NOT result in the creation of another connection to the database. Instead JMS binds the given connection to the database and provides an interface to the Pub/Sub mechanism defined by JMS.
Parameters:
jdbcConnection - a valid open connection to the database.
Returns:
a newly created topic connection
Throws:
JMSException - if the topic connection is not created due to some error.

createTopicConnection

public static TopicConnection createTopicConnection(oracle.jdbc.pool.OracleOCIConnectionPool connectionPool)
                                             throws JMSException
Creates a topic connection using an already open OCI connection pool. This creation does NOT result in the creation of another connection pool to the database. Instead JMS binds the given OCI connection pool to the database and provides an interface to the Pub/Sub mechanism defined by JMS.
Parameters:
connectionPool - a valid open connection OCI connection pool to the database
Returns:
a newly created topic connection
Throws:
JMSException - if the topic connection is not created due to some error.

Skip navigation links

Oracle® Streams Advanced Queuing Java API Reference
11g Release 2 (11.2)

E10768-01


Copyright © 2003, 2009, Oracle and/or its affiliates. All rights reserved.