Package SQLite

Class JDBCDriver

java.lang.Object

SQLite.JDBCDriver

All Implemented Interfaces:

Driver

public class JDBCDriver
extends Object
implements Driver

Field Summary

Fields

Modifier and Type	Field	Description
protected Connection	conn
static int	MAJORVERSION
static boolean	sharedCache
static String	vfs

Constructor Summary

Constructors

Constructor	Description
JDBCDriver()

Method Summary

Modifier and Type	Method	Description
boolean	acceptsURL(String url)	Returns whether the driver thinks that it can open a connection to the given URL.
Connection	connect(String url, Properties info)	Attempts to make a database connection to a data source specified by a supplied URL.
int	getMajorVersion()	Gets the driver's major version number.
int	getMinorVersion()	Gets the driver's minor version number.
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info)	Gets information about possible properties for this driver.
boolean	jdbcCompliant()	Reports whether this driver is a genuine JDBC CompliantTM driver.

Methods inherited from class java.lang.Object

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

Field Detail

MAJORVERSION

public static final int MAJORVERSION

See Also:

Constant Field Values

sharedCache

public static boolean sharedCache

vfs

public static String vfs

conn

protected Connection conn

Constructor Detail

JDBCDriver

public JDBCDriver()

Method Detail

acceptsURL

public boolean acceptsURL(String url)
                   throws SQLException

Description copied from interface: Driver

Returns whether the driver thinks that it can open a connection to the given URL.

Specified by:

acceptsURL in interface Driver

Parameters:

url - the URL to connect to.

Returns:

true if the driver thinks that is can open a connection to the supplied URL, false otherwise. Typically, the driver will respond true if it thinks that it can handle the subprotocol specified by the driver.

Throws:

SQLException - if a database error occurs.

connect

public Connection connect(String url,
                          Properties info)
                   throws SQLException

Description copied from interface: Driver

Attempts to make a database connection to a data source specified by a supplied URL.

Specified by:

connect in interface Driver

Parameters:

url - the URL to connect.

info - some properties that should be used in establishing the connection. The properties consist of name/value pairs of strings. Normally, a connection to a database requires at least two properties - for "user" and "password" in order to pass authentication to the database.

Returns:

the connection to the database.

Throws:

SQLException - if a database error occurs.

getMajorVersion

public int getMajorVersion()

Description copied from interface: Driver

Gets the driver's major version number.

Specified by:

getMajorVersion in interface Driver

Returns:

the major version number of the driver - typically starts at 1.

getMinorVersion

public int getMinorVersion()

Description copied from interface: Driver

Gets the driver's minor version number.

Specified by:

getMinorVersion in interface Driver

Returns:

the minor version number of the driver - typically starts at 0.

getPropertyInfo

public DriverPropertyInfo[] getPropertyInfo(String url,
                                            Properties info)
                                     throws SQLException

Description copied from interface: Driver

Gets information about possible properties for this driver.

This method is intended to provide a listing of possible properties that the client of the driver must supply in order to establish a connection to a database. Note that the returned array of properties may change depending on the supplied list of property values.

Specified by:

getPropertyInfo in interface Driver

Parameters:

url - the URL of the database. An application may call this method iteratively as the property list is built up - for example, when displaying a dialog to an end-user as part of the database login process.

info - a set of tag/value pairs giving data that a user may be prompted to provide in order to connect to the database.

Returns:

an array of DriverPropertyInfo records which provide details on which additional properties are required (in addition to those supplied in the info parameter) in order to connect to the database.

Throws:

SQLException - if a database error occurs.

jdbcCompliant

public boolean jdbcCompliant()

Description copied from interface: Driver

Reports whether this driver is a genuine JDBC CompliantTM driver. The driver may only return true if it passes all the JDBC compliance tests.

A driver may not be fully compliant if the underlying database has limited functionality.

Specified by:

jdbcCompliant in interface Driver

Returns:

true if the driver is fully JDBC compliant, false otherwise.