org.apache.commons.lang

Class UnhandledException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.apache.commons.lang.exception.NestableRuntimeException

org.apache.commons.lang.UnhandledException

All Implemented Interfaces:

java.io.Serializable, Nestable

public class UnhandledException
extends NestableRuntimeException

Thrown when it is impossible or undesirable to consume or throw a checked exception.

This exception supplements the standard exception classes by providing a more semantically rich description of the problem.

UnhandledException represents the case where a method has to deal with a checked exception but does not wish to. Instead, the checked exception is rethrown in this unchecked wrapper.

 public void foo() {
   try {
     // do something that throws IOException
   } catch (IOException ex) {
     // don't want to or can't throw IOException from foo()
     throw new UnhandledException(ex);
   }
 }
 

Since:

2.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
UnhandledException(java.lang.String message, java.lang.Throwable cause) Constructs the exception using a message and cause.
UnhandledException(java.lang.Throwable cause) Constructs the exception using a cause.

Method Summary

Methods inherited from class org.apache.commons.lang.exception.NestableRuntimeException

getCause, getMessage, getMessage, getMessages, getThrowable, getThrowableCount, getThrowables, indexOfThrowable, indexOfThrowable, printPartialStackTrace, printStackTrace, printStackTrace, printStackTrace

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

UnhandledException

public UnhandledException(java.lang.Throwable cause)

Constructs the exception using a cause.

Parameters:

cause - the underlying cause

UnhandledException

public UnhandledException(java.lang.String message,
                          java.lang.Throwable cause)

Constructs the exception using a message and cause.

Parameters:

message - the message to use

cause - the underlying cause