org.vibur.dbcp.pool

Interface Hook

All Known Subinterfaces:

Hook.CloseConnection, Hook.DestroyConnection, Hook.GetConnection, Hook.GetConnectionTimeout, Hook.InitConnection, Hook.MethodInvocation, Hook.ResultSetRetrieval, Hook.StatementExecution, Hook.StatementProceedingPoint

All Known Implementing Classes:

DefaultHook.CloseConnection, DefaultHook.GetConnectionTimeout, DefaultHook.GetConnectionTiming, DefaultHook.InitConnection, DefaultHook.QueryTiming, DefaultHook.ResultSetSize

public interface Hook

An interface that holds all application programming hook interfaces for JDBC Connection tune-up, method invocation interception, and more.

These application hooks are invoked when particular JDBC events occur and serve as extension points of the inner workings of the connection pool. Some of them have access to the raw (original) JDBC Connection object, not the proxied such. In order to avoid interference with the way the connection pool manages its underlying connections, the application must not keep or store in one or another form a reference to the rawConnection object.

Multiple hooks of one and the same type can be registered and they will be executed in the order in which they were registered; i.e., if there are N registered hooks from a particular type, the first registered hook will be executed first, then the second, the third, and so on.

If a hook throws an SQLException it will affect the current JDBC flow and will be rethrown as part of it. Such exception will also prevent the execution of any subsequent hooks of the same type.

Author:

Simeon Malchev

See Also:

DefaultHook, ConnectionFactory

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Hook.CloseConnection
static interface	Hook.DestroyConnection
static interface	Hook.GetConnection
static interface	Hook.GetConnectionTimeout
static interface	Hook.InitConnection
static interface	Hook.MethodInvocation
static interface	Hook.ResultSetRetrieval
static interface	Hook.StatementExecution
static interface	Hook.StatementProceedingPoint