public interface Nestable
Throwable
extensions
which would like to be able to nest root exceptions inside themselves.Modifier and Type | Method and Description |
---|---|
Throwable |
getCause()
Returns the reference to the exception or error that caused the exception
implementing the
Nestable to be thrown. |
String |
getMessage()
Returns the error message of this and any nested
Throwable . |
String |
getMessage(int index)
Returns the error message of the
Throwable in the chain of
Throwable s at the specified index, numbered from 0. |
String[] |
getMessages()
Returns the error message of this and any nested
Throwable s
in an array of Strings, one element for each message. |
Throwable |
getThrowable(int index)
Returns the
Throwable in the chain of
Throwable s at the specified index, numbered from 0. |
int |
getThrowableCount()
Returns the number of nested
Throwable s represented by
this Nestable , including this Nestable . |
Throwable[] |
getThrowables()
Returns this
Nestable and any nested
Throwable s in an array of Throwable s, one
element for each Throwable . |
int |
indexOfThrowable(Class type)
Returns the index, numbered from 0, of the first occurrence of the
specified type in the chain of
Throwable s, or -1 if the
specified type is not found in the chain. |
int |
indexOfThrowable(Class type,
int fromIndex)
Returns the index, numbered from 0, of the first
Throwable
that matches the specified type in the chain of Throwable s
with an index greater than or equal to the specified index, or -1 if the
type is not found. |
void |
printPartialStackTrace(PrintWriter out)
Prints the stack trace for this exception only--root cause not
included--using the provided writer.
|
void |
printStackTrace(PrintStream out)
Prints the stack trace of this exception to the specified print stream.
|
void |
printStackTrace(PrintWriter out)
Prints the stack trace of this exception to the specified print writer.
|
Throwable getCause()
Nestable
to be thrown.String getMessage()
Throwable
.String getMessage(int index)
Throwable
in the chain of
Throwable
s at the specified index, numbered from 0.index
- the index of the Throwable
in the chain of
Throwable
sThrowable
at the
specified index in the chain does not contain a messageIndexOutOfBoundsException
- if the index
argument is negative or not less
than the count of Throwable
s in the chainString[] getMessages()
Throwable
s
in an array of Strings, one element for each message. Any
Throwable
not containing a message is represented in the
array by a null. This has the effect of cause the length of the returned
array to be equal to the result of the getThrowableCount()
operation.Throwable getThrowable(int index)
Throwable
in the chain of
Throwable
s at the specified index, numbered from 0.index
- the index, numbered from 0, of the Throwable
in
the chain of Throwable
sThrowable
IndexOutOfBoundsException
- if the index
argument is negative or not less
than the count of Throwable
s in the chainint getThrowableCount()
Throwable
s represented by
this Nestable
, including this Nestable
.Throwable[] getThrowables()
Nestable
and any nested
Throwable
s in an array of Throwable
s, one
element for each Throwable
.Throwable
sint indexOfThrowable(Class type)
Throwable
s, or -1 if the
specified type is not found in the chain.type
- Class
to be foundint indexOfThrowable(Class type, int fromIndex)
Throwable
that matches the specified type in the chain of Throwable
s
with an index greater than or equal to the specified index, or -1 if the
type is not found.type
- Class
to be foundfromIndex
- the index, numbered from 0, of the starting position in the
chain to be searchedIndexOutOfBoundsException
- if the fromIndex
argument is negative or not
less than the count of Throwable
s in the
chainvoid printStackTrace(PrintWriter out)
out
- PrintWriter
to use for output.void printStackTrace(PrintStream out)
out
- PrintStream
to use for output.void printPartialStackTrace(PrintWriter out)
super.printStackTrace(out);
in most cases.out
- The writer to use.Copyright © 2003–2013 The Apache Software Foundation. All rights reserved.