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.
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.