|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
An interface to be implemented by Throwable
extensions which would like to be able to nest root exceptions
inside themselves.
Method Summary | |
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, numbererd 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, numbererd 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. |
Method Detail |
public Throwable getCause()
Nestable
to be thrown.
public String getMessage()
Throwable
.
public String getMessage(int index)
Throwable
in the chain
of Throwable
s at the specified index, numbererd from 0.
index
- the index of the Throwable
in the chain of
Throwable
s
Throwable
at the
specified index in the chain does not contain a message
IndexOutOfBoundsException
- if the index
argument is
negative or not less than the count of Throwable
s in the
chainpublic String[] 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.
public Throwable getThrowable(int index)
Throwable
in the chain of
Throwable
s at the specified index, numbererd from 0.
index
- the index, numbered from 0, of the Throwable
in
the chain of Throwable
s
Throwable
IndexOutOfBoundsException
- if the index
argument is
negative or not less than the count of Throwable
s in the
chainpublic int getThrowableCount()
Throwable
s represented by
this Nestable
, including this Nestable
.
public Throwable[] getThrowables()
Nestable
and any nested Throwable
s
in an array of Throwable
s, one element for each
Throwable
.
Throwable
spublic int indexOfThrowable(Class type)
Throwable
s, or -1 if the
specified type is not found in the chain.
type
- Class
to be found
public int 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 searched
IndexOutOfBoundsException
- if the fromIndex
argument
is negative or not less than the count of Throwable
s in the
chainpublic void printStackTrace(PrintWriter out)
out
- PrintWriter
to use for output.public void printStackTrace(PrintStream out)
out
- PrintStream
to use for output.public void printPartialStackTrace(PrintWriter out)
NestableDelegate
to write
individual stack traces to a buffer. The implementation of
this method should call
super.printStackTrace(out);
in most cases.
out
- The writer to use.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |