Skip navigation links

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

E10768-01


oracle.jms
Class AQjmsQueueConnectionFactory

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

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

public class AQjmsQueueConnectionFactory
extends AQjmsConnectionFactory
implements QueueConnectionFactory, java.io.Serializable

This is an Oracle class which implements javax.jms.QueueConnectionFactory. A QueueConnectionFactory is an encapsulation of JMS servers to which QueueConnections can be created to access message queuing facilities.

See Also:
Serialized Form

Constructor Summary
AQjmsQueueConnectionFactory()
          Constructs a QueueConnectionFactory object.

 

Method Summary
 QueueConnection createQueueConnection()
          Creates a queue connection with the default user identity.
static QueueConnection createQueueConnection(java.sql.Connection jdbcConnection)
          Creates a queue connection using an already open JDBC connection.
static QueueConnection createQueueConnection(oracle.jdbc.pool.OracleOCIConnectionPool connectionPool)
          Creates a queue connection using an already open OCI connection pool.
 QueueConnection createQueueConnection(java.lang.String userName, java.lang.String password)
          Creates a queue 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

AQjmsQueueConnectionFactory

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

Method Detail

createQueueConnection

public QueueConnection createQueueConnection()
                                      throws JMSException
Creates a queue 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:
createQueueConnection in interface QueueConnectionFactory
Returns:
a newly created connection
Throws:
JMSException - if the queue connection is not created due to some error.
JMSSecurityException - if client authentication fails due to an invalid user name or password.

createQueueConnection

public QueueConnection createQueueConnection(java.lang.String userName,
                                             java.lang.String password)
                                      throws JMSException
Creates a queue 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:
createQueueConnection in interface QueueConnectionFactory
Parameters:
userName - the caller's user name
password - the caller's password
Returns:
a newly created queue connection
Throws:
JMSException - if the queue connection is not created due to some error.
JMSSecurityException - if client authentication fails due to an invalid user name or password.

createQueueConnection

public static QueueConnection createQueueConnection(java.sql.Connection jdbcConnection)
                                             throws JMSException
Creates a queue 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 queuing mechanism defined by JMS.
Parameters:
jdbcConnection - a valid open connection to the database.
Returns:
a newly created queue connection
Throws:
JMSException - if the queue connection is not created due to some error.

createQueueConnection

public static QueueConnection createQueueConnection(oracle.jdbc.pool.OracleOCIConnectionPool connectionPool)
                                             throws JMSException
Creates a queue 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 queuing mechanism defined by JMS.
Parameters:
connectionPool - a valid open connection OCI connection pool to the database
Returns:
a newly created queue connection
Throws:
JMSException - if the queue 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.