DatabaseEventListener

A class that implements this interface can get notified about exceptions and other events. A database event listener can be registered when connecting to a database. Example database URL: jdbc:h2:test;DATABASE_EVENT_LISTENER='com.acme.DbListener'

Methods
void closingDatabase()
This method is called before the database is closed normally.
void diskSpaceIsLow(long stillAvailable)
This method is called if the disk space is very low.
void exceptionThrown(SQLException e, String sql)
This method is called if an exception occurred during database recovery
void init(String url)
This method is called just after creating the object.
void opened()
This method is called after the database has been opened.
void setProgress(int state, String name, int x, int max)
This method is called for long running events, such as recovering, scanning a file or building an index.

void closingDatabase()

This method is called before the database is closed normally. It is save to connect to the database and execute statements at this point, however the connection must be closed before the method returns.

void diskSpaceIsLow(long stillAvailable) throws SQLException

This method is called if the disk space is very low. One strategy is to inform the user and wait for it to clean up disk space. Another strategy is to send an email to the administrator in this method and then throw a SQLException. The database should not be accessed from within this method (even to close it).

Parameters:
stillAvailable - the estimated space that is still available, in bytes
Throws:
SQLException - if the operation should be cancelled

void exceptionThrown(SQLException e, String sql)

This method is called if an exception occurred during database recovery

Parameters:
e - the exception
sql - the SQL statement

void init(String url)

This method is called just after creating the object. This is done when opening the database if the listener is specified in the database URL, but may be later if the listener is set at runtime with the SET SQL statement.

Parameters:
url - - the database URL

void opened()

This method is called after the database has been opened. It is save to connect to the database and execute statements at this point.

void setProgress(int state, String name, int x, int max)

This method is called for long running events, such as recovering, scanning a file or building an index.

Parameters:
state - the state
name - the object name
x - the current position
max - the highest value