Oracle® Streams Advanced Queuing Java API Reference
Release 1 (10.1)

B12023-01

oracle.jms
Class AQjmsTopicConnectionFactory

java.lang.Object
  |
  +--oracle.jms.AQjmsConnectionFactory
        |
        +--oracle.jms.AQjmsTopicConnectionFactory
All Implemented Interfaces:
ConnectionFactory, javax.naming.spi.ObjectFactory, javax.naming.Referenceable, java.io.Serializable, TopicConnectionFactory

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

Oracle class implementing javax.jms.TopicConnectionFactory. A TopicConnectionFactory is an encapsulation of JMS servers to which Topic Connections can be created to access Topics for message distri- bution.

See Also:
Serialized Form

Method Summary
 javax.jms.TopicConnection createTopicConnection()
          create a Topic Connection to the JMS Server hosting this Topic- connection factory.
static javax.jms.TopicConnection createTopicConnection(java.sql.Connection jdbc_connection)
          create a Topic Connection using JDBC connection.
static javax.jms.TopicConnection createTopicConnection(oracle.jdbc.pool.OracleOCIConnectionPool cpool)
          create a Topic Connection using an OCI connection pool.
 javax.jms.TopicConnection createTopicConnection(java.lang.String username, java.lang.String password)
          create a Topic Connection using the given username and password for authentication during creation of the Connection.
 javax.naming.Reference getReference()
           

 

Methods inherited from class oracle.jms.AQjmsConnectionFactory
createConnection, createConnection, getObjectInstance

 

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

 

Method Detail

createTopicConnection

public javax.jms.TopicConnection createTopicConnection()
                                                throws JMSException
create a Topic Connection to the JMS Server hosting this Topic- connection factory.
Specified by:
createTopicConnection in interface TopicConnectionFactory
Returns:
a Topic Connection
Throws:
JMSException - if JMS fails to get a topic connection due to some JMS error

createTopicConnection

public javax.jms.TopicConnection createTopicConnection(java.lang.String username,
                                                       java.lang.String password)
                                                throws JMSException
create a Topic Connection using the given username and password for authentication during creation of the Connection.
Specified by:
createTopicConnection in interface TopicConnectionFactory
Parameters:
username - name of the user connecting to the DB for Queueing. password password for the user creating the connection.
password - the caller's password
Returns:
a Topic Connection
Throws:
JMSException - if JMS fails to get a topic connection due to some JMS error

createTopicConnection

public static javax.jms.TopicConnection createTopicConnection(java.sql.Connection jdbc_connection)
                                                       throws JMSException
create a Topic Connection using JDBC connection. create a TopicConnection using the already open JDBC connection. This creation does NOT result in creation of another connection to the database. Instid JMS binds to the given connection to the database and provides an interface to the Pub/Sub mechanism defined by JMS.
Parameters:
jdbc_connection - a valid open connection to the database.
Returns:
a TopicConnection
Throws:
JMSException - if JMS fails to get a topic connection due to some JMS error

createTopicConnection

public static javax.jms.TopicConnection createTopicConnection(oracle.jdbc.pool.OracleOCIConnectionPool cpool)
                                                       throws JMSException
create a Topic Connection using an OCI connection pool. create a TopicConnection using the already open OCI connection pool. This creation does NOT result in creation of another connection pool to the database. Instid JMS binds to the given connection pool to the database and provides an interface to the Pub/Sub mechanism defined by JMS.
Parameters:
cpool - a valid open connection pool to the database.
Returns:
a TopicConnection
Throws:
JMSException - if JMS fails to get a topic connection due to some JMS error

getReference

public javax.naming.Reference getReference()
Specified by:
getReference in interface javax.naming.Referenceable
Overrides:
getReference in class AQjmsConnectionFactory

Oracle® Streams Advanced Queuing Java API Reference
Release 1 (10.1)

B12023-01

Copyright © 2003, Oracle. All Rights Reserved.