org.apache.commons.lang.exception
クラス NestableDelegate

java.lang.Object
  org.apache.commons.lang.exception.NestableDelegate

すべての実装インタフェース:

Serializable

public class NestableDelegate

extends Object

implements Serializable

バージョン:

$Id: NestableDelegate.java,v 1.1.1.1 2004/02/13 10:02:04 hioki Exp $

作成者:

Rafal Krzewski, Daniel Rall, Kasper Nielsen, Steven Caswell, Sean C. Sullivan

関連項目:

直列化された形式

翻訳者:

日置 聡

フィールドの概要

private static String	MUST_BE_THROWABLE コンストラクタのエラーメッセージ。
private Throwable	nestable ラップしている例外またはエラーへの参照(これは Nestable の実装である必要があります)。

コンストラクタの概要

(パッケージプライベート)

NestableDelegate(Nestable nestable) 指定された Nestable を管理する NestableDelegate のインスタンスを新たに生成します。

メソッドの概要

(パッケージプライベート) String	getMessage(int index) 内部に保持されている Throwable のうち、0 から始まる指定されたインデックスに該当する Throwable のメッセージを返します。
(パッケージプライベート) String	getMessage(String baseMsg) Nestable とネストされた Throwable に含まれる全てのメッセージを返します。
(パッケージプライベート) String[]	getMessages() この例外と内部にネストされる Throwable のエラーメッセージをStringの配列に格納して返します。
private String[]	getStackFrames(Throwable t) 指定された Throwable オブジェクトに関連するスタックトレースを捕まえて スタックフレームのリストに再構成します。
(パッケージプライベート) Throwable	getThrowable(int index) 内部に保持されている Throwable のうち、0 から始まる指定されたインデックスに該当する Throwable を返します。
(パッケージプライベート) int	getThrowableCount() このクラスに含まれる Nestable の中の Throwable の数を返します。
(パッケージプライベート) Throwable[]	getThrowables() このクラス内の Nestable と、内部にネストされた Throwable を Throwable の配列に格納して返します。
(パッケージプライベート) int	indexOfThrowable(Class type, int fromIndex) このクラスの Nestable の内部にネストされた Throwable から、最初に見つかった指定された型の、検索開始位置より後ろの 0 から始まるインデックスを返します。
void	printStackTrace() 標準エラー出力にこの例外のスタックトレースを出力します。
void	printStackTrace(PrintStream out) 指定された stream にこの例外のスタックトレースを出力します。
void	printStackTrace(PrintWriter out) 指定された writer にこの例外のスタックトレースを出力します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

MUST_BE_THROWABLE

private static final transient String MUST_BE_THROWABLE

コンストラクタのエラーメッセージ。

関連項目:

定数フィールド値

nestable

private Throwable nestable

ラップしている例外またはエラーへの参照(これは Nestable の実装である必要があります)。

コンストラクタの詳細

NestableDelegate

NestableDelegate(Nestable nestable)

指定された Nestable を管理する NestableDelegate のインスタンスを新たに生成します。

パラメータ:

nestable - the Nestable implementation (must extend Throwable)

メソッドの詳細

getMessage

String getMessage(int index)

内部に保持されている Throwable のうち、0 から始まる指定されたインデックスに該当する Throwable のメッセージを返します。

パラメータ:

index - 内部に保持されている Throwable のインデックス

戻り値:

エラーメッセージ、インデックスで指定された Throwable にメッセージが設定されていない場合には null

例外:

IndexOutOfBoundsException - index の値がマイナスまたは内部の Throwable の数が指定された値よりも少ない場合

getMessage

String getMessage(String baseMsg)

Nestable とネストされた Throwable に含まれる全てのメッセージを返します。

パラメータ:

baseMsg - 全てのメッセージを作成する際に使用されるベースメッセージ。 一般的に nestableHelper.getMessage(super.getMessage()) を経由して呼ばれます。 super は Throwable のインスタンスを意味します。

戻り値:

この例外とネスとされた全ての Throwable のメッセージを連結したメッセージ

getMessages

String[] getMessages()

この例外と内部にネストされる Throwable のエラーメッセージをStringの配列に格納して返します。 メッセージを持たない Throwable のメッセージは null で表現されます。 返される配列の長さは原因の数を示す getThrowableCount() の返す値と一致します。

戻り値:

エラーメッセージ

getThrowable

Throwable getThrowable(int index)

内部に保持されている Throwable のうち、0 から始まる指定されたインデックスに該当する Throwable を返します。

パラメータ:

index - 内部に保持される Throwable の 0 から始まるインデックス

戻り値:

該当する Throwable

例外:

IndexOutOfBoundsException - index の値がマイナスまたは内部の Throwable の数が指定された値よりも少ない場合

getThrowableCount

int getThrowableCount()

このクラスに含まれる Nestable の中の Throwable の数を返します。

戻り値:

スロー可能オブジェクト(throwable)の数

getThrowables

Throwable[] getThrowables()

このクラス内の Nestable と、内部にネストされた Throwable を Throwable の配列に格納して返します。

戻り値:

Throwable の配列

indexOfThrowable

int indexOfThrowable(Class type,
                     int fromIndex)

このクラスの Nestable の内部にネストされた Throwable から、最初に見つかった指定された型の、検索開始位置より後ろの 0 から始まるインデックスを返します。 該当するものが見つからなかった場合には -1 を返します。

パラメータ:

type - 検索対象となる Class

fromIndex - 検索の開始位置となる 0 から始まるインデックス

戻り値:

指定された型が最初に見つかったインデックス、見つからなかった場合には -1

例外:

IndexOutOfBoundsException - fromIndexの値がマイナスまたは内部の Throwable の数が指定された値よりも少ない場合

printStackTrace

public void printStackTrace()

標準エラー出力にこの例外のスタックトレースを出力します。

printStackTrace

public void printStackTrace(PrintStream out)

指定された stream にこの例外のスタックトレースを出力します。

パラメータ:

out - 出力に使用される PrintStream

関連項目:

printStackTrace(PrintWriter)

printStackTrace

public void printStackTrace(PrintWriter out)

指定された writer にこの例外のスタックトレースを出力します。

パラメータ:

out - 出力に使用される PrintWriter

getStackFrames

private String[] getStackFrames(Throwable t)

指定された Throwable オブジェクトに関連するスタックトレースを捕まえて スタックフレームのリストに再構成します。

パラメータ:

t - 対象となる Throwable

戻り値:

スタックフレームの内容を表す文字列の配列