org.jminor.dbms.derby

Class DerbyDatabase

java.lang.Object

org.jminor.common.db.AbstractDatabase

org.jminor.dbms.derby.DerbyDatabase

All Implemented Interfaces:

Database

public final class DerbyDatabase
extends AbstractDatabase

A Database implementation based on the Derby database.

Nested Class Summary

Nested classes/interfaces inherited from interface org.jminor.common.db.Database

Database.Statistics, Database.Type

Field Summary

Fields inherited from interface org.jminor.common.db.Database

DATABASE_EMBEDDED, DATABASE_EMBEDDED_IN_MEMORY, DATABASE_HOST, DATABASE_INIT_SCRIPT, DATABASE_PORT, DATABASE_SID, DATABASE_TYPE, DEFAULT_LOGIN_TIMEOUT, PASSWORD_PROPERTY, USER_PROPERTY

Constructor Summary

Constructors

Constructor and Description
DerbyDatabase() Instantiates a new DerbyDatabase.
DerbyDatabase(java.lang.String databaseName) Instantiates a new embedded DerbyDatabase.
DerbyDatabase(java.lang.String host, java.lang.Integer port, java.lang.String sid) Instantiates a new networked DerbyDatabase.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getAutoIncrementQuery(java.lang.String idSource) Returns a query string for retrieving the last automatically generated id from the given id source
java.lang.String	getURL(java.util.Properties connectionProperties)
boolean	isReferentialIntegrityException(java.sql.SQLException exception) This default implementation returns false
void	shutdownEmbedded(java.util.Properties connectionProperties) This should shutdown the database in case it is an embedded one and if that is applicable, such as for Derby.
boolean	supportsNowait() Returns true if the dbms supports the select for update NOWAIT option

Methods inherited from class org.jminor.common.db.AbstractDatabase

addConnectionProperties, createConnection, getAuthenticationInfo, getCheckConnectionQuery, getDriverClassName, getErrorMessage, getHost, getLoginTimeout, getPort, getSequenceQuery, getSid, getType, getUrlAppend, isAuthenticationException, isEmbedded, isUniqueConstraintException, setUrlAppend, supportsIsValid, supportsSelectForUpdate

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jminor.common.db.Database

getDatabaseType

Constructor Detail

DerbyDatabase

public DerbyDatabase()

Instantiates a new DerbyDatabase.

DerbyDatabase

public DerbyDatabase(java.lang.String databaseName)

Instantiates a new embedded DerbyDatabase.

Parameters:

databaseName - the path to the database files

DerbyDatabase

public DerbyDatabase(java.lang.String host,
                     java.lang.Integer port,
                     java.lang.String sid)

Instantiates a new networked DerbyDatabase.

Parameters:

host - the host name

port - the port number

sid - the service identifier

Method Detail

supportsNowait

public boolean supportsNowait()

Returns true if the dbms supports the select for update NOWAIT option

Specified by:

supportsNowait in interface Database

Overrides:

supportsNowait in class AbstractDatabase

Returns:

true if NOWAIT is supported for select for update

getAutoIncrementQuery

public java.lang.String getAutoIncrementQuery(java.lang.String idSource)

Returns a query string for retrieving the last automatically generated id from the given id source

Parameters:

idSource - the source for the id, for example a sequence name or in the case of Derby, the name of the table auto generating the value

Returns:

a query string for retrieving the last auto-increment value from idSource

getURL

public java.lang.String getURL(java.util.Properties connectionProperties)

Parameters:

connectionProperties - the connection properties, used primarily to provide embedded databases with user info for authentication purposes

Returns:

the database url of the active database, based on system properties

shutdownEmbedded

public void shutdownEmbedded(java.util.Properties connectionProperties)

This should shutdown the database in case it is an embedded one and if that is applicable, such as for Derby.

Specified by:

shutdownEmbedded in interface Database

Overrides:

shutdownEmbedded in class AbstractDatabase

Parameters:

connectionProperties - the connection properties

isReferentialIntegrityException

public boolean isReferentialIntegrityException(java.sql.SQLException exception)

Description copied from class: AbstractDatabase

This default implementation returns false

Specified by:

isReferentialIntegrityException in interface Database

Overrides:

isReferentialIntegrityException in class AbstractDatabase

Parameters:

exception - the exception

Returns:

true if this exception is a referential integrity error