com.mckoi.database.jdbc
Class MDriver

java.lang.Object
  extended by com.mckoi.database.jdbc.MDriver
All Implemented Interfaces:
java.sql.Driver
Direct Known Subclasses:
JDBCDriver

public class MDriver
extends java.lang.Object
implements java.sql.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
MDriver()
          Constructor is public so that instances of the JDBC driver can be created by developers.
 
Method Summary
 boolean acceptsURL(java.lang.String url)
           
 java.sql.Connection connect(java.lang.String url, java.util.Properties info)
           
 int getMajorVersion()
           
 int getMinorVersion()
           
 java.sql.DriverPropertyInfo[] getPropertyInfo(java.lang.String url, java.util.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 java.sql.Connection connect(java.lang.String url,
                                   java.util.Properties info)
                            throws java.sql.SQLException
Specified by:
connect in interface java.sql.Driver
Throws:
java.sql.SQLException

acceptsURL

public boolean acceptsURL(java.lang.String url)
                   throws java.sql.SQLException
Specified by:
acceptsURL in interface java.sql.Driver
Throws:
java.sql.SQLException

getPropertyInfo

public java.sql.DriverPropertyInfo[] getPropertyInfo(java.lang.String url,
                                                     java.util.Properties info)
                                              throws java.sql.SQLException
Specified by:
getPropertyInfo in interface java.sql.Driver
Throws:
java.sql.SQLException

getMajorVersion

public int getMajorVersion()
Specified by:
getMajorVersion in interface java.sql.Driver

getMinorVersion

public int getMinorVersion()
Specified by:
getMinorVersion in interface java.sql.Driver

jdbcCompliant

public boolean jdbcCompliant()
Specified by:
jdbcCompliant in interface java.sql.Driver