Skip navigation links

oracle.ucp.jdbc
Interface ConnectionWithTimeToLiveTimeout

public interface ConnectionWithTimeToLiveTimeout

Interface supporting time-to-live connection timeout handling for JDBC java.sql.Connections. <p/> 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. <p/> The Universal Connection Pool supports the timeToLiveConnectionTimeout pool property and provides TimeToLiveConnectionTimeoutCallback to allow customized handling of TTL timed-out connections. <p/> Applications use this interface along with the timeToLiveConnectionTimeout properties for complete TTL-connection handlings.

See Also:

PoolDataSource, TimeToLiveConnectionTimeoutCallback

Method Summary

void	registerTimeToLiveConnectionTimeoutCallback(TimeToLiveConnectionTimeoutCallback cbk) Registers a time-to-live connection timeout callback with this connection.
void	removeTimeToLiveConnectionTimeoutCallback() Removes the TimeToLiveConnectionTimeoutCallback 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 - The TimeToLiveConnectionTimeoutCallback 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 the TimeToLiveConnectionTimeoutCallback object registered with this connection, if any.

Throws:

java.sql.SQLException - If callback removal fails.

Skip navigation links