stacktraceelement.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 481 行 · 第 1/2 页

<DT><B>参数：</B><DD><CODE>declaringClass</CODE> - 类的完全限定名，该类包含由堆栈跟踪元素所表示的执行点<DD><CODE>methodName</CODE> - 方法名，该方法包含由堆栈跟踪元素所表示的执行点<DD><CODE>fileName</CODE> - 文件名，该文件包含由堆栈跟踪元素所表示的执行点；如果该信息不可用，则该参数为 <tt>null</tt><DD><CODE>lineNumber</CODE> - 源代码行的行号，该代码行包含由堆栈跟踪元素所表示的执行点；如果此信息不可用，则该参数为负数。值 -2 表示包含执行点的方法是一个本机方法
<DT><B>抛出：</B>
<DD><CODE><A HREF="NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <tt>declaringClass</tt> 或 <tt>methodName</tt> 为 null<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="getFileName()"><!-- --></A><H3>
getFileName</H3>
<PRE>
public <A HREF="String.html" title="java.lang 中的类">String</A> <B>getFileName</B>()</PRE>
<DL>
<DD>返回源文件名，该文件包含由该堆栈跟踪元素所表示的执行点。通常，这对应于相关 <tt>class</tt> 文件的 <tt>SourceFile</tt> 属性（根据《<i>The Java Virtual Machine Specification</i>》中的第 4.7.7 节）。在某些系统中，该名称可能指的是源代码单元而不是某个文件，如源存储库中的某个项。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>文件名，该文件包含由该堆栈跟踪元素所表示的执行点；如果该信息不可用，则返回 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="getLineNumber()"><!-- --></A><H3>
getLineNumber</H3>
<PRE>
public int <B>getLineNumber</B>()</PRE>
<DL>
<DD>返回源行的行号，该行包含由该堆栈该跟踪元素所表示的执行点。通常，该方法派生自相关 <tt>class</tt> 文件的 <tt>LineNumberTable</tt> 属性（根据《<i>The Java Virtual Machine Specification</i>》中的第 4.7.8 小节）。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>源代码行的行号，该代码行包含由该堆栈跟踪元素所表示的执行点；如果该信息不可用，则返回负数。</DL>
</DD>
</DL>
<HR>

<A NAME="getClassName()"><!-- --></A><H3>
getClassName</H3>
<PRE>
public <A HREF="String.html" title="java.lang 中的类">String</A> <B>getClassName</B>()</PRE>
<DL>
<DD>返回类的完全限定名，该类包含由该堆栈跟踪元素所表示的执行点。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD><tt>Class</tt> 的完全限定名，该类包含由该堆栈跟踪元素所表示的执行点。</DL>
</DD>
</DL>
<HR>

<A NAME="getMethodName()"><!-- --></A><H3>
getMethodName</H3>
<PRE>
public <A HREF="String.html" title="java.lang 中的类">String</A> <B>getMethodName</B>()</PRE>
<DL>
<DD>返回方法名，此方法包含由该堆栈跟踪元素所表示的执行点。如果执行点包含在某个实例或类初始化程序中，则此方法将返回适当的<i>特殊方法名</i>：<tt>&lt;init&gt;</tt> 或 <tt>&lt;clinit&gt;</tt>（根据《<i>The Java Virtual Machine Specification</i>》中的第 3.9 小节）。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>方法名，该方法包含由该堆栈跟踪元素所表示的执行点。</DL>
</DD>
</DL>
<HR>

<A NAME="isNativeMethod()"><!-- --></A><H3>
isNativeMethod</H3>
<PRE>
public boolean <B>isNativeMethod</B>()</PRE>
<DL>
<DD>如果包含由该堆栈跟踪元素所表示的执行点的方法是一个本机方法，则返回 true。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>如果包含由该堆栈跟踪元素所表示的执行点的方法是一个本机方法，则返回 <tt>true</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
public <A HREF="String.html" title="java.lang 中的类">String</A> <B>toString</B>()</PRE>
<DL>
<DD>返回表示该堆栈跟踪元素的字符串。该字符串的格式取决于实现，但是可将以下示例格式视为典型的格式：
 <ul>
 <li>
<tt>&quot;MyClass.mash(MyClass.java:9)&quot;</tt> - 其中，<tt>&quot;MyClass&quot;</tt> 是类的<i>完全限定名</i>，该类包含由该堆栈跟踪元素所表示的执行点；<tt>&quot;mash&quot;</tt> 是包含执行点的方法的名字；<tt>&quot;MyClass.java&quot;</tt> 是包含执行点的源文件；<tt>&quot;9&quot;</tt> 是包含执行点的源行的行号。
 <li>
<tt>&quot;MyClass.mash(MyClass.java)&quot;</tt> - 同上，但是行号不可用。
 <li>
<tt>&quot;MyClass.mash(Unknown Source)&quot;</tt> - 同上，但是文件名和行号都不可用。
 <li>
<tt>&quot;MyClass.mash(Native Method)&quot;</tt> - 同上，但是文件名和行号都不可用，并且已知包含执行点的方法是本机方法。
 </ul>
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="Object.html#toString()">toString</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>该对象的字符串表示形式。<DT><B>另请参见：</B><DD><A HREF="Throwable.html#printStackTrace()"><CODE>Throwable.printStackTrace()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
public boolean <B>equals</B>(<A HREF="Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)</PRE>
<DL>
<DD>如果指定的对象是另一个 <tt>StackTraceElement</tt> 实例，并且该对象表示的执行点与该实例的相同，则返回 ture。当且仅当满足下列条件时，堆栈跟踪元素 <tt>a</tt> 和 <tt>b</tt> 相同：
 <pre>
     equals(a.getFileName(), b.getFileName()) &&
     a.getLineNumber() == b.getLineNumber()) &&
     equals(a.getClassName(), b.getClassName()) &&
     equals(a.getMethodName(), b.getMethodName())
 </pre>
其中定义 <tt>equals</tt> 为：
 <pre>
     static boolean equals(Object a, Object b) {
         return a==b || (a != null &amp;&amp; a.equals(b));
     }
 </pre>
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="Object.html#equals(java.lang.Object)">equals</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 要与该堆栈跟踪元素相比较的对象。
<DT><B>返回：</B><DD>如果指定的对象是另一个 <tt>StackTraceElement</tt> 实例，并且该对象表示的执行点与该实例的相同，则返回 true。<DT><B>另请参见：</B><DD><A HREF="Object.html#hashCode()"><CODE>Object.hashCode()</CODE></A>, 
<A HREF="../util/Hashtable.html" title="java.util 中的类"><CODE>Hashtable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
public int <B>hashCode</B>()</PRE>
<DL>
<DD>返回此堆栈跟踪元素的哈希代码值。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="Object.html#hashCode()">hashCode</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此对象的一个哈希代码值。<DT><B>另请参见：</B><DD><A HREF="Object.html#equals(java.lang.Object)"><CODE>Object.equals(java.lang.Object)</CODE></A>, 
<A HREF="../util/Hashtable.html" title="java.util 中的类"><CODE>Hashtable</CODE></A></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="跳过导航链接"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>类</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/StackTraceElement.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Standard&nbsp;Ed. 5.0</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="StackOverflowError.html" title="java.lang 中的类"><B>上一个类</B></A>&nbsp;
&nbsp;<A HREF="StrictMath.html" title="java.lang 中的类"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../index.html@java_2Flang_2FStackTraceElement.html" target="_top"><B>框架</B></A>  &nbsp;
&nbsp;<A HREF="StackTraceElement.html" target="_top"><B>无框架</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../allclasses-noframe.html"><B>所有类</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../allclasses-noframe.html"><B>所有类</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  摘要：&nbsp;嵌套&nbsp;|&nbsp;字段&nbsp;|&nbsp;<A HREF="#constructor_summary">构造方法</A>&nbsp;|&nbsp;<A HREF="#method_summary">方法</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
详细信息：&nbsp;字段&nbsp;|&nbsp;<A HREF="#constructor_detail">构造方法</A>&nbsp;|&nbsp;<A HREF="#method_detail">方法</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<font size="-1"><a href="../../../../../../../../java.sun.com/cgi-bin/bugreport.cgi">提交错误或意见</a><br>有关更多的 API 参考资料和开发人员文档，请参阅 <a href="../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/devdocs-vs-specs.html">Java 2 SDK SE 开发人员文档</a>。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。 <p>版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守<a href="../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/license.html">许可证条款</a>。另请参阅<a href="../../../../../../../../java.sun.com/docs/redist.html">文档重新分发政策</a>。</font>
</BODY>
</HTML>