Package oracle.ucp

Class UniversalConnectionPoolException

java.lang.Object
java.lang.Throwable
java.lang.Exception
oracle.ucp.UniversalConnectionPoolException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
NoAvailableConnectionsException
public class UniversalConnectionPoolException extends Exception

Common Universal Connection Pool (UCP) exception.

In some cases, namely if there are no available connections to borrow, this exception's message will contain a short form of pool statistics for better diagnostics. This short form of stats is described in shortForm

See Also:

  • Field Details

    • errorCode

      protected int errorCode

  • Constructor Details

    • UniversalConnectionPoolException

      public UniversalConnectionPoolException()
      Constructs a new exception with null as its detailed message. The cause is not initialized and may subsequently be initialized by a call to Throwable.initCause(java.lang.Throwable).

    • UniversalConnectionPoolException

      public UniversalConnectionPoolException(String message)
      Constructs a new exception with the specified detail message. The cause is not initialized and may subsequently be initialized by a call to Throwable.initCause(java.lang.Throwable).
      Parameters:
      message - the detail message. The detail message is saved for later retrieval by the Throwable.getMessage() method.

    • UniversalConnectionPoolException

      public UniversalConnectionPoolException(String message, int errorCode)
      Constructs a new exception with the specified detail message and error code. The cause is not initialized and may subsequently be initialized by a call to Throwable.initCause(java.lang.Throwable).
      Parameters:
      message - the detail message. The detail message is saved for later retrieval by the Throwable.getMessage() method.
      errorCode - the error code for this exception.

    • UniversalConnectionPoolException

      public UniversalConnectionPoolException(String message, Throwable cause)
      Constructs a new exception with the specified detail message and cause.

      Note that the detail message associated with cause is not automatically incorporated in this exception's detail message.

      Parameters:
      message - the detail message. The detail message is saved for later retrieval by the Throwable.getMessage() method).
      cause - the cause. The cause is saved for later retrieval by the Throwable.getCause() method. A null value is permitted and indicates that the cause is nonexistent or unknown.

    • UniversalConnectionPoolException

      public UniversalConnectionPoolException(Throwable cause)
      Constructs a new exception with the specified cause and a detail message of (cause==null ? null : cause.toString()), which typically contains the class and detail message of the cause). This constructor is useful for exceptions that are little more than wrappers for other throwables (for example, PrivilegedActionException).
      Parameters:
      cause - the cause. The cause is saved for later retrieval by the Throwable.getCause() method. A null value is permitted and indicates that the cause is nonexistent or unknown.

  • Method Details

    • getErrorCode

      public int getErrorCode()
      Gets the error code associated with this exception.
      Returns:
      the error code.

    • traverseToSQLExceptionCause

      public SQLException traverseToSQLExceptionCause()
      Traverse through the chain of "causes" (cause of cause of cause...) for a this UCPException to find nearest SQLException, if exists.
      Returns:
      nearest SQLException cause, or null, if no such cause.