com.mckoi.database.jdbc

Class MDriver

java.lang.Object

com.mckoi.database.jdbc.MDriver

All Implemented Interfaces:

Driver

Direct Known Subclasses:

JDBCDriver

public class MDriver
extends Object
implements Driver

JDBC implementation of the driver for the Mckoi database.

The url protocol is as follows:

  For connecting to a remote database server:
    jdbc:mckoi:[//hostname[:portnum]/][schema_name/]

  eg.  jdbc:mckoi://db.mckoi.com:7009/

  If hostname is not provided then it defaults to localhost.
  If portnum is not provided it defaults to 9157.
  If schema_name is not provided it defaults to APP.

  To start up a database in the local file system the protocol is:
    jdbc:mckoi:local://databaseconfiguration/[schema_name/]

  eg.  jdbc:mckoi:local://D:/dbdata/db.conf

  If schema_name is not provided it defaults to APP.

  To create a database in the local file system then you need to supply a
  'create=true' assignment in the URL encoding.

  eg.  jdbc:mckoi:local://D:/dbdata/db.conf?create=true
 

A local database runs within the JVM of this JDBC driver. To boot a local database, you must include the full database .jar release with your application distribution.

For connecting to a remote database using the remote URL string, only the JDBC driver need be included in the classpath.

NOTE: This needs to be a light-weight object, because a developer could generate multiple instances of this class. Making an instance of 'com.mckoi.JDBCDriver' will create at least two instances of this object.

Author:

Tobias Downer

Constructor Summary

Constructors

Constructor and Description
MDriver() Constructor is public so that instances of the JDBC driver can be created by developers.

Method Summary

Modifier and Type	Method and Description
boolean	acceptsURL(String url)
Connection	connect(String url, Properties info)
int	getMajorVersion()
int	getMinorVersion()
Logger	getParentLogger()
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info)
boolean	jdbcCompliant()
static void	register() Static method that registers this driver with the JDBC driver manager.

Methods inherited from class java.lang.Object

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

Constructor Detail

MDriver

public MDriver()

Constructor is public so that instances of the JDBC driver can be created by developers.

Method Detail

register

public static void register()

Static method that registers this driver with the JDBC driver manager.

connect

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

Specified by:

connect in interface Driver

Throws:

SQLException

acceptsURL

public boolean acceptsURL(String url)
                   throws SQLException

Specified by:

acceptsURL in interface Driver

Throws:

SQLException

getPropertyInfo

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

Specified by:

getPropertyInfo in interface Driver

Throws:

SQLException

getMajorVersion

public int getMajorVersion()

Specified by:

getMajorVersion in interface Driver

getMinorVersion

public int getMinorVersion()

Specified by:

getMinorVersion in interface Driver

jdbcCompliant

public boolean jdbcCompliant()

Specified by:

jdbcCompliant in interface Driver

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface Driver

Throws:

SQLFeatureNotSupportedException