Package oracle.ucp

Class UniversalConnectionPoolException

  • All Implemented Interfaces:
    java.io.Serializable
    Direct Known Subclasses:
    NoAvailableConnectionsException
    public class UniversalConnectionPoolException
extends java.lang.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:
    Serialized Form

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected int errorCode  

    • Constructor Summary

      Constructors 
      Constructor Description
      UniversalConnectionPoolException()
      Constructs a new exception with null as its detailed message.
      UniversalConnectionPoolException​(java.lang.String message)
      Constructs a new exception with the specified detail message.
      UniversalConnectionPoolException​(java.lang.String message, int errorCode)
      Constructs a new exception with the specified detail message and error code.
      UniversalConnectionPoolException​(java.lang.String message, java.lang.Throwable cause)
      Constructs a new exception with the specified detail message and cause.
      UniversalConnectionPoolException​(java.lang.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).

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      int getErrorCode()
      Gets the error code associated with this exception.
      java.sql.SQLException traverseToSQLExceptionCause()
      Traverse through the chain of "causes" (cause of cause of cause...) for a this UCPException to find nearest SQLException, if exists.

      • Methods inherited from class java.lang.Throwable

        addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

    • Field Detail

      • errorCode

        protected int errorCode

    • Constructor Detail

      • 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​(java.lang.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​(java.lang.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​(java.lang.String message,
                                        java.lang.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​(java.lang.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 Detail

      • getErrorCode

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

      • traverseToSQLExceptionCause

        public java.sql.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.