java.sql
Interface Driver
java.lang.Object
|
+--java.sql.Driver
public interface Driver
This interface specifies a mechanism for accessing a JDBC database
driver. When the class implementing this method is loaded, it should
register an instance of itself with the
DriverManager in
a static initializer.
Because the DriverManager might attempt to use several
drivers to find one that can connect to the requested database,
this driver should not cause large numbers of classes and code to
be loaded. If another driver is the one that ends up performing the
request, any loading done by this driver would be wasted.
Author:- Aaron M. Renn (arenn@urbanophile.com)
acceptsURL
public boolean acceptsURL(java.lang.String url) This method tests whether or not the driver believes it can connect to
the specified database. The driver should only test whether it
understands and accepts the URL. It should not necessarily attempt to
probe the database for a connection.
Parameters:
Returns:
true if the drivers can connect to the database,
false otherwise.
Throws:
connect
public Connection connect(java.lang.String url, java.util.Properties info) This method connects to the specified database using the connection
properties supplied. If the driver does not understand the database
URL, it should return null instead of throwing an
exception since the DriverManager will probe a driver
in this manner.
Parameters:
Returns:
- A
Connection object for the newly established
connection, or null if the URL is not understood.
Throws:
getMajorVersion
public int getMajorVersion() This method returns the major version number of the driver.
Returns:
- The major version number of the driver.
getMinorVersion
public int getMinorVersion() This method returns the minor version number of the driver.
Returns:
- The minor version number of the driver.
getPropertyInfo
public DriverPropertyInfo[] getPropertyInfo(java.lang.String url, java.util.Properties properties) This method returns an array of possible properties that could be
used to connect to the specified database.
Parameters:
Returns:
- A list of possible additional properties for a connection to this
database. This list may be empty.
Throws:
jdbcCompliant
public boolean jdbcCompliant() This method tests whether or not the driver is JDBC compliant. This
method should only return true if the driver has been
certified as JDBC compliant.
Returns:
true if the driver has been certified JDBC compliant,
false otherwise.
DriverManagerin a static initializer.Because the
DriverManagermight attempt to use several drivers to find one that can connect to the requested database, this driver should not cause large numbers of classes and code to be loaded. If another driver is the one that ends up performing the request, any loading done by this driver would be wasted.