object.html

j2se5-api-zh,java文档的中文版本

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;导致当前的线程等待，直到其他线程调用此对象的 <A HREF="Object.html#notify()"><CODE>notify()</CODE></A> 方法或 <A HREF="Object.html#notifyAll()"><CODE>notifyAll()</CODE></A> 方法，或者超过指定的时间量。</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="Object.html#wait(long, int)">wait</A></B>(long&nbsp;timeout,
     int&nbsp;nanos)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;导致当前的线程等待，直到其他线程调用此对象的 <A HREF="Object.html#notify()"><CODE>notify()</CODE></A> 方法或 <A HREF="Object.html#notifyAll()"><CODE>notifyAll()</CODE></A> 方法，或者其他某个线程中断当前线程，或者已超过某个实际时间量。</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="Object()"><!-- --></A><H3>
Object</H3>
<PRE>
public <B>Object</B>()</PRE>
<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="getClass()"><!-- --></A><H3>
getClass</H3>
<PRE>
public final <A HREF="Class.html" title="java.lang 中的类">Class</A>&lt;? extends <A HREF="Object.html" title="java.lang 中的类">Object</A>&gt; <B>getClass</B>()</PRE>
<DL>
<DD>返回一个对象的运行时类。该 <tt>Class</tt> 对象是由所表示类的 <tt>static synchronized</tt> 方法锁定的对象。
<P>
<DD><DL>

<DT><B>返回：</B><DD>表示该对象的运行时类的 <code>java.lang.Class</code> 对象。此结果属于类型 <code>Class&lt;? extends X&gt;</code>，其中 X 表示清除表达式中的静态类型，该表达式调用 <code>getClass</code>。</DL>
</DD>
</DL>
<HR>

<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
public int <B>hashCode</B>()</PRE>
<DL>
<DD>返回该对象的哈希代码值。支持该方法是为哈希表提供一些优点，例如，<code>java.util.Hashtable</code> 提供的哈希表。 
 <p>
<code>hashCode</code> 的常规协定是： 
 <ul>
<li>在 Java 应用程序执行期间，在同一对象上多次调用 <tt>hashCode</tt> 方法时，必须一致地返回相同的整数，前提是对象上 <tt>equals</tt> 比较中所用的信息没有被修改。从某一应用程序的一次执行到同一应用程序的另一次执行，该整数无需保持一致。 
<li>如果根据 <tt>equals(Object)</tt> 方法，两个对象是相等的，那么在两个对象中的每个对象上调用 <code>hashCode</code> 方法都必须生成相同的整数结果。 
<li>以下情况<em>不</em> 是必需的：如果根据 <A HREF="Object.html#equals(java.lang.Object)"><CODE>equals(java.lang.Object)</CODE></A> 方法，两个对象不相等，那么在两个对象中的任一对象上调用 <tt>hashCode</tt> 方法必定会生成不同的整数结果。但是，程序员应该知道，为不相等的对象生成不同整数结果可以提高哈希表的性能。
 </ul>
 <p>
实际上，由 <tt>Object</tt> 类定义的 hashCode 方法确实会针对不同的对象返回不同的整数。（这一般是通过将该对象的内部地址转换成一个整数来实现的，但是 Java<font size="-2"><sup>TM</sup></font> 编程语言不需要这种实现技巧。）
<P>
<DD><DL>

<DT><B>返回：</B><DD>此对象的一个哈希代码值。<DT><B>另请参见：</B><DD><A HREF="Object.html#equals(java.lang.Object)"><CODE>equals(java.lang.Object)</CODE></A>, 
<A HREF="../util/Hashtable.html" title="java.util 中的类"><CODE>Hashtable</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>指示某个其他对象是否与此对象“相等”。
 <p>
<code>equals</code> 方法在非空对象引用上实现相等关系：
 <ul>
<li><i>自反性</i>：对于任何非空引用值 <code>x</code>，<code>x.equals(x)</code> 都应返回 <code>true</code>。
<li><i>对称性</i>：对于任何非空引用值 <code>x</code> 和 <code>y</code>，当且仅当 <code>y.equals(x)</code> 返回 <code>true</code> 时，<code>x.equals(y)</code> 才应返回 <code>true</code>。
<li><i>传递性</i>：对于任何非空引用值 <code>x</code>、<code>y</code> 和 <code>z</code>，如果 <code>x.equals(y)</code> 返回 <code>true</code>，并且 <code>y.equals(z)</code> 返回 <code>true</code>，那么 <code>x.equals(z)</code> 应返回 <code>true</code>。
<li><i>一致性</i>：对于任何非空引用值 <code>x</code> 和 <code>y</code>，多次调用 <tt>x.equals(y)</tt> 始终返回 <code>true</code> 或始终返回 <code>false</code>，前提是对象上 <code>equals</code> 比较中所用的信息没有被修改。
<li>对于任何非空引用值 <code>x</code>，<code>x.equals(null)</code> 都应返回 <code>false</code>。
 </ul>
 <p>
<code>Object</code> 类的 <tt>equals</tt> 方法实现对象上差别可能性最大的相等关系；即，对于任何非空引用值 <code>x</code> 和 <code>y</code>，当且仅当 <code>x</code> 和 <code>y</code> 引用同一个对象时，此方法才返回 <code>true</code>（<code>x == y</code> 具有值 <code>true</code>）。
 <p>
注意：当此方法被重写时，通常有必要重写 <tt>hashCode</tt> 方法，以维护 <tt>hashCode</tt> 方法的常规协定，该协定声明相等对象必须具有相等的哈希代码。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 要与之比较的引用对象。
<DT><B>返回：</B><DD>如果此对象与 obj 参数相同，则返回 <code>true</code>；否则返回 <code>false</code>。<DT><B>另请参见：</B><DD><A HREF="Object.html#hashCode()"><CODE>hashCode()</CODE></A>, 
<A HREF="../util/Hashtable.html" title="java.util 中的类"><CODE>Hashtable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="clone()"><!-- --></A><H3>
clone</H3>
<PRE>
protected <A HREF="Object.html" title="java.lang 中的类">Object</A> <B>clone</B>()
                throws <A HREF="CloneNotSupportedException.html" title="java.lang 中的类">CloneNotSupportedException</A></PRE>
<DL>
<DD>创建并返回此对象的一个副本。“副本”的准确含义可能依赖于对象的类。一般来说，对于任何对象 <tt>x</tt>，如果表达式：
 <blockquote>
 <pre>
x.clone() != x</pre></blockquote>
是正确的，则表达式：
 <blockquote>
 <pre>
x.clone().getClass() == x.getClass()</pre></blockquote>
将为 <tt>true</tt>，但这些不是绝对条件。一般情况下是：
 <blockquote>
 <pre>
x.clone().equals(x)</pre></blockquote>
将为 <tt>true</tt>，但这不是绝对条件。 
 <p>
按照惯例，返回的对象应该通过调用 <tt>super.clone</tt> 获得。如果一个类及其所有的超类（<tt>Object</tt> 除外）都遵守此约定，则 <tt>x.clone().getClass() == x.getClass()</tt>。
 <p>
按照惯例，此方法返回的对象应该独立于该对象（正被克隆的对象）。要获得此独立性，在 <tt>super.clone</tt> 返回对象之前，有必要对该对象的一个或多个字段进行修改。这通常意味着要复制包含正在被克隆对象的内部“深层结构”的所有可变对象，并使用对副本的引用替换对这些对象的引用。如果一个类只包含基本字段或对不变对象的引用，那么通常不需要修改 <tt>super.clone</tt> 返回的对象中的字段。
 <p>
<tt>Object</tt> 类的 <tt>clone</tt> 方法执行特定的克隆操作。首先，如果此对象的类不能实现接口 <tt>Cloneable</tt>，则会抛出 <tt>CloneNotSupportedException</tt>。注意：所有的数组都被视为实现接口 <tt>Cloneable</tt>。否则，此方法会创建此对象的类的一个新实例，并像通过分配那样，严格使用此对象相应字段的内容初始化该对象的所有字段；这些字段的内容没有被自我克隆。所以，此方法执行的是该对象的“浅表复制”，而不“深层复制”操作。
 <p>
<tt>Object</tt> 类本身不实现接口 <tt>Cloneable</tt>，所以在类为 <tt>Object</tt> 的对象上调用 <tt>clone</tt> 方法将会导致在运行时抛出异常。
<P>
<DD><DL>

<DT><B>返回：</B><DD>此实例的一个克隆。
<DT><B>抛出：</B>
<DD><CODE><A HREF="CloneNotSupportedException.html" title="java.lang 中的类">CloneNotSupportedException</A></CODE> - 如果对象的类不支持 <code>Cloneable</code> 接口，则重写 <code>clone</code> 方法的子类也会抛出此异常，以指示无法克隆某个实例。<DT><B>另请参见：</B><DD><A HREF="Cloneable.html" title="java.lang 中的接口"><CODE>Cloneable</CODE></A></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>返回该对象的字符串表示。通常，<code>toString</code> 方法会返回一个“以文本方式表示”此对象的字符串。结果应是一个简明但易于读懂。建议所有子类都重写此方法。
 <p>
<code>Object</code> 类的 <code>toString</code> 方法返回一个字符串，该字符串由类名（对象是该类的一个实例）、at 标记符&ldquo;<code>@</code>&rdquo;和此对象哈希代码的无符号十六进制表示组成。换句话说，该方法返回一个字符串，它的值等于：
 <blockquote>
 <pre>
getClass().getName() + '@' + Integer.toHexString(hashCode())
 </pre></blockquote>
<P>
<DD><DL>

<DT><B>返回：</B><DD>该对象的字符串表示形式。</DL>
</DD>
</DL>
<HR>

<A NAME="notify()"><!-- --></A><H3>
notify</H3>
<PRE>
public final void <B>notify</B>()</PRE>
<DL>
<DD>唤醒在此对象监视器上等待的单个线程。如果所有线程都在此对象上等待，则会选择唤醒其中一个线程。选择是任意性的，并在对实现做出决定时发生。线程通过调用其中一个 <code>wait</code> 方法，在对象的监视器上等待。
 <p>
直到当前的线程放弃此对象上的锁定，才能继续执行被唤醒的线程。被唤醒的线程将以常规方式与在该对象上主动同步的其他所有线程进行竞争；例如，唤醒的线程在作为锁定此对象的下一个线程方面没有可靠的特权或劣势。
 <p>
此方法只应由作为此对象监视器的所有者的线程来调用。通过以下三种方法之一，线程可以成为此对象监视器的所有者： 
 <ul>
<li>通过执行此对象的同步 (Sychronized) 实例方法。 
<li>通过执行在此对象上进行同步的 <code>synchronized</code> 语句的正文。 
<li>对于 <code>Class</code> 类型的对象，可以通过执行该类的同步静态方法。 
 </ul>
 <p>
一次只能有一个线程拥有对象的监视器。
<P>
<DD><DL>

<DT><B>抛出：</B>
<DD><CODE><A HREF="IllegalMonitorStateException.html" title="java.lang 中的类">IllegalMonitorStateException</A></CODE> - 如果当前的线程不是此对象监视器的所有者。<DT><B>另请参见：</B><DD><A HREF="Object.html#notifyAll()"><CODE>notifyAll()</CODE></A>, 
<A HREF="Object.html#wait()"><CODE>wait()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="notifyAll()"><!-- --></A><H3>
notifyAll</H3>
<PRE>
public final void <B>notifyAll</B>()</PRE>
<DL>
<DD>唤醒在此对象监视器上等待的所有线程。线程通过调用其中一个 <code>wait</code> 方法，在对象的监视器上等待。
 <p>
直到当前的线程放弃此对象上的锁定，才能继续执行被唤醒的线程。被唤醒的线程将以常规方式与在该对象上主动同步的其他所有线程进行竞争；例如，唤醒的线程在作为锁定此对象的下一个线程方面没有可靠的特权或劣势。
 <p>
此方法只应由作为此对象监视器的所有者的线程来调用。请参阅 <code>notify</code> 方法，了解线程能够成为监视器所有者的方法的描述。
<P>
<DD><DL>

<DT><B>抛出：</B>
<DD><CODE><A HREF="IllegalMonitorStateException.html" title="java.lang 中的类">IllegalMonitorStateException</A></CODE> - 如果当前的线程不是此对象监视器的所有者。<DT><B>另请参见：</B><DD><A HREF="Object.html#notify()"><CODE>notify()</CODE></A>, 
<A HREF="Object.html#wait()"><CODE>wait()</CODE></A></DL>
</DD>
</DL>
<HR>