oracle.jms

Class AQjmsConnectionFactory

java.lang.Object

oracle.jms.AQjmsConnectionFactory

All Implemented Interfaces:

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

Direct Known Subclasses:

AQjmsQueueConnectionFactory, AQjmsTopicConnectionFactory, AQjmsXAConnectionFactory

public class AQjmsConnectionFactory
extends java.lang.Object
implements javax.naming.spi.ObjectFactory, ConnectionFactory, java.io.Serializable

This is an Oracle class which implements javax.jms.ConnectionFactory and javax.naming.spi.ObjectFactory.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AQjmsConnectionFactory() Constructs a ConnectionFactory object.

Method Summary

Modifier and Type	Method and Description
Connection	createConnection() Creates a connection with the default user identity.
Connection	createConnection(java.lang.String userName, java.lang.String password) Creates a connection using the specified user identity.
javax.sql.DataSource	getDataSource() Returns the DataSource property of the connection factory object
java.lang.String	getJdbcURL() Returns the JdbcURL property of the connection factory object
java.lang.Object	getObjectInstance(java.lang.Object obj, javax.naming.Name name, javax.naming.Context nameCtx, java.util.Hashtable environment) Creates a connection factory.
java.lang.String	getUsername() Returns the Username property of the connection factory object
void	setDatasource(javax.sql.DataSource dataSource) Sets the Datasource property for the connection factory object
void	setJdbcURL(java.lang.String jdbcURL) Sets the JdbcURL property for the connection factory object
void	setPassword(java.lang.String password) Sets the Password property for the connection factory object
void	setUsername(java.lang.String user) Sets the Username property for the connection factory object

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AQjmsConnectionFactory

public AQjmsConnectionFactory()

Constructs a ConnectionFactory object. Before using the new factory object to create connections, initializes it by setting its properties.

Method Detail

setJdbcURL

public void setJdbcURL(java.lang.String jdbcURL)
                throws JMSException

Sets the JdbcURL property for the connection factory object

Parameters:

jdbcURL - indicates the database to which the connection factory object creates connections

Throws:

JMSException

getJdbcURL

public java.lang.String getJdbcURL()

Returns the JdbcURL property of the connection factory object

Returns:

the JdbcURL property

setUsername

public void setUsername(java.lang.String user)
                 throws JMSException

Sets the Username property for the connection factory object

Parameters:

user - the database user's name

Throws:

JMSException

getUsername

public java.lang.String getUsername()

Returns the Username property of the connection factory object

Returns:

the Username property

setPassword

public void setPassword(java.lang.String password)
                 throws JMSException

Sets the Password property for the connection factory object

Parameters:

password - the database user's password

Throws:

JMSException

setDatasource

public void setDatasource(javax.sql.DataSource dataSource)
                   throws JMSException

Sets the Datasource property for the connection factory object

Parameters:

dataSource - indicates the database to which the connection factory object creates connections

Throws:

JMSException

getDataSource

public javax.sql.DataSource getDataSource()

Returns the DataSource property of the connection factory object

Returns:

the DataSource property

getObjectInstance

public java.lang.Object getObjectInstance(java.lang.Object obj,
                                          javax.naming.Name name,
                                          javax.naming.Context nameCtx,
                                          java.util.Hashtable environment)
                                   throws JMSException

Creates a connection factory. The connection factory is created using database connection attributes obtained using name and nameCtx.

Specified by:

getObjectInstance in interface javax.naming.spi.ObjectFactory

Parameters:

obj - a javax.naming.Reference indicating the connection factory class

name - the location containing the database connection attributes

nameCtx - a javax.naming.directory.DirContext containing the above location

environment - (not used - parameter required by javax.naming.spi.ObjectFactory interface)

Returns:

a new connection factory object, or null if obj is invalid or looking up the provided name in the provided nameCtx returns a null result

Throws:

JMSException - if a connection factory is not created for any reason other than those listed above (which result in a null return value)

createConnection

public Connection createConnection()
                            throws JMSException

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

createConnection in interface ConnectionFactory

Returns:

a newly created connection

Throws:

JMSException - if the connection is not created due to some error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

Since:

1.1

createConnection

public Connection createConnection(java.lang.String userName,
                                   java.lang.String password)
                            throws JMSException

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

createConnection in interface ConnectionFactory

Parameters:

userName - the caller's user name

password - the caller's password

Returns:

a newly created connection

Throws:

JMSException - if the connection is not created due to some error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

Since:

1.1