Package oracle.ucp

Interface ConnectionRetrievalInfo

  • All Superinterfaces:
    oracle.ucp.RACConnectionRetrievalInfo
    public interface ConnectionRetrievalInfo
extends oracle.ucp.RACConnectionRetrievalInfo
    The connection retrieval info is used for borrowing existing connections and for creating new ones. It contains resource-specific information that the connection factory adapter uses to create connections. For example, the JDBC connection retrieval info object maintains the user and password that are used to create a connection from a JDBC resource.

    The connection retrieval info object also provides methods for equality and hash so that like-connections can be pooled efficiently.

    The connection retrieval object supports Connection Labeling, a common mechanism for all types of connections. Represented as key/value pairs, connection labels are used for application-driven connection matching purposes.

    See Also:
    ConnectionFactoryAdapter

    • Method Summary

      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and Type Method Description
      void addLabel​(java.lang.String key, java.lang.String value)
      Adds a connection label to this connection retrieval info object.
      default java.util.function.Predicate<oracle.ucp.common.CoreConnection> criMatchSelector()
      Default predicate for CRI matching.
      boolean equalsIncludingPassword​(ConnectionRetrievalInfo cri)
      Checks whether this instance is equal to another.
      default boolean equalsNotIncludingPassword​(ConnectionRetrievalInfo cri)
      Checks whether this instance is equal to another.
      ConnectionRetrievalInfo getCopyWithNoLabels()
      Clones this connection retrieval object but removes all the connection labels associated.
      default oracle.ucp.jdbc.JDBCConnectionRetrievalInfo getCopyWithUpdatedPassword()
      Default db account's password can be changed, but CRI as a connection attribute still holds an old password.
      default oracle.ucp.common.CriStats getCriMetadata()
      get borrow conext metadata (counters, appropriate semaphores and queues).
      java.util.Properties getLabels()
      Retrieves all the connection labels stored on this connection retrieval info object.
      void removeLabel​(java.lang.String key)
      Removes the connection label with the given key from this connection retrieval info object.

      • Methods inherited from interface oracle.ucp.RACConnectionRetrievalInfo

        getConnectionAffinityCallback

    • Method Detail

      • addLabel

        void addLabel​(java.lang.String key,
              java.lang.String value)
       throws UniversalConnectionPoolException
        Adds a connection label to this connection retrieval info object. This can be used for both requested labels during a connection borrowing request or actual labels applied on a borrowed connection. The addition of connection labels is cumulative; the supplied key/value pair is added to those connection labels already on this object each time this method is called. However, for each particular label key, only the last applied value is retained.
        Parameters:
        key - The key of the connection label to be added. Cannot be null or an empty string.
        value - The value of the connection label to be added. Can be null or an empty string.
        Throws:
        UniversalConnectionPoolException - If the key is null or an empty string.

      • removeLabel

        void removeLabel​(java.lang.String key)
          throws UniversalConnectionPoolException
        Removes the connection label with the given key from this connection retrieval info object. This method does nothing if there is no label stored on this object with the specified key.
        Parameters:
        key - The key of the connection label to be removed. Cannot be null or an empty string.
        Throws:
        UniversalConnectionPoolException - If the key is null or an empty string.

      • getCopyWithNoLabels

        ConnectionRetrievalInfo getCopyWithNoLabels()
        Clones this connection retrieval object but removes all the connection labels associated.
        Returns:
        A clone ConnectionRetrievalInfo object with all connection labels removed.

      • getLabels

        java.util.Properties getLabels()
        Retrieves all the connection labels stored on this connection retrieval info object. Any change to the result Properties object does not affect the stored labels.
        Returns:
        A java.util.Properties object storing all the stored labels as key/value pairs. Returns null if there are no stored labels on this connection retrieval info object.

      • equalsIncludingPassword

        boolean equalsIncludingPassword​(ConnectionRetrievalInfo cri)
        Checks whether this instance is equal to another. This method also checks for password equality in addition to the equals method.
        Parameters:
        cri - Connection retrieval info object.
        Returns:
        Returns true, if the given CRI is equal to the current instance CRI including password field.

      • equalsNotIncludingPassword

        default boolean equalsNotIncludingPassword​(ConnectionRetrievalInfo cri)
        Checks whether this instance is equal to another. This method ignores password equality.
        Parameters:
        cri - Connection retrieval info object.
        cri -
        Returns:
        Returns true, if the given CRI is equal to the current instance CRI ignoring password field.

      • getCriMetadata

        default oracle.ucp.common.CriStats getCriMetadata()
        get borrow conext metadata (counters, appropriate semaphores and queues).
        Returns:
        CRI metadata.

      • criMatchSelector

        default java.util.function.Predicate<oracle.ucp.common.CoreConnection> criMatchSelector()
        Default predicate for CRI matching.
        Returns:
        CRI matching predicate.

      • getCopyWithUpdatedPassword

        default oracle.ucp.jdbc.JDBCConnectionRetrievalInfo getCopyWithUpdatedPassword()
        Default db account's password can be changed, but CRI as a connection attribute still holds an old password. Get a that CRI with updated password.
        Returns:
        CRI with updated password.