oracle.toplink.essentials.sessions

Class DirectConnector

java.lang.Object

oracle.toplink.essentials.sessions.DefaultConnector

oracle.toplink.essentials.sessions.DirectConnector

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Connector

public class DirectConnector
extends DefaultConnector

Purpose:Use this Connector to build a java.sql.Connection by directly instantiating the Driver, as opposed to using the DriverManager.

Since:

TOPLink/Java 2.1

Author:

Big Country

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected java.sql.Driver	cachedInstance cache up the instantiated Driver to speed up reconnects

Fields inherited from class oracle.toplink.essentials.sessions.DefaultConnector

databaseURL, driverClassName, driverURLHeader

Constructor Summary

Constructors

Constructor and Description
DirectConnector() PUBLIC: Construct a Connector with default settings (Sun JDBC-ODBC bridge).
DirectConnector(java.lang.String driverClassName, java.lang.String driverURLHeader, java.lang.String databaseURL) PUBLIC: Construct a Connector with the specified settings.

Method Summary

Modifier and Type	Method and Description
java.sql.Connection	connect(java.util.Properties properties) INTERNAL: Connect with the specified properties and return the Connection.
protected java.sql.Driver	instantiateDriver(java.lang.Class driverClass) INTERNAL: Instantiate the Driver if necessary.

Methods inherited from class oracle.toplink.essentials.sessions.DefaultConnector

clone, getConnectionDetails, getConnectionString, getDatabaseURL, getDriverClassName, getDriverURLHeader, initialize, loadDriver, setDatabaseURL, setDriverClassName, setDriverURLHeader, toString, toString

Methods inherited from class java.lang.Object

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

Field Detail

cachedInstance

protected java.sql.Driver cachedInstance

cache up the instantiated Driver to speed up reconnects

Constructor Detail

DirectConnector

public DirectConnector()

PUBLIC: Construct a Connector with default settings (Sun JDBC-ODBC bridge). Although this does not really make sense for a "direct" Connector - the Sun JdbcOdbcDriver works fine with the DriverManager.

DirectConnector

public DirectConnector(java.lang.String driverClassName,
                       java.lang.String driverURLHeader,
                       java.lang.String databaseURL)

PUBLIC: Construct a Connector with the specified settings.

Method Detail

connect

public java.sql.Connection connect(java.util.Properties properties)
                            throws DatabaseException

INTERNAL: Connect with the specified properties and return the Connection.

Specified by:

connect in interface Connector

Overrides:

connect in class DefaultConnector

Returns:

java.sql.Connection

Throws:

DatabaseException

instantiateDriver

protected java.sql.Driver instantiateDriver(java.lang.Class driverClass)
                                     throws DatabaseException

INTERNAL: Instantiate the Driver if necessary.

Returns:

java.sql.Driver

Throws:

DatabaseException