Package oracle.ucp.jdbc
Interface ConnectionWithTimeToLiveTimeout
-
public interface ConnectionWithTimeToLiveTimeout
Interface supporting time-to-live connection timeout handling for JDBCjava.sql.Connections
.A time-to-live connection allows a borrowed connection to remain borrowed only for a pre-determined period of time. When this period passes, this connection is reclaimed and put back into the connection pool.
The Universal Connection Pool supports the
timeToLiveConnectionTimeout
pool property and providesTimeToLiveConnectionTimeoutCallback
to allow customized handling of TTL timed-out connections.Applications use this interface along with the
timeToLiveConnectionTimeout
properties for complete TTL-connection handling.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
registerTimeToLiveConnectionTimeoutCallback(TimeToLiveConnectionTimeoutCallback cbk)
Registers a time-to-live connection timeout callback with this connection.void
removeTimeToLiveConnectionTimeoutCallback()
Removes theTimeToLiveConnectionTimeoutCallback
object registered with this connection, if any.
-
-
-
Method Detail
-
registerTimeToLiveConnectionTimeoutCallback
void registerTimeToLiveConnectionTimeoutCallback(TimeToLiveConnectionTimeoutCallback cbk) throws java.sql.SQLException
Registers a time-to-live connection timeout callback with this connection.- Parameters:
cbk
- TheTimeToLiveConnectionTimeoutCallback
object to be registered.- Throws:
java.sql.SQLException
- If there is a callback already registered with the connection.
-
removeTimeToLiveConnectionTimeoutCallback
void removeTimeToLiveConnectionTimeoutCallback() throws java.sql.SQLException
Removes theTimeToLiveConnectionTimeoutCallback
object registered with this connection, if any.- Throws:
java.sql.SQLException
- If callback removal fails.
-
-