public interface AbandonedConnectionTimeoutCallbackThe callback interface for the abandoned connection timeout feature. This allows applications to provide customized handling for abandoned connections. Also see the related properties on
The callback object is optionally registered with each pooled connection or using any of its logical connection proxies, allowing applications to perform customized handling when this particular connection is deemed abandoned by the pool.
handleTimedOutConnection(...)method is invoked when a borrowed connection is deemed abandoned by the Universal Connection Pool. Applications can choose to completely override the pool's handling, invoke additional handling actions, or simply assume the pool's default handling. For example, JDBC applications can invoke
rollback()methods on the abandoned connection within this method.
It is an error to register more than one
AbandonedConnectionTimeoutCallbackon the same connection. Any such attempt will result in a
UniversalConnectionPoolExceptionat the pool layer, or an exception specific to the type of a Universal Connection Pool Adapter (for example, JDBC, JCA, and so forth) like
boolean handleTimedOutConnection()Sets whether or not the connection pool is responsible for handling abandoned connections. This method is called by the connection pool on the connection that is deemed abandoned to allow applications to customize abandoned connection handling.
The method implementation must return
trueif the application handles the
abandonedConnectionTimeoutin place of the pool, and must return
falseif the application wants the pool to take over the abandoned connection handling. In the former case, applications have the option of simply holding on to the borrowed connection or performing some actions and returning the abandoned connection to the pool. For the pool layer, this means calling
returnConnection(); while, for the pool adapter layer, this means calling
close()on the connection proxy.
- If the application's customized handling overrides the pool's actions, return
true; otherwise, return