compact1, compact2, compact3

java.lang

Class StackTraceElement

java.lang.Object

java.lang.StackTraceElement

All Implemented Interfaces:

Serializable

public final class StackTraceElement
extends Object
implements Serializable

堆栈跟踪中的一个元素，由Throwable.getStackTrace()返回。 每个元素表示单个堆栈帧。 堆栈顶部除堆栈之外的所有堆栈都表示方法调用。 堆栈顶部的帧表示生成堆栈跟踪的执行点。 通常，这是创建与堆栈跟踪相对应的throwable的点。

从以下版本开始：

1.4

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
StackTraceElement(String declaringClass, String methodName, String fileName, int lineNumber) 创建表示指定执行点的堆栈跟踪元素。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object obj) 如果指定的对象是另一个 StackTraceElement与该实例相同的执行点的 StackTraceElement实例，则返回true。
String	getClassName() 返回包含由该堆栈跟踪元素表示的执行点的类的完全限定名称。
String	getFileName() 返回包含由该堆栈跟踪元素表示的执行点的源文件的名称。
int	getLineNumber() 返回包含由该堆栈跟踪元素表示的执行点的源行的行号。
String	getMethodName() 返回包含由该堆栈跟踪元素表示的执行点的方法的名称。
int	hashCode() 返回此堆栈跟踪元素的哈希码值。
boolean	isNativeMethod() 如果包含由此堆栈跟踪元素表示的执行点的方法是本机方法，则返回true。
String	toString() 返回此堆栈跟踪元素的字符串表示形式。

Methods inherited from class 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为空

从以下版本开始：

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()

返回包含由该堆栈跟踪元素表示的执行点的类的完全限定名称。

结果

所述的全限定名 类包含由该堆栈跟踪元素所表示的执行点。

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与该实例相同的执行点的StackTraceElement实例，则返回true。 当且仅当以下情况下，两个堆栈跟踪元素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与此实例相同的执行点的 StackTraceElement实例，则为true。

另请参见：

Object.hashCode() ， HashMap

hashCode

public int hashCode()

返回此堆栈跟踪元素的哈希码值。

重写：

hashCode在 Object

结果

该对象的哈希码值。

另请参见：

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