Package org.exolab.castor.util
Class NestedIOException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.io.IOException
-
- org.exolab.castor.util.NestedIOException
-
- All Implemented Interfaces:
java.io.Serializable
public class NestedIOException extends java.io.IOException
An exception that is used to signal I/O errors which are caused by other exceptions. This class allows the user get to the original exception.- Version:
- $Revision: 5951 $ $Date: 2005-12-13 14:58:48 -0700 (Tue, 13 Dec 2005) $
- Author:
- Keith Visco
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description NestedIOException()
Creates a new NestedIOException with no message, or nested ExceptionNestedIOException(java.lang.Exception exception)
Creates a new NestedIOException with the given nested exception.NestedIOException(java.lang.String message)
Creates a new NestedIOException with the given message.NestedIOException(java.lang.String message, java.lang.Exception exception)
Creates a new NestedIOException with the given message and nested exception.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.Exception
getException()
Returns the exception, which in turn caused this Exception to be thrown, or null if nested exception exists.void
printStackTrace()
void
printStackTrace(java.io.PrintStream printer)
void
printStackTrace(java.io.PrintWriter printer)
void
setLocalStackTraceOnly(boolean localTrace)
Sets whether or not to print the local stack trace or the nested stack trace when calls to #printStackTrace are made.java.lang.String
toString()
Returns the String representation of this Exception.
-
-
-
Constructor Detail
-
NestedIOException
public NestedIOException()
Creates a new NestedIOException with no message, or nested Exception
-
NestedIOException
public NestedIOException(java.lang.String message)
Creates a new NestedIOException with the given message.- Parameters:
message
- the message for this Exception
-
NestedIOException
public NestedIOException(java.lang.Exception exception)
Creates a new NestedIOException with the given nested exception.- Parameters:
exception
- the nested exception. (Must not be null).
-
NestedIOException
public NestedIOException(java.lang.String message, java.lang.Exception exception)
Creates a new NestedIOException with the given message and nested exception.- Parameters:
message
- the detail message for this exceptionexception
- the nested exception
-
-
Method Detail
-
getException
public java.lang.Exception getException()
Returns the exception, which in turn caused this Exception to be thrown, or null if nested exception exists.- Returns:
- the exception, which in turn caused this Exception to be thrown, or null if nested exception exists.
-
setLocalStackTraceOnly
public void setLocalStackTraceOnly(boolean localTrace)
Sets whether or not to print the local stack trace or the nested stack trace when calls to #printStackTrace are made. By default the nested exception is used for printing stack trace.- Parameters:
localTrace
- a boolean when true enables local stack trace only.
-
toString
public java.lang.String toString()
Returns the String representation of this Exception.- Overrides:
toString
in classjava.lang.Throwable
- Returns:
- the String representation of this Exception.
-
printStackTrace
public void printStackTrace()
- Overrides:
printStackTrace
in classjava.lang.Throwable
-
printStackTrace
public void printStackTrace(java.io.PrintWriter printer)
- Overrides:
printStackTrace
in classjava.lang.Throwable
-
printStackTrace
public void printStackTrace(java.io.PrintStream printer)
- Overrides:
printStackTrace
in classjava.lang.Throwable
-
-