java.lang.Object | +--java.lang.Throwable
Throwable
クラスは、Java 言語のすべてのエラーと例外のスーパークラスです。このクラス (またはそのサブクラスの内の 1 つ) のインスタンスであるオブジェクトだけが Java Virtual Machine によってスローされるか、Java の throw
構文によってスローされます。同じように、このクラスまたはそのサブクラスの内の 1 つだけが catch
節の引数の型に指定できます。
通常、Error
および Exception
の 2 つのサブクラスのインスタンスは例外的な状況が発生したことを示すために使用されます。これらのインスタンスは、通常、関連する情報 (スタックトレースデータなど) を格納するために、例外的の状況に応じて新しく作成されます。
通常、Throwable
クラスおよびその下位クラスは 2 つのコンストラクタを持ちます。これらのコンストラクタのうちの 1 つは引数をとらず、もう 1 つはエラーメッセージを生成するために使用する String
引数をとります。
Throwable
クラスには、作成時のそのスレッドの実行スタックのスナップショットが含まれます。このクラスには、エラーについての詳細な情報を示すメッセージ文字列も含まれます。
例外のキャッチの例を次に示します。
try { int a[] = new int[2]; a[4]; } catch (ArrayIndexOutOfBoundsException e) { System.out.println("exception: " + e.getMessage()); e.printStackTrace(); }
コンストラクタの概要 | |
Throwable()
エラーメッセージ文字列として null を指定して Throwable を新しく構築します。 |
|
Throwable(String message)
指定されたエラーメッセージを持つ Throwable を新しく構築します。 |
メソッドの概要 | |
String |
getMessage()
この Throwable オブジェクトのエラーメッセージ文字列を返します。 |
void |
printStackTrace()
Throwable とそのバックトレースを標準エラーストリームに出力します。 |
String |
toString()
Throwable オブジェクトの短い記述を返します。 |
クラス java.lang.Object から継承したメソッド |
equals,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
コンストラクタの詳細 |
public Throwable()
null
を指定して Throwable
を新しく構築します。public Throwable(String message)
Throwable
を新しく構築します。message
- エラーメッセージ。エラーメッセージは getMessage()
メソッドによる取り出しのために保存されるメソッドの詳細 |
public String getMessage()
作成
された場合は、この Throwable
オブジェクトのエラーメッセージ文字列。エラーメッセージなしで:n@.
された場合は null
public String toString()
Throwable
オブジェクトがエラーメッセージ文字列付きで作成
された場合、結果は次の 3 つの文字列を連結したものになります。
getMessage()
メソッドの結果
Throwable
オブジェクトがエラーメッセージ文字列なしで作成
された場合は、オブジェクトの実際のクラス名が返されます。Throwable
の文字列表現public void printStackTrace()
Throwable
とそのバックトレースを標準エラーストリームに出力します。