throwable.html

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

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将此 throwable 的 <i>cause</i> 初始化为指定值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Throwable.html#printStackTrace()">printStackTrace</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将此 throwable 及其追踪输出至标准错误流。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Throwable.html#printStackTrace(java.io.PrintStream)">printStackTrace</A></B>(java.io.PrintStream&nbsp;s)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将此 throwable 及其追踪输出到指定的输出流。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Throwable.html#printStackTrace(java.io.PrintWriter)">printStackTrace</A></B>(java.io.PrintWriter&nbsp;s)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将此 throwable 及其追踪输出到指定的 PrintWriter。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Throwable.html#setStackTrace(java.lang.StackTraceElement[])">setStackTrace</A></B>(<A HREF="StackTraceElement.html" title="java.lang 中的类">StackTraceElement</A>[]&nbsp;stackTrace)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;设置将由 <A HREF="Throwable.html#getStackTrace()"><CODE>getStackTrace()</CODE></A> 返回，并由 <A HREF="Throwable.html#printStackTrace()"><CODE>printStackTrace()</CODE></A> 和相关方法输出的堆栈跟踪元素。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="String.html" title="java.lang 中的类">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="Throwable.html#toString()">toString</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;返回此 throwable 的简短描述。</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>从类 java.lang.<A HREF="Object.html" title="java.lang 中的类">Object</A> 继承的方法</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="Object.html#clone()">clone</A>, <A HREF="Object.html#equals(java.lang.Object)">equals</A>, <A HREF="Object.html#finalize()">finalize</A>, <A HREF="Object.html#getClass()">getClass</A>, <A HREF="Object.html#hashCode()">hashCode</A>, <A HREF="Object.html#notify()">notify</A>, <A HREF="Object.html#notifyAll()">notifyAll</A>, <A HREF="Object.html#wait()">wait</A>, <A HREF="Object.html#wait(long)">wait</A>, <A HREF="Object.html#wait(long, int)">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_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="Throwable()"><!-- --></A><H3>
Throwable</H3>
<PRE>
public <B>Throwable</B>()</PRE>
<DL>
<DD>构造一个将 <code>null</code> 作为其详细消息的新 throwable。Cause 尚未进行初始化，可在以后通过调用 <A HREF="Throwable.html#initCause(java.lang.Throwable)"><CODE>initCause(java.lang.Throwable)</CODE></A> 来初始化。

<p>调用 <A HREF="Throwable.html#fillInStackTrace()"><CODE>fillInStackTrace()</CODE></A> 方法来初始化新创建的 throwable 中的堆栈跟踪数据。
<P>
</DL>
<HR>

<A NAME="Throwable(java.lang.String)"><!-- --></A><H3>
Throwable</H3>
<PRE>
public <B>Throwable</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;message)</PRE>
<DL>
<DD>构造带指定详细消息的新 throwable。Cause 尚未进行初始化，可在以后通过调用 <A HREF="Throwable.html#initCause(java.lang.Throwable)"><CODE>initCause(java.lang.Throwable)</CODE></A> 来初始化。

<p>调用 <A HREF="Throwable.html#fillInStackTrace()"><CODE>fillInStackTrace()</CODE></A> 方法来初始化新创建的 throwable 中的堆栈跟踪数据。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>message</CODE> - 详细消息。保存这个详细消息，以便以后通过 <A HREF="Throwable.html#getMessage()"><CODE>getMessage()</CODE></A> 方法对其进行检索。</DL>
</DL>
<HR>

<A NAME="Throwable(java.lang.String, java.lang.Throwable)"><!-- --></A><H3>
Throwable</H3>
<PRE>
public <B>Throwable</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;message,
                 <A HREF="Throwable.html" title="java.lang 中的类">Throwable</A>&nbsp;cause)</PRE>
<DL>
<DD>构造一个带指定详细消息和 cause 的新 throwable。<p>注意，与 <code>cause</code> 相关的详细消息<i>不会</i> 被自动合并到此 throwable 的详细消息中的。

<p>调用 <A HREF="Throwable.html#fillInStackTrace()"><CODE>fillInStackTrace()</CODE></A> 方法来初始化新创建的 throwable 中的堆栈跟踪数据。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>message</CODE> - 详细消息（保存此消息，以便以后通过 <A HREF="Throwable.html#getMessage()"><CODE>getMessage()</CODE></A> 方法检索它）。<DD><CODE>cause</CODE> - 原因（保存此 cause，以便以后通过 <A HREF="Throwable.html#getCause()"><CODE>getCause()</CODE></A> 方法检索它）。（允许 <tt>null</tt> 值，指出 cause 是不存在的或是未知的。）<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DL>
<HR>

<A NAME="Throwable(java.lang.Throwable)"><!-- --></A><H3>
Throwable</H3>
<PRE>
public <B>Throwable</B>(<A HREF="Throwable.html" title="java.lang 中的类">Throwable</A>&nbsp;cause)</PRE>
<DL>
<DD>构造一个带指定 cause 和 <tt>(cause==null &#063; null :cause.toString())</tt>（它通常包含类和 <tt>cause</tt> 的详细消息）的详细消息的新 throwable。此构造方法对于那些与其他 throwable（例如，<CODE>PrivilegedActionException</CODE>）的包装器相同的 throwable 来说是有用的。

<p>调用 <A HREF="Throwable.html#fillInStackTrace()"><CODE>fillInStackTrace()</CODE></A> 方法来初始化新创建的 throwable 中的堆栈跟踪数据。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>cause</CODE> - 原因（保存此 cause，以便以后通过 <A HREF="Throwable.html#getCause()"><CODE>getCause()</CODE></A> 方法检索它）。（允许 <tt>null</tt> 值，指出 cause 是不存在的或是未知的。）<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</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="getMessage()"><!-- --></A><H3>
getMessage</H3>
<PRE>
public <A HREF="String.html" title="java.lang 中的类">String</A> <B>getMessage</B>()</PRE>
<DL>
<DD>返回此 throwable 的详细消息字符串。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此 <tt>Throwable</tt> 实例的详细消息字符串（可以为 <tt>null</tt>）。</DL>
</DD>
</DL>
<HR>

<A NAME="getLocalizedMessage()"><!-- --></A><H3>
getLocalizedMessage</H3>
<PRE>
public <A HREF="String.html" title="java.lang 中的类">String</A> <B>getLocalizedMessage</B>()</PRE>
<DL>
<DD>创建此 throwable 的本地化描述。子类可以重写此方法，以便生成特定于语言环境的消息。对于不重写此方法的子类，默认实现返回与 <code>getMessage()</code> 相同的结果。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此 throwable 的本地化描述。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getCause()"><!-- --></A><H3>
getCause</H3>
<PRE>
public <A HREF="Throwable.html" title="java.lang 中的类">Throwable</A> <B>getCause</B>()</PRE>
<DL>
<DD>返回此 throwable 的 cause；或者如果 cause 不存在或未知，则返回 <code>null</code>。（该 Cause 是导致抛出此 throwable 的throwable。）

<p>此实现返回由一个需要 <tt>Throwable</tt> 的构造方法提供的 cause，或者在创建之后通过 <A HREF="Throwable.html#initCause(java.lang.Throwable)"><CODE>initCause(Throwable)</CODE></A> 方法进行设置的 cause。虽然通常不需要重写此方法，但子类可以重写它，以返回一个通过某些其他方式设置的 cause。这适用于在异常链（异常嵌套）机制被加入到 <tt>Throwable</tt> 之前存在&ldquo;遗留 Throwable 链机制&rdquo;的情况。注意，<i>不必</i> 重写任何 <tt>PrintStackTrace</tt> 方法，所有方法都调用 <tt>getCause</tt> 方法来确定 throwable 的 cause。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此 throwable 的 cause，如果 cause 不存在或是未知的，则返回 <code>null</code>。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="initCause(java.lang.Throwable)"><!-- --></A><H3>
initCause</H3>
<PRE>
public <A HREF="Throwable.html" title="java.lang 中的类">Throwable</A> <B>initCause</B>(<A HREF="Throwable.html" title="java.lang 中的类">Throwable</A>&nbsp;cause)</PRE>
<DL>
<DD>将此 throwable 的 <i>cause</i> 初始化为指定值。（该 Cause 是导致抛出此 throwable 的throwable。）

<p>此方法至多可以调用一次。此方法通常从构造方法中调用，或者在创建 throwable 后立即调用。如果此 throwable 通过 <A HREF="Throwable.html#Throwable(java.lang.Throwable)"><CODE>Throwable(Throwable)</CODE></A> 或 <A HREF="Throwable.html#Throwable(java.lang.String, java.lang.Throwable)"><CODE>Throwable(String,Throwable)</CODE></A> 创建，此方法甚至一次也不能调用。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>cause</CODE> - 原因（保存此 cause，以便以后通过 <A HREF="Throwable.html#getCause()"><CODE>getCause()</CODE></A> 方法检索它）。（允许 <tt>null</tt> 值，指出 cause 是不存在的或是未知的。）
<DT><B>返回：</B><DD>对此 <code>Throwable</code> 实例的引用。
<DT><B>抛出：</B>
<DD><CODE><A HREF="IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>cause</code> 是此 throwable。（throwable 不能是它自己的 cause。）
<DD><CODE><A HREF="IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果此 throwable 通过 <A HREF="Throwable.html#Throwable(java.lang.Throwable)"><CODE>Throwable(Throwable)</CODE></A> 或 <A HREF="Throwable.html#Throwable(java.lang.String, java.lang.Throwable)"><CODE>Throwable(String,Throwable)</CODE></A> 创建，或者此方法已经在此 throwable 上进行调用。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</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>返回此 throwable 的简短描述。如果此 <code>Throwable</code> 对象是利用非空详细消息字符串创建的，则结果是三个字符串的串联： 
<ul>
<li>此对象的实际类的名称
<li>&quot;: &quot;（冒号和空格）
<li>此对象的 <A HREF="Throwable.html#getMessage()"><CODE>getMessage()</CODE></A> 方法的结果
</ul>
如果此 <code>Throwable</code> 对象利用 <tt>null</tt> 详细消息字符串创建，则返回此对象的实际类的名称。
<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>该 throwable 的字符串表示形式。</DL>
</DD>
</DL>
<HR>

<A NAME="printStackTrace()"><!-- --></A><H3>
printStackTrace</H3>
<PRE>
public void <B>printStackTrace</B>()</PRE>
<DL>
<DD>将此 throwable 及其追踪输出至标准错误流。此方法将此 <code>Throwable</code> 对象的堆栈跟踪输出至错误输出流，作为字段 <code>System.err</code> 的值。输出的第一行包含此对象的 <A HREF="Throwable.html#toString()"><CODE>toString()</CODE></A> 方法的结果。剩余行表示以前由方法 <A HREF="Throwable.html#fillInStackTrace()"><CODE>fillInStackTrace()</CODE></A> 记录的数据。此信息的格式取决于实现，但以下示例是最常见的：
 <blockquote><pre>
 java.lang.NullPointerException
         at MyClass.mash(MyClass.java:9)