xdev.db

Interface DBDataSource<T extends DBDataSource>

All Superinterfaces:

DataSource<T>

All Known Implementing Classes:

AbstractDBDataSource, JDBCDataSource, NullDBDataSource, ServletDBDataSource

public interface DBDataSource<T extends DBDataSource>
extends DataSource<T>

Base type for all database drivers.

Author:

XDEV Software Corp.

Nested Class Summary

Nested classes/interfaces inherited from interface xdev.util.DataSource

DataSource.Parameter<T>

Method Summary

Modifier and Type	Method and Description
void	addDBDataSourceListener(DBDataSourceListener l) Registers a DBDataSourceListener at this data source.
boolean	canExport() Determines if this data source is able to create or alter tables in the database.
void	closeAllOpenConnections() Close all open connections.
DBDataSourceListener[]	getDBDataSourceListeners() Retrieves all registered DBDataSourceListeners.
DBMetaData	getMetaData()
DBConnection	openConnection() Open the connection for this DBDataSource.
void	removeDBDataSourceListener(DBDataSourceListener l) Unregisters a DBDataSourceListener.

Methods inherited from interface xdev.util.DataSource

clearCaches, getDefaultParameter, getDefaultParameters, getName, getParameter, getParameters, getParameterValue, getParameterValue, isParameterRequired, putParameter

Method Detail

addDBDataSourceListener

void addDBDataSourceListener(DBDataSourceListener l)

Registers a DBDataSourceListener at this data source.

Parameters:

l - the listener to register

removeDBDataSourceListener

void removeDBDataSourceListener(DBDataSourceListener l)

Unregisters a DBDataSourceListener.

Parameters:

l - the listener to unregister

getDBDataSourceListeners

DBDataSourceListener[] getDBDataSourceListeners()

Retrieves all registered DBDataSourceListeners.

Returns:

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

getMetaData

DBMetaData getMetaData()
                throws DBException

Specified by:

getMetaData in interface DataSource<T extends DBDataSource>

Throws:

DBException

openConnection

DBConnection openConnection()
                     throws DBException

Open the connection for this DBDataSource.

Returns:

the open DBConnection

Throws:

DBException - if a database access error occurs

closeAllOpenConnections

void closeAllOpenConnections()
                      throws DBException

Close all open connections.

Throws:

DBException - if a database access error occurs

canExport

boolean canExport()

Determines if this data source is able to create or alter tables in the database.