compact1、compact2、compact3

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)