java.lang

クラス StackTraceElement

java.lang.Object

java.lang.StackTraceElement

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

Serializable

public final class StackTraceElement
extends Object
implements Serializable

スタックトレース内の要素で、Throwable.getStackTrace() により返される値。各要素は単一のスタックフレームを表します。スタックの先頭にあるスタックフレームを除く、すべてのスタックフレームは、メソッド呼び出しを表します。スタックの先頭のフレームは、スタックトレースが生成された実行ポイントを表します。通常、これは、スタックトレースに対応するスロー可能オブジェクトが作成されたポイントになります。

導入されたバージョン:

1.4

関連項目:

直列化された形式

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

コンストラクタ

コンストラクタと説明
StackTraceElement(String declaringClass, String methodName, String fileName, int lineNumber) 指定された実行ポイントを表すスタックトレース要素を作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
boolean	equals(Object obj) 指定されたオブジェクトが、このインスタンスと同じ実行ポイントを表す、別の StackTraceElement インスタンスである場合、true を返します。
String	getClassName() このスタックトレース要素が表す実行ポイントを含むクラスの完全修飾名を返します。
String	getFileName() このスタックトレース要素が表す実行ポイントを含むソースファイルの名前を返します。
int	getLineNumber() このスタックトレース要素が表す実行ポイントを含むソースファイルの行番号を返します。
String	getMethodName() このスタックトレース要素が表す実行ポイントを含むメソッドの名前を返します。
int	hashCode() このスタックトレース要素のハッシュコード値を返します。
boolean	isNativeMethod() このスタックトレース要素が表す実行ポイントを含むメソッドがネイティブメソッドの場合、true を返します。
String	toString() このスタックトレース要素の文字列表現を返します。

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

StackTraceElement

public StackTraceElement(String declaringClass,
                 String methodName,
                 String fileName,
                 int lineNumber)

指定された実行ポイントを表すスタックトレース要素を作成します。

パラメータ:

declaringClass - スタックトレース要素が表す実行ポイントを含むクラスの完全修飾名

methodName - スタックトレース要素が表す実行ポイントを含むメソッドの名前

fileName - スタックトレース要素が表す実行ポイントを含むファイルの名前、または null (この情報を使用できない場合)

lineNumber - このスタックトレース要素が表す実行ポイントを含むソース行の行番号、または負の数値 (この情報を使用できない場合)。-2 の値は、実行ポイントを含むメソッドがネイティブメソッドであることを示す

例外:

NullPointerException - declaringClass または methodName が null の場合

導入されたバージョン:

1.5

メソッドの詳細

getFileName

public String getFileName()

このスタックトレース要素が表す実行ポイントを含むソースファイルの名前を返します。 通常、これは、関連する class ファイルの SourceFile 属性を表します (Java 仮想マシン仕様のセクション 4.7.7 を参照)。システムによっては、名前が、ファイルではなくソースコード単位を参照する場合もあります (ソースリポジトリ内のエントリなど)。

戻り値:

このスタックトレース要素が表す実行ポイントを含むファイルの名前、または null (この情報を使用できない場合)。

getLineNumber

public int getLineNumber()

このスタックトレース要素が表す実行ポイントを含むソースファイルの行番号を返します。 通常、この値は、関連する class ファイルの LineNumberTable 属性から導き出されます (Java 仮想マシン仕様のセクション 4.7.8 を参照)。

戻り値:

このスタックトレース要素が表す実行ポイントを含むソース行の行番号、または負の数値 (この情報を使用できない場合)

getClassName

public String getClassName()

このスタックトレース要素が表す実行ポイントを含むクラスの完全修飾名を返します。

戻り値:

このスタックトレース要素が表す実行ポイントを含む Class の完全修飾名。

getMethodName

public String getMethodName()

このスタックトレース要素が表す実行ポイントを含むメソッドの名前を返します。 実行ポイントがインスタンスまたはクラス初期化子に含まれる場合、このメソッドは適切な特殊メソッド名 <init> または <clinit> を返します (『Java 仮想マシン仕様』のセクション 3.9 を参照)。

戻り値:

このスタックトレース要素が表す実行ポイントを含むメソッドの名前。

isNativeMethod

public boolean isNativeMethod()

このスタックトレース要素が表す実行ポイントを含むメソッドがネイティブメソッドの場合、true を返します。

戻り値:

このスタックトレース要素が表す実行ポイントを含むメソッドがネイティブメソッドの場合、true を返す。

toString

public String toString()

このスタックトレース要素の文字列表現を返します。この文字列の書式は実装によって異なります。一般的な例を、次に示します。

• "MyClass.mash(MyClass.java:9)" - ここで、"MyClass" はこのスタックトレース要素で表される実行ポイントを含むクラスの完全修飾名、"mash" は実行ポイントを含むメソッドの名前、"MyClass.java" は実行ポイントを含むソースファイル、"9" は実行ポイントを含むソース行の行番号です。
• "MyClass.mash(MyClass.java)" - 上記と同じ。ただし、行番号を利用できない点が異なる。
• "MyClass.mash(Unknown Source)" - 上記と同じ。ただし、ファイル名も行番号も利用できない点が異なる。
• "MyClass.mash(Native Method)" - 上記と同じ。ただし、ファイル名も行番号も利用できず、実行ポイントを含むメソッドがネイティブメソッドと見なされる点が異なる。

オーバーライド:

toString、クラス: Object

戻り値:

このオブジェクトの文字列表現。

関連項目:

Throwable.printStackTrace()

equals

public boolean equals(Object obj)

指定されたオブジェクトが、このインスタンスと同じ実行ポイントを表す、別の StackTraceElement インスタンスである場合、true を返します。 2 つのスタックトレース要素 a および b が等価になるのは、次の場合だけです。

     equals(a.getFileName(), b.getFileName()) &&
     a.getLineNumber() == b.getLineNumber()) &&
     equals(a.getClassName(), b.getClassName()) &&
     equals(a.getMethodName(), b.getMethodName())
 

ここで、equals は Objects.equals のセマンティクスを持ちます。

オーバーライド:

equals、クラス: Object

パラメータ:

obj - スタックトレース要素と比較されるオブジェクト。

戻り値:

指定されたオブジェクトが、このインスタンスと同じ実行ポイントを表す別の StackTraceElement である場合、true を返す。

関連項目:

Object.hashCode()、HashMap

hashCode

public int hashCode()

このスタックトレース要素のハッシュコード値を返します。

オーバーライド:

hashCode、クラス: Object

戻り値:

このオブジェクトのハッシュコード値。

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)