org.vibur.dbcp.pool

Class DefaultHook.GetConnectionTiming

java.lang.Object

org.vibur.dbcp.pool.DefaultHook

org.vibur.dbcp.pool.DefaultHook.GetConnectionTiming

All Implemented Interfaces:

Hook, Hook.GetConnection

Enclosing class:

DefaultHook

public static final class DefaultHook.GetConnectionTiming
extends DefaultHook
implements Hook.GetConnection

Nested Class Summary

Nested classes/interfaces inherited from class org.vibur.dbcp.pool.DefaultHook

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

Nested classes/interfaces inherited from interface org.vibur.dbcp.pool.Hook

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

Constructor Summary

Constructors

Constructor and Description
GetConnectionTiming(ViburConfig config)

Method Summary

Modifier and Type	Method and Description
void	on(Connection rawConnection, long takenNanos) A programming hook that will be invoked on the raw JDBC Connection after it is taken from the pool as part of the DataSource.getConnection() flow.

Methods inherited from class java.lang.Object

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

Constructor Detail

GetConnectionTiming

public GetConnectionTiming(ViburConfig config)

Method Detail

on

public void on(Connection rawConnection,
               long takenNanos)

Description copied from interface: Hook.GetConnection

A programming hook that will be invoked on the raw JDBC Connection after it is taken from the pool as part of the DataSource.getConnection() flow. Its execution should take as short time as possible.

Worth noting that since version 19.0 the takenNanos parameter represents only the time waited for an object to become available in the pool, excluding any object creation time.

This hook complements the CloseConnection hook, which is invoked before the raw JDBC Connection is restored back to the pool.

Specified by:

on in interface Hook.GetConnection

Parameters:

rawConnection - the retrieved from the pool raw JDBC Connection; note that it can be null if we were unable to obtain a connection from the pool within the specified time limit, if the current thread was interrupted, or if we attempted to create a new connection in the pool and the attempt failed with an exception

takenNanos - the time taken to get this connection in nanoseconds