Package de.aristaflow.adept2.base.dbaccess.drivermanager

Class DriverManager

java.lang.Object
de.aristaflow.adept2.base.dbaccess.drivermanager.DriverManager
public abstract class DriverManager extends 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:

  • Constructor Details

    • DriverManager

      protected DriverManager()
      package protected constructor -> we provide the only implementation

  • Method Details

    • loadDriver

      public abstract void loadDriver(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 Connection getConnection(String url, Properties info) throws 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:
      SQLException - if a database access error occurs

    • getConnection

      public abstract Connection getConnection(String url, String user, String password) throws 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:
      SQLException - if a database access error occurs

    • getConnection

      public abstract Connection getConnection(String url) throws 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:
      SQLException - if a database access error occurs

    • getDriver

      public abstract Driver getDriver(String url) throws 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:
      SQLException - if a database access error occurs

    • getDrivers

      public abstract Enumeration<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(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