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

Direct Known Subclasses:

AQjmsXATopicConnectionFactory

public class AQjmsTopicConnectionFactory

extends AQjmsConnectionFactory

implements TopicConnectionFactory, javax.naming.Referenceable, 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

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.
TopicConnection	createTopicConnection(java.lang.String username, java.lang.String password) Creates a topic connection using the specified user identity.
javax.naming.Reference	getReference() Creates a JMS topic connection factory reference suitable for passing to AQjmsConnectionFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable).

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 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:

password - the caller's password

username - the caller's user name

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.

getReference

public javax.naming.Reference getReference()

Creates a JMS topic connection factory reference suitable for passing to AQjmsConnectionFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable).

Specified by:

getReference in interface javax.naming.Referenceable

Overrides:

getReference in class AQjmsConnectionFactory

Returns:

a topic connection factory reference with object and factory class names set