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
getUndeclaredThrowable()
このUndeclaredThrowableException
でラップされたThrowable
インスタンスを返します(null
も可)。クラス java.lang.Throwableで宣言されたメソッド
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
コンストラクタの詳細
-
UndeclaredThrowableException
public UndeclaredThrowableException(Throwable undeclaredThrowable)指定されたThrowable
を持つUndeclaredThrowableException
を構築します。- パラメータ:
undeclaredThrowable
- スローされた、宣言されていないチェック例外
-
UndeclaredThrowableException
指定されたThrowable
と詳細メッセージを持つUndeclaredThrowableException
を構築します。- パラメータ:
undeclaredThrowable
- スローされた、宣言されていないチェック例外s
- 詳細メッセージ
-
-
メソッドの詳細
-
getUndeclaredThrowable
public Throwable getUndeclaredThrowable()このUndeclaredThrowableException
でラップされたThrowable
インスタンスを返します(null
も可)。このメソッドは汎用的な例外チェーン機能に先行します。
Throwable.getCause()
メソッドが、この情報を取得するために現在推奨されている手段です。- 戻り値:
- スローされた、宣言されていないチェック例外
-