de.aristaflow.adept2.base.dbaccess.drivermanager

Class DriverManager

java.lang.Object

de.aristaflow.adept2.base.dbaccess.drivermanager.DriverManager

public abstract class DriverManager
extends java.lang.Object

The java.sql.DriverManager uses a native method to retrieve the classloader from the calling class which keeps the calling class (including its classloader) from being garbage collected. Therefore all accesses to the driver manager have to be encapsulated by a shared class (this class). Additionally, all JDBC-drivers have to be provided to the system classloader (and not to the component classloaders).

Author:

Ulrich Kreher

See Also:

DriverManager

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DriverManager() package protected constructor -> we provide the only implementation

Method Summary

Modifier and Type	Method and Description
abstract java.sql.Connection	getConnection(java.lang.String url) Attempts to establish a connection to the given database URL.
abstract java.sql.Connection	getConnection(java.lang.String url, java.util.Properties info) Attempts to establish a connection to the given database URL.
abstract java.sql.Connection	getConnection(java.lang.String url, java.lang.String user, java.lang.String password) Attempts to establish a connection to the given database URL.
abstract java.sql.Driver	getDriver(java.lang.String url) Attempts to locate a driver that understands the given URL.
abstract java.util.Enumeration<java.sql.Driver>	getDrivers() Retrieves an Enumeration with all of the currently loaded JDBC drivers to which the current caller has access.
static DriverManager	getInstance(java.lang.String libDir) Returns the instance of the JDBC driver manager for the designated directory.
abstract int	getLoginTimeout() Gets the maximum time in seconds that a driver can wait when attempting to log in to a database.
abstract void	loadDriver(java.lang.String className) Gets the class with the designated name.

Methods inherited from class java.lang.Object

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

Constructor Detail

DriverManager

protected DriverManager()

package protected constructor -> we provide the only implementation

Method Detail

loadDriver

public abstract void loadDriver(java.lang.String className)
                         throws DriverNotFoundException

Gets the class with the designated name. This method has to be used instead of the usual Class.forName(className) to enforce the initialisation of the corresponding driver class.

Parameters:

className - The name of the class providing the JDBC-driver which should be registered.

Throws:

DriverNotFoundException - If the driver could not be loaded. Examine cause for more information.

getConnection

public abstract java.sql.Connection getConnection(java.lang.String url,
                                                  java.util.Properties info)
                                           throws java.sql.SQLException

Attempts to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC drivers.

Parameters:

url - a database url of the form jdbc:subprotocol:subname

info - a list of arbitrary string tag/value pairs as connection arguments; normally at least a "user" and "password" property should be included

Returns:

a Connection to the URL

Throws:

java.sql.SQLException - if a database access error occurs

getConnection

public abstract java.sql.Connection getConnection(java.lang.String url,
                                                  java.lang.String user,
                                                  java.lang.String password)
                                           throws java.sql.SQLException

Attempts to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC drivers.

Parameters:

url - a database url of the form jdbc:subprotocol:subname

user - the database user on whose behalf the connection is being made

password - the user's password

Returns:

a connection to the URL

Throws:

java.sql.SQLException - if a database access error occurs

getConnection

public abstract java.sql.Connection getConnection(java.lang.String url)
                                           throws java.sql.SQLException

Attempts to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC drivers.

Parameters:

url - a database url of the form jdbc:subprotocol:subname

Returns:

a connection to the URL

Throws:

java.sql.SQLException - if a database access error occurs

getDriver

public abstract java.sql.Driver getDriver(java.lang.String url)
                                   throws java.sql.SQLException

Attempts to locate a driver that understands the given URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC drivers.

Parameters:

url - a database URL of the form jdbc:subprotocol:subname

Returns:

a Driver object representing a driver that can connect to the given URL

Throws:

java.sql.SQLException - if a database access error occurs

getDrivers

public abstract java.util.Enumeration<java.sql.Driver> getDrivers()

Retrieves an Enumeration with all of the currently loaded JDBC drivers to which the current caller has access.

Note: The classname of a driver can be found using d.getClass().getName()

Returns:

the list of JDBC Drivers loaded by the caller's class loader

getLoginTimeout

public abstract int getLoginTimeout()

Gets the maximum time in seconds that a driver can wait when attempting to log in to a database.

Returns:

the driver login time limit in seconds

getInstance

public static DriverManager getInstance(java.lang.String libDir)

Returns the instance of the JDBC driver manager for the designated directory.

Parameters:

libDir - The library directory containing the JDBC drivers (actually the directory above a directory 'jdbc4' containing the JDBC drivers).

Returns:

The singleton instance of the JDBC driver manager