Java Doc for DriverPool.java in  » Report » iReport-2.0.5 » it » businesslogic » ireport » connection » Java Source Code / Java DocumentationJava Source Code and Java Documentation

This class was originally embedded into the DatabaseConnection object, it has been moved out for clarity. The main goal of this class is to provide a few of the same functions provided java.sql.DriverManager object but in a way that is better suited for the iSQL-Viewer program.

The main shortcoming of the java.sql.DriverManager is that the driver manager will not allow you to use a registered driver that was loaded with a different classloader than classloader from the calling class. Basically in short terms the default DriverManager really only seems to work when all the code and JDBC drivers are from the same classloader, which doesn't work with the iSQL-Viewer system since there are runtime and classloader for each ServiceDefinition object.
See Also:   java.sql.DriverManager
author:
   Markus A. Kobold <mkobold at sprintpcs dot com>

To overcome the security configuration of the java.sql.DriverManager object this method provides simple instantiation of the given driver by class name with a given ClassLoader.

This will search through all registered drivers and remove the driver if the object refrences are the same.
Parameters:
  jdbcDriver - Driver Object that needs to be deregistered.
See Also:   DriverPool.registerDriver(String,ClassLoader)

This will iterate through all registered drivers and if the value returned by the acceptsURL() of the driver is true then the driver is returned.

if all internally registered drivers fail against the URL then an attempt to fall back to the original DriverManager and attempt to retrieve a driver from there will be made.
Parameters:
  jdbcURL - URL of JDBC Connection Instance of the JDBC Driver that can accept the given URL
throws:
  SQLException - if the java.sql.DriverManager fallback fails.

To overcome the security configuration of the java.sql.DriverManager object this method provides simple instantiation of the given driver by class name with a given ClassLoader. The java.sql.DriverManager works really only if all classes are under the same ClassLoader, for most cases this is not allways an option.

If a Driver is all ready registered this method will actually do nothing.
Parameters:
  driverClass - the fully qaulified name of the Driver e.g.'org.my.sql.Driver'
Parameters:
  cl - ClassLoader to try and load the Driver with.
throws:
  ClassNotFoundException - if an Error Occurs with creating theDriver instance.
See Also:   DriverPool.deregisterDriver(Driver)
See Also:   DriverPool.getDriver(String)