Driver

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> java >> [ sql overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

java.sql
Interface 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.

Method Summary

boolean acceptsURL(java.lang.String url)
          This method tests whether or not the driver believes it can connect to the specified database.

Connection connect(java.lang.String url, java.util.Properties properties)
          This method connects to the specified database using the connection properties supplied.

int getMajorVersion()
          This method returns the major version number of the driver.

int getMinorVersion()
          This method returns the minor version number of the driver.

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.

boolean jdbcCompliant()
          This method tests whether or not the driver is JDBC compliant.

Method Detail

connect

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

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.

acceptsURL

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

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.

getPropertyInfo

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

This method returns an array of possible properties that could be used to connect to the specified database.

getMajorVersion

public int getMajorVersion()

This method returns the major version number of the driver.

getMinorVersion

public int getMinorVersion()

This method returns the minor version number of the driver.

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.