oracle.jms
Class AQjmsQueueConnectionFactory

java.lang.Object
  |
  +--oracle.jms.AQjmsConnectionFactory
        |
        +--oracle.jms.AQjmsQueueConnectionFactory

All Implemented Interfaces:

ConnectionFactory, javax.naming.spi.ObjectFactory, QueueConnectionFactory, javax.naming.Referenceable, java.io.Serializable

public class AQjmsQueueConnectionFactory

extends AQjmsConnectionFactory

implements QueueConnectionFactory, javax.naming.Referenceable, java.io.Serializable

Oracle class implementing javax.jms.QueueConnectionFactory. A QueueConnectionFactory is an encapsulation of JMS servers to which Queue Connections can be created to access Message Queuing facilites.

See Also:

Serialized Form

createQueueConnection

public javax.jms.QueueConnection createQueueConnection()
                                                throws JMSException

create a Queue Connection to the JMS Server hosting this Queue- ConnectionFactory.

Specified by:

createQueueConnection in interface QueueConnectionFactory

Returns:

a Queue Connection

Throws:

JMSException - if JMS fails to get a queue connection due to some JMS error

createQueueConnection

public javax.jms.QueueConnection createQueueConnection(java.lang.String username,
                                                       java.lang.String password)
                                                throws JMSException

create a Queue Connection using the given username and password for authentication during creation of the Connection.

Specified by:

createQueueConnection in interface QueueConnectionFactory

Parameters:

username - name of the user connecting to the DB for Queueing. password password for the creating the connection to server.

password - the caller's password

Returns:

a Queue Connection

Throws:

JMSException - if JMS fails to get a queue connection due to some JMS error

createQueueConnection

public static javax.jms.QueueConnection createQueueConnection(java.sql.Connection jdbc_connection)
                                                       throws JMSException

create a Queue Connection 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 Queuing mechanism defined by JMS.

Parameters:

jdbc_connection - a valid open connection to the database.

Returns:

a Queue Connection

Throws:

JMSException - if JMS fails to get a queue connection due to some JMS error

createQueueConnection

public static javax.jms.QueueConnection createQueueConnection(oracle.jdbc.pool.OracleOCIConnectionPool cpool)
                                                       throws JMSException

create a Queue Connection using the already open OCI connection pool. This creation does NOT result in creation of another connection pool to the database. Instead JMS binds to the given OCI connection pool to the database and provides an interface to the Queuing mechanism defined by JMS.

Parameters:

cpool - a valid open connection OCI connection pool to the database.

Returns:

a Queue Connection

Throws:

JMSException - if JMS fails to get a queue 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