xdev.db

Class AbstractDBConnection<DS extends DBDataSource<DS>>

java.lang.Object

xdev.db.AbstractDBConnection<DS>

Type Parameters:

DS - the generic type

All Implemented Interfaces:

AutoCloseable, DBConnection<DS>

Direct Known Subclasses:

JDBCConnection, ServletDBConnection

public abstract class AbstractDBConnection<DS extends DBDataSource<DS>>
extends Object
implements DBConnection<DS>

A abstract class from the DBConnection. A connection (session) with a specific database. SQL statements are executed and results are returned within the context of a connection.

Author:

XDEV Software

See Also:

DBDataSource, DBConnection

Nested Class Summary

Nested classes/interfaces inherited from interface xdev.db.DBConnection

DBConnection.Query

Field Summary

Fields

Modifier and Type	Field and Description
protected DS	dataSource
protected List<DBConnectionListener>	listeners

Constructor Summary

Constructors

Constructor and Description
AbstractDBConnection(DS dataSource) Constructs a AbstractDBConnection that is initialized with the originating data source.

Method Summary

Modifier and Type	Method and Description
void	addDBConnectionListener(DBConnectionListener l) Registers a DBConnectionListener at this connection.
protected void	decorateDelegate(Object query, DatabaseGateway gateway) Quick and dirty way to inject the gateway into a xdev.db.sql object
DS	getDataSource() Returns the data source of this AbstractDBConnection.
DBConnectionListener[]	getDBConnectionListeners() Retrieves all registered DBConnectionListeners.
DBConnection.Query[]	getStoredQueries() Returns all stored queries since the setStoreQueries(true) was called.
protected void	queryPerformed(String statement, Object[] params, DBException exception)
void	removeDBConnectionListener(DBConnectionListener l) Unregisters a DBConnectionListener.
void	setStoreQueries(boolean store) Stores all queries which are executed from now on if store is true, otherwise all stored queries will be deleted.
protected void	writePerformed(String statement, Object[] params, DBException exception)

Methods inherited from class java.lang.Object

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

Methods inherited from interface xdev.db.DBConnection

beginTransaction, call, close, commit, createTable, getPager, getQueryRowCount, getServerTime, isInTransaction, query, query, releaseSavepoint, rollback, rollback, setSavepoint, setSavepoint, testConnection, write, write, write, write, write

Field Detail

dataSource

protected final DS extends DBDataSource<DS> dataSource

listeners

protected List<DBConnectionListener> listeners

Constructor Detail

AbstractDBConnection

public AbstractDBConnection(DS dataSource)

Constructs a AbstractDBConnection that is initialized with the originating data source.

Parameters:

dataSource - The originating data source

Method Detail

getDataSource

public DS getDataSource()

Returns the data source of this AbstractDBConnection.

Returns:

this connection's originating data source

addDBConnectionListener

public void addDBConnectionListener(DBConnectionListener l)

Registers a DBConnectionListener at this connection.

Specified by:

addDBConnectionListener in interface DBConnection<DS extends DBDataSource<DS>>

Parameters:

l - the listener to register

removeDBConnectionListener

public void removeDBConnectionListener(DBConnectionListener l)

Unregisters a DBConnectionListener.

Specified by:

removeDBConnectionListener in interface DBConnection<DS extends DBDataSource<DS>>

Parameters:

l - the listener to unregister

getDBConnectionListeners

public DBConnectionListener[] getDBConnectionListeners()

Retrieves all registered DBConnectionListeners.

Specified by:

getDBConnectionListeners in interface DBConnection<DS extends DBDataSource<DS>>

Returns:

a array of DBConnectionListeners, or a null-length array if no listener is registered

setStoreQueries

public void setStoreQueries(boolean store)

Stores all queries which are executed from now on if store is true, otherwise all stored queries will be deleted.

Specified by:

setStoreQueries in interface DBConnection<DS extends DBDataSource<DS>>

Parameters:

store - if true all queries which are executed from now are stored, otherwise all stored queries will be deleted

See Also:

DBConnection.getStoredQueries()

getStoredQueries

public DBConnection.Query[] getStoredQueries()

Returns all stored queries since the setStoreQueries(true) was called. If the flag is false a empty array is returned.

Specified by:

getStoredQueries in interface DBConnection<DS extends DBDataSource<DS>>

Returns:

all stored queries since setStoreQueries(true) was called.

See Also:

DBConnection.setStoreQueries(boolean)

queryPerformed

protected void queryPerformed(String statement,
                              Object[] params,
                              DBException exception)

writePerformed

protected void writePerformed(String statement,
                              Object[] params,
                              DBException exception)

decorateDelegate

protected void decorateDelegate(Object query,
                                DatabaseGateway gateway)

Quick and dirty way to inject the gateway into a xdev.db.sql object