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

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