com.mimer.jdbc
Class Driver

java.lang.Object
  |
  +--com.mimer.jdbc.Driver

All Implemented Interfaces:

Driver

public final class Driver

extends Object

implements Driver

Method Summary

boolean	acceptsURL(String url) Returns true if the supplied url specifies the mimer subprotocol.
Connection	connect(String url, Properties info) Attempts to make a database connection to the given URL.
int	getMajorVersion() The JDBC major version of the driver.
int	getMinorVersion() The JDBC minor version of the driver.
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info) Parses an url and creates a property list.
boolean	jdbcCompliant() Mimer is JDBC compliant and will always return true.
static void	main(String[] arg) The main routine helps the customer with finding out things about our JDBC driver.

Methods inherited from class java.lang.Object

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

Method Detail

acceptsURL

public boolean acceptsURL(String url)
                   throws SQLException

Returns true if the supplied url specifies the mimer subprotocol.

Specified by:

acceptsURL in interface Driver

Parameters:

url - the URL of the database

Returns:

true if this driver can connect to the given URL

Throws:

SQLException - if a database access error occurs

connect

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

Attempts to make a database connection to the given URL. The driver ignores the request if it does not specify the mimer subprotocol.

The driver raises an SQLException if it is the right driver to connect to the given URL, but has trouble connecting to the database.

The java.util.Properties argument can be used to passed arbitrary string tag/value pairs as connection arguments. The following properties may be used. Contents of the url override any specified properties.

Property	Description
serverName	The name of the host where the Mimer server resides. Default is localhost.
portNumber	The IP port number of the server on the host. Default is 1360.
databaseName	The Mimer database name.
user	The user name.
password	The password.

The syntax of an URL is:

jdbc:mimer:[//net_loc][/database][?proplist]
net_loc = [user[:password]@]host[:port]
proplist = property=value[&proplist]

see RFC 1738

Specified by:

connect in interface Driver

Parameters:

url - the URL of the database to which to connect

info - a list of arbitrary string tag/value pairs as connection arguments. Normally at least a "user" and "password" property should be included.

Returns:

a Connection object that represents a connection to the URL

Throws:

SQLException - if a database access error occurs

getMajorVersion

public int getMajorVersion()

The JDBC major version of the driver. The Mimer system is is to have this number identical to the JDBC level supported. A major version of 3 indicates that the driver implements the JDBC 3 specification.

Specified by:

getMajorVersion in interface Driver

Returns:

JDBC driver major version

getMinorVersion

public int getMinorVersion()

The JDBC minor version of the driver. The Mimer system is to use this number as a version number across major versions. Unlike the major version number, which indicates which JDBC spec is implemented, the minor version indicates which features are are supported.

Mimer JDBC versions 1.12, 2.12 and 3.12 will implement the same database features within the scope of their respective JDBC specifications.

Specified by:

getMinorVersion in interface Driver

Returns:

JDBC driver major version

getPropertyInfo

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

Parses an url and creates a property list.

Specified by:

getPropertyInfo in interface Driver

Parameters:

url - the URL of the database

info - Starting property list.

Returns:

Property information after the contents of the url has been parsed and applied to the property list supplied in the 2nd argument.

Throws:

SQLException - if a database access error occurs

jdbcCompliant

public boolean jdbcCompliant()

Mimer is JDBC compliant and will always return true.

Specified by:

jdbcCompliant in interface Driver

main

public static void main(String[] arg)

The main routine helps the customer with finding out things about our JDBC driver. Usage: java com.mimer.jdbc.Driver options where options include: -version Display driver version -sysprop Display all system properties -errors List all JDBC error codes -ping url Test the database at the specified url