Package oracle.ucp
Class UniversalConnectionPoolException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- oracle.ucp.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 withnull
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 thecause
).
-
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.
-
-
-
Constructor Detail
-
UniversalConnectionPoolException
public UniversalConnectionPoolException()
Constructs a new exception withnull
as its detailed message. The cause is not initialized and may subsequently be initialized by a call toThrowable.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 toThrowable.initCause(java.lang.Throwable)
.- Parameters:
message
- the detail message. The detail message is saved for later retrieval by theThrowable.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 toThrowable.initCause(java.lang.Throwable)
.- Parameters:
message
- the detail message. The detail message is saved for later retrieval by theThrowable.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 theThrowable.getMessage()
method).cause
- the cause. The cause is saved for later retrieval by theThrowable.getCause()
method. Anull
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 thecause
). 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 theThrowable.getCause()
method. Anull
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.
-
-