java.lang.reflect

クラス UndeclaredThrowableException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.lang.reflect.UndeclaredThrowableException

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

Serializable

public class UndeclaredThrowableException
extends RuntimeException

呼び出しハンドラの invoke メソッドが、プロキシインスタンスで呼び出され、呼び出しハンドラにディスパッチされたメソッドの throws 節で宣言されたどの例外タイプにも割り当てできないチェック例外 (RuntimeException または Error に割り当てできない Throwable) をスローした場合、プロキシインスタンスのメソッド呼び出しによってスローされます。

UndeclaredThrowableException インスタンスは、呼び出しハンドラによってスローされた、宣言されていないチェック例外を格納しており、getUndeclaredThrowable() メソッドで取得できます。UndeclaredThrowableException は RuntimeException を拡張するため、チェック例外をラップする非チェック例外となります。

1.4 リリースでは、この例外は汎用的な例外チェーンメカニズムに適合するように改良されています。「呼び出しハンドラによりスローされた宣言されていないチェック例外」 (構築時に提供され、getUndeclaredThrowable() メソッドを介してアクセス可能) は、cause と呼ばれるようになり、前述の「レガシーメソッド」に加えて Throwable.getCause() メソッドを介してアクセス可能です。

導入されたバージョン:

1.3

関連項目:

InvocationHandler, 直列化された形式

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
UndeclaredThrowableException(Throwable undeclaredThrowable) 指定された Throwable を持つ UndeclaredThrowableException を構築します。
UndeclaredThrowableException(Throwable undeclaredThrowable, String s) 指定された Throwable と詳細メッセージを持つ UndeclaredThrowableException を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Throwable	getCause() この例外の原因 (この UndeclaredThrowableException にラップされた Throwable インスタンス。null の可能性もある) を返します。
Throwable	getUndeclaredThrowable() この UndeclaredThrowableException でラップされた Throwable インスタンスを返します (null も可)。

クラス java.lang.Throwable から継承されたメソッド

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

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

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

コンストラクタの詳細

UndeclaredThrowableException

public UndeclaredThrowableException(Throwable undeclaredThrowable)

指定された Throwable を持つ UndeclaredThrowableException を構築します。

パラメータ:

undeclaredThrowable - スローされた、宣言されていないチェック例外

UndeclaredThrowableException

public UndeclaredThrowableException(Throwable undeclaredThrowable,
                            String s)

指定された Throwable と詳細メッセージを持つ UndeclaredThrowableException を構築します。

パラメータ:

undeclaredThrowable - スローされた、宣言されていないチェック例外

s - 詳細メッセージ

メソッドの詳細

getUndeclaredThrowable

public Throwable getUndeclaredThrowable()

この UndeclaredThrowableException でラップされた Throwable インスタンスを返します (null も可)。

このメソッドは汎用的な例外チェーン機能に先行します。Throwable.getCause() メソッドが、この情報を取得するために現在推奨されている手段です。

戻り値:

スローされた、宣言されていないチェック例外

getCause

public Throwable getCause()

この例外の原因 (この UndeclaredThrowableException にラップされた Throwable インスタンス。null の可能性もある) を返します。

オーバーライド:

getCause、クラス: Throwable

戻り値:

この例外の原因

導入されたバージョン:

1.4