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