oracle.toplink.essentials.sessions

Class DefaultConnector

java.lang.Object

oracle.toplink.essentials.sessions.DefaultConnector

All Implemented Interfaces:

Serializable, Cloneable, Connector

Direct Known Subclasses:

DirectConnector

public class DefaultConnector
extends Object
implements Connector

Purpose:Use this Connector to build a java.sql.Connection in the "standard" fashion, via the DriverManager.

Since:

TOPLink/Java 2.1

Author:

Big Country

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected String	databaseURL
protected String	driverClassName
protected String	driverURLHeader

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
Object	clone() INTERNAL: Clone the connector.
Connection	connect(Properties properties) INTERNAL: Connect with the specified properties and return the Connection.
String	getConnectionDetails() PUBLIC: Provide the details of my connection information.
String	getConnectionString() PUBLIC: Return the JDBC connection string.
String	getDatabaseURL() PUBLIC: The database URL is the JDBC URL for the database server.
String	getDriverClassName() PUBLIC: The driver class is the name of the Java class for the JDBC driver being used (e.g.
String	getDriverURLHeader() PUBLIC: The driver URL header is the string predetermined by the JDBC driver to be part of the URL connection string, (e.g.
protected void	initialize(String driverClassName, String driverURLHeader, String databaseURL) INTERNAL: Initialize the connector with the specified settings.
protected Class	loadDriver() INTERNAL: Ensure that the driver has been loaded and registered with the DriverManager.
void	setDatabaseURL(String databaseURL) PUBLIC: The database URL is the JDBC URL for the database server.
void	setDriverClassName(String driverClassName) PUBLIC: The driver class is the name of the Java class for the JDBC driver being used (e.g.
void	setDriverURLHeader(String driverURLHeader) PUBLIC: The driver URL header is the string predetermined by the JDBC driver to be part of the URL connection string, (e.g.
String	toString() PUBLIC: Print connection string.
void	toString(PrintWriter writer) INTERNAL: Print something useful on the log.

Methods inherited from class java.lang.Object

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

Field Detail

driverClassName

protected String driverClassName

driverURLHeader

protected String driverURLHeader

databaseURL

protected String databaseURL

Constructor Detail

DefaultConnector

public DefaultConnector()

PUBLIC: Construct a Connector with default settings (Sun JDBC-ODBC bridge). The database URL will still need to be set.

DefaultConnector

public DefaultConnector(String driverClassName,
                        String driverURLHeader,
                        String databaseURL)

PUBLIC: Construct a Connector with the specified settings.

Method Detail

clone

public Object clone()

INTERNAL: Clone the connector.

Specified by:

clone in interface Connector

Overrides:

clone in class Object

connect

public Connection connect(Properties properties)
                   throws DatabaseException

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

Specified by:

connect in interface Connector

Returns:

java.sql.Connection

Throws:

DatabaseException

getConnectionString

public String getConnectionString()

PUBLIC: Return the JDBC connection string. This is a combination of the driver-specific URL header and the database URL.

getConnectionDetails

public String getConnectionDetails()

PUBLIC: Provide the details of my connection information. This is primarily for JMX runtime services.

Specified by:

getConnectionDetails in interface Connector

Returns:

java.lang.String

getDatabaseURL

public String getDatabaseURL()

PUBLIC: The database URL is the JDBC URL for the database server. The driver header is not be included in this URL (e.g. "dbase files"; not "jdbc:odbc:dbase files").

getDriverClassName

public String getDriverClassName()

PUBLIC: The driver class is the name of the Java class for the JDBC driver being used (e.g. "sun.jdbc.odbc.JdbcOdbcDriver").

getDriverURLHeader

public String getDriverURLHeader()

PUBLIC: The driver URL header is the string predetermined by the JDBC driver to be part of the URL connection string, (e.g. "jdbc:odbc:"). This is required to connect to the database.

initialize

protected void initialize(String driverClassName,
                          String driverURLHeader,
                          String databaseURL)

INTERNAL: Initialize the connector with the specified settings.

loadDriver

protected Class loadDriver()
                    throws DatabaseException

INTERNAL: Ensure that the driver has been loaded and registered with the DriverManager. Just loading the class should cause the static initialization code to do the necessary registration. Return the loaded driver Class.

Throws:

DatabaseException

setDatabaseURL

public void setDatabaseURL(String databaseURL)

PUBLIC: The database URL is the JDBC URL for the database server. The driver header is not be included in this URL (e.g. "dbase files"; not "jdbc:odbc:dbase files").

setDriverClassName

public void setDriverClassName(String driverClassName)

PUBLIC: The driver class is the name of the Java class for the JDBC driver being used (e.g. "sun.jdbc.odbc.JdbcOdbcDriver").

setDriverURLHeader

public void setDriverURLHeader(String driverURLHeader)

PUBLIC: The driver URL header is the string predetermined by the JDBC driver to be part of the URL connection string, (e.g. "jdbc:odbc:"). This is required to connect to the database.

toString

public String toString()

PUBLIC: Print connection string.

Overrides:

toString in class Object

toString

public void toString(PrintWriter writer)

INTERNAL: Print something useful on the log.

Specified by:

toString in interface Connector