java.lang.StackTraceElement翻译

王朝java/jsp·作者佚名 2006-01-09

宽屏版字体: 小|中|大|超大

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<HTML>

<HEAD>

<TITLE>

StackTraceElement (Java 2 Platform SE v1.4.2)

</TITLE>

function windowTitle()

{

parent.document.title="StackTraceElement (Java 2 Platform SE v1.4.2)";

}

</SCRIPT>

</HEAD>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

<A HREF="../../java/lang/Short.html" title="class in java.lang">PREV CLASS</A>

<A HREF="../../java/lang/StrictMath.html" title="class in java.lang">NEXT CLASS</A></TD>

<A HREF="../../index.html" target="_top">FRAMES</A>

<A HREF="StackTraceElement.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<H2>

java.lang

Class StackTraceElement</H2>

<PRE>

<A HREF="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</A>

<IMG SRC="../../resources/inherit.gif" ALT="extended by">java.lang.StackTraceElement

</PRE>

<DL>

<DT>All Implemented Interfaces: <DD><A HREF="../../java/io/Serializable.html" title="interface in java.io">Serializable</A></DD>

</DL>

<HR>

<DL>

<DT>public final class StackTraceElement<DT>extends <A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A><DT>implements <A HREF="../../java/io/Serializable.html" title="interface in java.io">Serializable</A></DL>

An element in a stack trace, as returned by <A HREF="../../java/lang/Throwable.html#getStackTrace()"><CODE>Throwable.getStackTrace()</CODE></A>. Each element represents a single stack frame.

All stack frames except for the one at the top of the stack represent

a method invocation. The frame at the top of the stack represents the

the execution point at which the stack trace was generated. Typically,

this is the point at which the throwable corresponding to the stack trace

was created.

堆栈跟踪中的元素，通过Throwable.getStackTrace()返回。每个元素表示单一的堆栈帧。除了堆栈最顶端的帧，每个堆栈帧都表示一次方法调用。

堆栈顶部的帧表示堆栈产生的执行点。通常，这是throwable相应堆栈跟踪的创建点。

<DL>

<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../serialized-form.html#java.lang.StackTraceElement">Serialized Form</A></DL>

<HR>

Method Summary</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../java/lang/StackTraceElement.html#equals(java.lang.Object)">equals</A>(<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A> obj)</CODE>

          Returns true if the specified object is another

<tt>StackTraceElement</tt> instance representing the same execution

point as this instance.

如果指定的对象是另一个StackTraceElement实例，同该实例表示相同的执行点，返回true。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/lang/StackTraceElement.html#getClassName()">getClassName</A>()</CODE>

          Returns the fully qualified name of the class containing the

execution point represented by this stack trace element.

返回包含当前堆栈跟踪元素表示的执行点的类的全名。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/lang/StackTraceElement.html#getFileName()">getFileName</A>()</CODE>

          Returns the name of the source file containing the execution point

represented by this stack trace element.

返回包含当前堆栈跟踪元素表示的执行点的源文件名。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/StackTraceElement.html#getLineNumber()">getLineNumber</A>()</CODE>

          Returns the line number of the source line containing the execution

point represented by this stack trace element.

返回包含当前堆栈跟踪元素表示的执行点的源代码行号。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/lang/StackTraceElement.html#getMethodName()">getMethodName</A>()</CODE>

          Returns the name of the method containing the execution point

represented by this stack trace element.

返回包含当前堆栈跟踪元素表示的执行点的方法名。</TD>

</TR>

<TD><CODE><A HREF="../../java/lang/StackTraceElement.html#hashCode()">hashCode</A>()</CODE>

          Returns a hash code value for this stack trace element.

返回当前堆栈跟踪元素的hash码值。</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../java/lang/StackTraceElement.html#isNativeMethod()">isNativeMethod</A>()</CODE>

          Returns true if the method containing the execution point

represented by this stack trace element is a native method.

如果包含当前堆栈跟踪元素表示的执行点的方法是一个本地方法，返回true。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/lang/StackTraceElement.html#toString()">toString</A>()</CODE>

          Returns a string representation of this stack trace element.

返回当前堆栈跟踪元素的字符串形式。</TD>

</TR>

</TABLE>

<TD>Methods inherited from class java.lang.<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></TD>

</TR>

<TD><CODE><A HREF="../../java/lang/Object.html#clone()">clone</A>, <A HREF="../../java/lang/Object.html#finalize()">finalize</A>, <A HREF="../../java/lang/Object.html#getClass()">getClass</A>, <A HREF="../../java/lang/Object.html#notify()">notify</A>, <A HREF="../../java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../java/lang/Object.html#wait()">wait</A>, <A HREF="../../java/lang/Object.html#wait(long)">wait</A>, <A HREF="../../java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>

</TR>

</TABLE>

Method Detail</TD>

</TR>

</TABLE>

getFileName</H3>

<PRE>

public <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> getFileName()</PRE>

<DL>

<DD>Returns the name of the source file containing the execution point

represented by this stack trace element. Generally, this corresponds

to the <tt>SourceFile</tt> attribute of the relevant <tt>class</tt>

file (as per The Java Virtual Machine Specification, Section

4.7.7). In some systems, the name may refer to some source code unit

other than a file, such as an entry in source repository.

返回包含当前堆栈跟踪元素表示的执行点的源文件名。通常，相当于相关class文件

（JVM规范，4.7.7节）SourceFile属性。的在某些系统中，该名称可能指向一些源代码单元而不是文件，比如源码仓库中的某项。

</DL>

</DD>

<DT>Returns:<DD>the name of the file containing the execution point

represented by this stack trace element, or <tt>null</tt> if

this information is unavailable.

包含当前堆栈跟踪元素表示的执行点的源文件名，如果信息不可用，返回null。</DL>

</DD>

</DL>

<HR>

getLineNumber</H3>

<PRE>

public int getLineNumber()</PRE>

<DL>

<DD>Returns the line number of the source line containing the execution

point represented by this stack trace element. Generally, this is

derived from the <tt>LineNumberTable</tt> attribute of the relevant

<tt>class</tt> file (as per The Java Virtual Machine

Specification, Section 4.7.8).

返回包含当前堆栈跟踪元素表示的执行点的源代码行号。通常，由关class文件

（JVM规范，4.7.8节）LineNumberTable属性取得。

</DL>

</DD>

<DT>Returns:<DD>the line number of the source line containing the execution

point represented by this stack trace element, or a negative

number if this information is unavailable.

包含当前堆栈跟踪元素表示的执行点的源代码行号，如果信息不可用，返回负数。</DL>

</DD>

</DL>

<HR>

getClassName</H3>

<PRE>

public <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> getClassName()</PRE>

<DL>

<DD>Returns the fully qualified name of the class containing the

execution point represented by this stack trace element.

返回包含当前堆栈跟踪元素表示的执行点的类的全名。

</DL>

</DD>

<DT>Returns:<DD>the fully qualified name of the <tt>Class</tt> containing

the execution point represented by this stack trace element.

包含当前堆栈跟踪元素表示的执行点的类的全名。</DL>

</DD>

</DL>

<HR>

getMethodName</H3>

<PRE>

public <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> getMethodName()</PRE>

<DL>

<DD>Returns the name of the method containing the execution point

represented by this stack trace element. If the execution point is

contained in an instance or class initializer, this method will return

the appropriate special method name, <tt><init></tt> or

<tt><clinit></tt>, as per Section 3.9 of The Java Virtual

Machine Specification.

返回包含当前堆栈跟踪元素表示的执行点的方法名。如果执行点包含在实例或类初始化器中，

该方法根据JVM规范3.9节返回合适的特定方法名。

</DL>

</DD>

<DT>Returns:<DD>the name of the method containing the execution point

represented by this stack trace element.

包含当前堆栈跟踪元素表示的执行点的方法名。</DL>

</DD>

</DL>

<HR>

isNativeMethod</H3>

<PRE>

public boolean isNativeMethod()</PRE>

<DL>

<DD>Returns true if the method containing the execution point

represented by this stack trace element is a native method.

如果包含当前堆栈跟踪元素表示的执行点的方法是一个本地方法，返回true。

</DL>

</DD>

<DT>Returns:<DD><tt>true</tt> if the method containing the execution point

represented by this stack trace element is a native method.

如果包含当前堆栈跟踪元素表示的执行点的方法是一个本地方法，返回true。</DL>

</DD>

</DL>

<HR>

toString</H3>

<PRE>

public <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> toString()</PRE>

<DL>

<DD>Returns a string representation of this stack trace element. The

format of this string depends on the implementation, but the following

examples may be regarded as typical:

返回当前堆栈跟踪元素的字符串形式。字符串的格式依赖于实现，但是通常以以下实例为准：

<ul>

<li>

<tt>"MyClass.mash(MyClass.java:9)"</tt> - Here, <tt>"MyClass"</tt>

is the fully-qualified name of the class containing the

execution point represented by this stack trace element,

<tt>"mash"</tt> is the name of the method containing the execution

point, <tt>"MyClass.java"</tt> is the source file containing the

execution point, and <tt>"9"</tt> is the line number of the source

line containing the execution point.

这里，“MyClass”是包含当前堆栈跟踪元素表示的执行点的类的全名，“mash”

是包含执行点的方法名，“MyClass.java”是包含执行点的源文件，“9”是包含执行点的源代码行号。

<li>

<tt>"MyClass.mash(MyClass.java)"</tt> - As above, but the line

number is unavailable.

同以上，但行号不可用。

<li>

<tt>"MyClass.mash(Unknown Source)"</tt> - As above, but neither

the file name nor the line number are available.

同以上，但文件名和行号均不可用。

<li>

<tt>"MyClass.mash(Native Method)"</tt> - As above, but neither

the file name nor the line number are available, and the method

containing the execution point is known to be a native method.

同以上，但文件名和行号均不可用，包含执行点的方法是本地方法。。

</ul>

<DT>Overrides:<DD><CODE><A HREF="../../java/lang/Object.html#toString()">toString</A></CODE> in class <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DL>

</DD>

<DT>Returns:<DD>a string representation of the object.<DT>See Also:<DD><A HREF="../../java/lang/Throwable.html#printStackTrace()"><CODE>Throwable.printStackTrace()</CODE></A></DL>

</DD>

</DL>

<HR>

equals</H3>

<PRE>

public boolean equals(<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A> obj)</PRE>

<DL>

<DD>Returns true if the specified object is another

<tt>StackTraceElement</tt> instance representing the same execution

point as this instance. Two stack trace elements <tt>a</tt> and

<tt>b</tt> are equal if and only if:

如果指定的对象是另一个StackTraceElement实例，同该实例表示相同的执行点，返回true。

只有当两个堆栈跟踪元素a和b满足以下条件时认为相等：

<pre>

equals(a.getFileName(), b.getFileName()) &&

a.getLineNumber() == b.getLineNumber()) &&

equals(a.getClassName(), b.getClassName()) &&

equals(a.getMethodName(), b.getMethodName())

</pre>

where <tt>equals</tt> is defined as:

此处，equals定义为：

<pre>

static boolean equals(Object a, Object b) {

return a==b || (a != null && a.equals(b));

}

</pre>

<DT>Overrides:<DD><CODE><A HREF="../../java/lang/Object.html#equals(java.lang.Object)">equals</A></CODE> in class <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DL>

</DD>

<DT>Parameters:<DD><CODE>obj</CODE> - the object to be compared with this stack trace element. 要同当前堆栈跟踪元素比较的对象。

<DT>Returns:<DD>true if the specified object is another

<tt>StackTraceElement</tt> instance representing the same

execution point as this instance.

如果指定的对象是另一个StackTraceElement实例，同该实例表示相同的执行点，返回true。<DT>See Also:<DD><A HREF="../../java/lang/Object.html#hashCode()"><CODE>Object.hashCode()</CODE></A>,

<A HREF="../../java/util/Hashtable.html" title="class in java.util"><CODE>Hashtable</CODE></A></DL>

</DD>

</DL>

<HR>

hashCode</H3>

<PRE>

public int hashCode()</PRE>

<DL>

<DD>Returns a hash code value for this stack trace element.

返回当前堆栈跟踪元素的hash码值。

<DT>Overrides:<DD><CODE><A HREF="../../java/lang/Object.html#hashCode()">hashCode</A></CODE> in class <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DL>

</DD>

<DT>Returns:<DD>a hash code value for this object.

当前堆栈跟踪元素的hash码值。<DT>See Also:<DD><A HREF="../../java/lang/Object.html#equals(java.lang.Object)"><CODE>Object.equals(java.lang.Object)</CODE></A>,

<A HREF="../../java/util/Hashtable.html" title="class in java.util"><CODE>Hashtable</CODE></A></DL>

</DD>

</DL>

<HR>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

<A HREF="../../java/lang/Short.html" title="class in java.lang">PREV CLASS</A>

<A HREF="../../java/lang/StrictMath.html" title="class in java.lang">NEXT CLASS</A></TD>

<A HREF="../../index.html" target="_top">FRAMES</A>

<A HREF="StackTraceElement.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a> For further API reference and developer documentation, see <a href="../../../relnotes/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to <a href="../../../relnotes/license.html">license terms</a>. Also see the <a href="http://java.sun.com/docs/redist.html">documentation redistribution policy</a>.

</BODY>

</HTML>