Skip navigation links

Oracle® Universal Connection Pool for JDBC Java API Reference
12c Release 1 (12.1)

E17662-07


oracle.ucp.jdbc
Interface ConnectionWithTimeToLiveTimeout


public interface ConnectionWithTimeToLiveTimeout

Interface supporting time-to-live connection timeout handling for JDBC java.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 provides TimeToLiveConnectionTimeoutCallback to allow customized handling of TTL timed-out connections.

Applications use this interface along with the timeToLiveConnectionTimeout properties for complete TTL-connection handling.

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

Oracle® Universal Connection Pool for JDBC Java API Reference
12c Release 1 (12.1)

E17662-07


Copyright © 2007, 2013, Oracle and/or its affiliates. All rights reserved.