Package oracle.ucp.jdbc

Interface HarvestableConnection

  • public interface HarvestableConnection
    Interface supporting Connection Harvesting for JDBC java.sql.Connections.

    Connection Harvesting allows the Universal Connection Pool to actively return borrowed connections to the pool when a user-specified threshold for harvesting is met or when the pool has reached its max capacity yet all connections in the pool are borrowed.

    Users have the option for specifying whether a borrowed connection is harvestable, as well as providing customized cleanup actions on harvestable connections.

    Applications use this interface along with the harvesting properties and callbacks for complete connection harvesting functions.

    See Also:
    PoolDataSource, ConnectionHarvestingCallback

    • Method Detail

      • setConnectionHarvestable

        void setConnectionHarvestable​(boolean isConnectionHarvestable)
                       throws java.sql.SQLException
        Specifies whether this connection is harvestable.
        Parameters:
        isConnectionHarvestable - Whether this connection is harvestable.
        Throws:
        java.sql.SQLException - If this connection was closed.

      • isConnectionHarvestable

        boolean isConnectionHarvestable()
                         throws java.sql.SQLException
        Specifies whether this connection is harvestable.
        Returns:
        A boolean indicating whether this connection is harvestable. True if so and false otherwise.
        Throws:
        java.sql.SQLException - If an error occurs.

      • registerConnectionHarvestingCallback

        void registerConnectionHarvestingCallback​(ConnectionHarvestingCallback cbk)
                                   throws java.sql.SQLException
        Registers a ConnectionHarvestingCallback with the this connection.
        Parameters:
        cbk - The ConnectionHarvestingCallback object to be registered.
        Throws:
        java.sql.SQLException - If there is a callback already registered with the connection.

      • removeConnectionHarvestingCallback

        void removeConnectionHarvestingCallback()
                                 throws java.sql.SQLException
        Removes the ConnectionHarvestingCallback object registered with this connection, if any.
        Throws:
        java.sql.SQLException - If callback removal fails.