org.apache.derby.jdbc

Class AutoloadedDriver

java.lang.Object

org.apache.derby.jdbc.AutoloadedDriver

All Implemented Interfaces:

java.sql.Driver

Direct Known Subclasses:

AutoloadedDriver40

public class AutoloadedDriver
extends java.lang.Object
implements java.sql.Driver

This is the dummy driver which is registered with the DriverManager and which is autoloaded by JDBC4. Loading this class will NOT automatically boot the Derby engine, but it will register this class as a valid Driver with the DriverManager. Instead, the engine boots lazily when you ask for a Connection. Alternatively, you can force the engine to boot as follows:

         Class.forName("org.apache.derby.jdbc.EmbeddedDriver").newInstance();

         // or

     new org.apache.derby.jdbc.EmbeddedDriver();

    
        

Field Summary

Fields

Modifier and Type	Field and Description
private static AutoloadedDriver	_autoloadedDriver
private static java.sql.Driver	_driverModule
private static boolean	_engineForcedDown

Constructor Summary

Constructors

Constructor and Description
AutoloadedDriver()

Method Summary

Modifier and Type	Method and Description
boolean	acceptsURL(java.lang.String url) Accept anything that starts with jdbc:derby:.
java.sql.Connection	connect(java.lang.String url, java.util.Properties info) Connect to the URL if possible
private static void	deregisterDriver(AutoloadedDriver driver)
(package private) static java.sql.Driver	getDriverModule()
int	getMajorVersion() Returns the driver's major version number.
int	getMinorVersion() Returns the driver's minor version number.
java.sql.DriverPropertyInfo[]	getPropertyInfo(java.lang.String url, java.util.Properties info) Returns an array of DriverPropertyInfo objects describing possible properties.
private static boolean	isBooted()
boolean	jdbcCompliant() Report whether the Driver is a genuine JDBC COMPLIANT (tm) driver.
private static AutoloadedDriver	makeAutoloadedDriver() load slightly more capable driver if possible.
(package private) static void	registerDriverModule(java.sql.Driver driver) Record which driver module actually booted.
protected static void	registerMe(AutoloadedDriver me)
(package private) static void	unregisterDriverModule() Unregister the driver and the AutoloadedDriver if exists.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.sql.Driver

getParentLogger

Field Detail

_engineForcedDown

private static boolean _engineForcedDown

_autoloadedDriver

private static AutoloadedDriver _autoloadedDriver

_driverModule

private static java.sql.Driver _driverModule

Constructor Detail

AutoloadedDriver

public AutoloadedDriver()

Method Detail

registerMe

protected static void registerMe(AutoloadedDriver me)

acceptsURL

public boolean acceptsURL(java.lang.String url)
                   throws java.sql.SQLException

Accept anything that starts with jdbc:derby:.

Specified by:

acceptsURL in interface java.sql.Driver

Throws:

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

See Also:

Driver

connect

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

Connect to the URL if possible

Specified by:

connect in interface java.sql.Driver

Throws:

java.sql.SQLException - illegal url or problem with connectiong

See Also:

Driver

getPropertyInfo

public java.sql.DriverPropertyInfo[] getPropertyInfo(java.lang.String url,
                                                     java.util.Properties info)
                                              throws java.sql.SQLException

Returns an array of DriverPropertyInfo objects describing possible properties.

Specified by:

getPropertyInfo in interface java.sql.Driver

Throws:

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

See Also:

Driver

getMajorVersion

public int getMajorVersion()

Returns the driver's major version number.

Specified by:

getMajorVersion in interface java.sql.Driver

See Also:

Driver

getMinorVersion

public int getMinorVersion()

Returns the driver's minor version number.

Specified by:

getMinorVersion in interface java.sql.Driver

See Also:

Driver

jdbcCompliant

public boolean jdbcCompliant()

Report whether the Driver is a genuine JDBC COMPLIANT (tm) driver.

Specified by:

jdbcCompliant in interface java.sql.Driver

See Also:

Driver

getDriverModule

static java.sql.Driver getDriverModule()
                                throws java.sql.SQLException

Throws:

java.sql.SQLException

registerDriverModule

static void registerDriverModule(java.sql.Driver driver)

Record which driver module actually booted.

Parameters:

driver - the driver register to DriverManager is not AutoloadedDriver

unregisterDriverModule

static void unregisterDriverModule()

Unregister the driver and the AutoloadedDriver if exists. This happens when the engine is forcibly shut down.

deregisterDriver

private static void deregisterDriver(AutoloadedDriver driver)
                              throws java.sql.SQLException

Throws:

java.sql.SQLException

isBooted

private static boolean isBooted()

makeAutoloadedDriver

private static AutoloadedDriver makeAutoloadedDriver()

load slightly more capable driver if possible. But if the vm level doesn't support it, then we fall back on the JDBC3 level driver.

Returns:

AutoloadedDriver