java.lang
クラス Throwable

java.lang.Object
  java.lang.Throwable

直系の既知のサブクラス:

Error, Exception

public class Throwable
extends Object

Throwable クラスは、Java 言語および Java 仮想マシンにおいて throw される全てのクラスのスーパークラスです。 同様にこのクラスおよびサブクラスを catch 節で指定することができます。

通常、throw されるクラスは Exception クラスあるいは Error クラスのサブクラスとして作成されます。 一般的な例外を示す場合は Exception クラスのサブクラスとして、致命的な状態を示す場合は Error クラスのサブクラスとして作成します。

一般的に Throwable クラスのサブクラスは Throwable クラスと同様に２つのコンストラクタを持ちます。 １つはパラメータを受け取らずにオブジェクトを生成するコンストラクタであり、もう１つはパラメータから String クラスによるメッセージを受け取ってオブジェクトを生成するコンストラクタです。 サブクラスによっては更に多くのコンストラクタを持つものもあります。

Throwable クラスには、オブジェクトが生成されてから throw された実行スタックのスナップショットが含まれています。 また、オブジェクト生成時に設定されたメッセージを含みます。

導入されたバージョン:

CLDC 1.0

Throwable

public Throwable()

メッセージを指定しないでオブジェクトを構築します。

Throwable

public Throwable(String msg)

メッセージを指定してオブジェクトを構築します。

パラメータ:

msg - 生成された理由を示すメッセージ。

getMessage

public String getMessage()

設定されているメッセージ文字列を返します。 メッセージが設定されていない場合は null を返します。

戻り値:

メッセージ文字列あるいは null を返します。

toString

public String toString()

Throwable オブジェクトの文字列表現を返します。 オブジェクトにメッセージ文字列が指定されている場合は、

• オブジェクトの実際のクラス名。
• : （コロン＋スペース）。
• 設定されているメッセージ文字列

の形の文字列表現を返します。 メッセージ文字列が指定されていない場合は実際のクラス名を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

Throwable オブジェクトの文字列表現が戻ります。

printStackTrace

public void printStackTrace()

Throwable オブジェクトが投げられた位置からのスタック・トレースを標準エラー・ストリームへ出力します。

関連項目:

System.err