org.springframework.core: abstract public class: NestedCheckedException

org.springframework.core
abstract public class: NestedCheckedException [javadoc | source]

java.lang.Object
   java.lang.Throwable
      java.lang.Exception
         org.springframework.core.NestedCheckedException

All Implemented Interfaces:
Serializable

Direct Known Subclasses:
MetaDataAccessException

Handy class for wrapping checked Exceptions with a root cause.

This class is abstract to force the programmer to extend the class. getMessage will include nested exception information; printStackTrace and other like methods will delegate to the wrapped exception, if any.

The similarity between this class and the NestedRuntimeException class is unavoidable, as Java forces these two classes to have different superclasses (ah, the inflexibility of concrete inheritance!).

Also see:

getMessage

printStackTrace

NestedRuntimeException

author: Rod - Johnson

author: Juergen - Hoeller

Constructor:

Constructor:
public NestedCheckedException(String msg) { super(msg); } Construct a `NestedCheckedException` with the specified detail message. Parameters: `msg` - the detail message
public NestedCheckedException(String msg, Throwable cause) { super(msg, cause); } Construct a `NestedCheckedException` with the specified detail message and nested exception. Parameters: `msg` - the detail message `cause` - the nested exception

 public NestedCheckedException(String msg) {
	             	 
		super(msg);
}

NestedCheckedException

Parameters:

msg - the detail message

 public NestedCheckedException(String msg,
    Throwable cause) {
		super(msg, cause);
}

NestedCheckedException

Parameters:

msg - the detail message

cause - the nested exception

Method from org.springframework.core.NestedCheckedException Summary:
contains, getMessage, getMostSpecificCause, getRootCause

Methods from java.lang.Throwable:
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.springframework.core.NestedCheckedException Detail:
public boolean contains(Class exType) { if (exType == null) { return false; } if (exType.isInstance(this)) { return true; } Throwable cause = getCause(); if (cause == this) { return false; } if (cause instanceof NestedCheckedException) { return ((NestedCheckedException) cause).contains(exType); } else { while (cause != null) { if (exType.isInstance(cause)) { return true; } if (cause.getCause() == cause) { break; } cause = cause.getCause(); } return false; } } Check whether this exception contains an exception of the given type: either it is of the given class itself or it contains a nested cause of the given type.
public String getMessage() { return NestedExceptionUtils.buildMessage(super.getMessage(), getCause()); } Return the detail message, including the message from the nested exception if there is one.
public Throwable getMostSpecificCause() { Throwable rootCause = getRootCause(); return (rootCause != null ? rootCause : this); } Retrieve the most specific cause of this exception, that is, either the innermost cause (root cause) or this exception itself. Differs from #getRootCause() in that it falls back to the present exception if there is no root cause.
public Throwable getRootCause() { Throwable rootCause = null; Throwable cause = getCause(); while (cause != null && cause != rootCause) { rootCause = cause; cause = cause.getCause(); } return rootCause; } Retrieve the innermost cause of this exception, if any.

Method from org.springframework.core.NestedCheckedException Detail:

 public boolean contains(Class exType) {
		if (exType == null) {
			return false;
		}
		if (exType.isInstance(this)) {
			return true;
		}
		Throwable cause = getCause();
		if (cause == this) {
			return false;
		}
		if (cause instanceof NestedCheckedException) {
			return ((NestedCheckedException) cause).contains(exType);
		}
		else {
			while (cause != null) {
				if (exType.isInstance(cause)) {
					return true;
				}
				if (cause.getCause() == cause) {
					break;
				}
				cause = cause.getCause();
			}
			return false;
		}
}

Check whether this exception contains an exception of the given type: either it is of the given class itself or it contains a nested cause of the given type.

 public String getMessage() {
		return NestedExceptionUtils.buildMessage(super.getMessage(), getCause());
}

Return the detail message, including the message from the nested exception if there is one.

 public Throwable getMostSpecificCause() {
		Throwable rootCause = getRootCause();
		return (rootCause != null ? rootCause : this);
}

Differs from #getRootCause() in that it falls back to the present exception if there is no root cause.

 public Throwable getRootCause() {
		Throwable rootCause = null;
		Throwable cause = getCause();
		while (cause != null && cause != rootCause) {
			rootCause = cause;
			cause = cause.getCause();
		}
		return rootCause;
}

Retrieve the innermost cause of this exception, if any.