org.apache.commons.lang.exception
インタフェース Nestable

既知の実装クラスの一覧:

NestableError, NestableException, NestableRuntimeException

public interface Nestable

An interface to be implemented by Throwable extensions which would like to be able to nest root exceptions inside themselves.

導入されたバージョン:

1.0

バージョン:

$Id: Nestable.java,v 1.1.1.1 2004/02/13 10:02:05 hioki Exp $

作成者:

Daniel Rall, Kasper Nielsen, Steven Caswell, Pete Gieser

メソッドの概要

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 Throwables at the specified index, numbererd from 0.
String[]	getMessages() Returns the error message of this and any nested Throwables in an array of Strings, one element for each message.
Throwable	getThrowable(int index) Returns the Throwable in the chain of Throwables at the specified index, numbererd from 0.
int	getThrowableCount() Returns the number of nested Throwables represented by this Nestable, including this Nestable.
Throwable[]	getThrowables() Returns this Nestable and any nested Throwables in an array of Throwables, 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 Throwables, 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 Throwables 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.

メソッドの詳細

getCause

public Throwable getCause()

Returns the reference to the exception or error that caused the exception implementing the Nestable to be thrown.

戻り値:

throwable that caused the original exception

getMessage

public String getMessage()

Returns the error message of this and any nested Throwable.

戻り値:

the error message

getMessage

public String getMessage(int index)

Returns the error message of the Throwable in the chain of Throwables at the specified index, numbererd from 0.

パラメータ:

index - the index of the Throwable in the chain of Throwables

戻り値:

the error message, or null if the 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 Throwables in the chain

getMessages

public String[] getMessages()

Returns the error message of this and any nested Throwables 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.

戻り値:

the error messages

getThrowable

public Throwable getThrowable(int index)

Returns the Throwable in the chain of Throwables at the specified index, numbererd from 0.

パラメータ:

index - the index, numbered from 0, of the Throwable in the chain of Throwables

戻り値:

the Throwable

例外:

IndexOutOfBoundsException - if the index argument is negative or not less than the count of Throwables in the chain

getThrowableCount

public int getThrowableCount()

Returns the number of nested Throwables represented by this Nestable, including this Nestable.

戻り値:

the throwable count

getThrowables

public Throwable[] getThrowables()

Returns this Nestable and any nested Throwables in an array of Throwables, one element for each Throwable.

戻り値:

the Throwables

indexOfThrowable

public int indexOfThrowable(Class type)

Returns the index, numbered from 0, of the first occurrence of the specified type in the chain of Throwables, or -1 if the specified type is not found in the chain.

パラメータ:

type - Class to be found

戻り値:

index of the first occurrence of the type in the chain, or -1 if the type is not found

indexOfThrowable

public 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 Throwables with an index greater than or equal to the specified index, or -1 if the type is not found.

パラメータ:

type - Class to be found

fromIndex - the index, numbered from 0, of the starting position in the chain to be searched

戻り値:

index of the first occurrence of the type in the chain, or -1 if the type is not found

例外:

IndexOutOfBoundsException - if the fromIndex argument is negative or not less than the count of Throwables in the chain

printStackTrace

public void printStackTrace(PrintWriter out)

Prints the stack trace of this exception to the specified print writer. Includes information from the exception, if any, which caused this exception.

パラメータ:

out - PrintWriter to use for output.

printStackTrace

public void printStackTrace(PrintStream out)

Prints the stack trace of this exception to the specified print stream. Includes inforamation from the exception, if any, which caused this exception.

パラメータ:

out - PrintStream to use for output.

printPartialStackTrace

public void printPartialStackTrace(PrintWriter out)

Prints the stack trace for this exception only--root cause not included--using the provided writer. Used by 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.