timer.html

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

<PRE>
public void <B>schedule</B>(<A HREF="TimerTask.html" title="java.util 中的类">TimerTask</A>&nbsp;task,
                     long&nbsp;delay,
                     long&nbsp;period)</PRE>
<DL>
<DD>安排在指定的延迟后开始对指定的任务进行<i>固定延迟执行</i> 操作。后续执行将以基本固定的时间间隔（由指定的周期分隔）发生。

<p>在固定延迟执行中，根据前一次执行的实际执行时间来安排每次执行。如果由于任何原因（如垃圾回收或其他后台活动）而延迟了某次执行，则后续执行也将被延迟。从长期来看，执行的频率一般要稍慢于指定周期的倒数（假定 <tt>Object.wait(long)</tt> 所依靠的系统时钟是准确的）。

<p>固定延迟执行适用于那些需要“平稳”运行的重复活动。换句话说，它适用于相对于长期运行，在短期运行中保持频率准确将更为重要的活动。这包括大多数动画任务，如以固定时间间隔闪烁的光标。这还包括为响应用户输入所执行的固定活动，如在按住某个按键时将自动重复字符输入。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>task</CODE> - 所要安排的任务。<DD><CODE>delay</CODE> - 执行任务前的延迟时间，单位是毫秒。<DD><CODE>period</CODE> - 任务各后续执行之间的时间间隔，单位是毫秒。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>delay</tt> 是负数，或者 <tt>delay + System.currentTimeMillis()</tt> 是负数。
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经安排或取消了任务，已经取消了计时器，或者计时器线程已终止。</DL>
</DD>
</DL>
<HR>

<A NAME="schedule(java.util.TimerTask, java.util.Date, long)"><!-- --></A><H3>
schedule</H3>
<PRE>
public void <B>schedule</B>(<A HREF="TimerTask.html" title="java.util 中的类">TimerTask</A>&nbsp;task,
                     <A HREF="Date.html" title="java.util 中的类">Date</A>&nbsp;firstTime,
                     long&nbsp;period)</PRE>
<DL>
<DD>安排指定的任务在指定的时间开始进行重复的<i>固定延迟执行</i>。以近似固定的时间间隔（由指定的周期分隔）进行后续执行。

<p>在固定延迟执行中，根据前一次执行的实际执行时间来安排每次执行。如果由于任何原因（如垃圾回收或其他后台活动）而延迟了某次执行，则后续执行也将被延迟。在长期运行中，执行的频率一般要稍慢于指定周期的倒数（假定 <tt>Object.wait(long)</tt> 所依靠的系统时钟是准确的）。

<p>固定延迟执行适用于那些需要“平稳”运行的重复执行活动。换句话说，它适用于在短期运行中保持频率准确要比在长期运行中更为重要的活动。这包括大多数动画任务，如以固定时间间隔闪烁的光标。这还包括为响应人类活动所执行的固定活动，如在按住键时自动重复输入字符。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>task</CODE> - 所要安排的任务。<DD><CODE>firstTime</CODE> - 首次执行任务的时间。<DD><CODE>period</CODE> - 执行各后续任务之间的时间间隔，单位是毫秒。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>time.getTime()</tt> 是负数。
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经安排或取消了任务，已经取消了计时器，或者计时器线程已终止。</DL>
</DD>
</DL>
<HR>

<A NAME="scheduleAtFixedRate(java.util.TimerTask, long, long)"><!-- --></A><H3>
scheduleAtFixedRate</H3>
<PRE>
public void <B>scheduleAtFixedRate</B>(<A HREF="TimerTask.html" title="java.util 中的类">TimerTask</A>&nbsp;task,
                                long&nbsp;delay,
                                long&nbsp;period)</PRE>
<DL>
<DD>安排指定的任务在指定的延迟后开始进行重复的<i>固定速率执行</i>。以近似固定的时间间隔（由指定的周期分隔）进行后续执行。

<p>在固定速率执行中，根据已安排的初始执行时间来安排每次执行。如果由于任何原因（如垃圾回收或其他后台活动）而延迟了某次执行，则将快速连续地出现两次或更多的执行，从而使后续执行能够“追赶上来”。最终，执行的频率将正好是指定周期的倒数（假定 <tt>Object.wait(long)</tt> 所参照的系统时钟是准确的）。

<p>固定速率执行适用于那些对<i>绝对</i> 时间敏感的重复执行活动，如每小时准点打钟报时，或者在每天的特定时间运行已安排的维护活动。它还适用于那些完成固定次数执行的总计时间很重要的重复活动，如倒计时的计时器，每秒钟滴答一次，共 10 秒钟。最后，固定速率执行适用于安排多个重复执行的计时器任务，这些任务相互之间必须保持同步。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>task</CODE> - 所要安排的任务。<DD><CODE>delay</CODE> - 执行任务前的延迟时间，单位是毫秒。<DD><CODE>period</CODE> - 执行各后续任务之间的时间间隔，单位是毫秒。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>delay</tt> 是负数，或者 <tt>delay + System.currentTimeMillis()</tt> 是负数。
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经安排或取消了任务，已经取消了计时器，或者计时器线程已终止。</DL>
</DD>
</DL>
<HR>

<A NAME="scheduleAtFixedRate(java.util.TimerTask, java.util.Date, long)"><!-- --></A><H3>
scheduleAtFixedRate</H3>
<PRE>
public void <B>scheduleAtFixedRate</B>(<A HREF="TimerTask.html" title="java.util 中的类">TimerTask</A>&nbsp;task,
                                <A HREF="Date.html" title="java.util 中的类">Date</A>&nbsp;firstTime,
                                long&nbsp;period)</PRE>
<DL>
<DD>安排指定的任务在指定的时间开始进行重复的<i>固定速率执行</i>。以近似固定的时间间隔（由指定的周期分隔）进行后续执行。

<p>在固定速率执行中，相对于已安排的初始执行时间来安排每次执行。如果由于任何原因（如垃圾回收或其他背景活动）而延迟了某次执行，则将快速连续地出现两次或更多次执行，从而使后续执行能够赶上来。从长远来看，执行的频率将正好是指定周期的倒数（假定 <tt>Object.wait(long)</tt> 所依靠的系统时钟是准确的）。

<p>固定速率执行适用于那些对<i>绝对</i> 时间敏感的重复执行活动，如每小时准点打钟报时，或者在每天的特定时间运行已安排的维护活动。它还适用于那些完成固定次数执行的总计时间很重要的重复活动，如倒计时的计时器，每秒钟滴答一次，共 10 秒钟。最后，固定速率执行适用于安排多次重复执行的计时器任务，这些任务相互之间必须保持同步。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>task</CODE> - 所要安排的任务。<DD><CODE>firstTime</CODE> - 首次执行任务的时间。<DD><CODE>period</CODE> - 执行各后续任务之间的时间间隔，单位是毫秒。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>time.getTime()</tt> 是负数。
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果已经安排或取消了任务，已经取消了计时器，或者计时器线程已终止。</DL>
</DD>
</DL>
<HR>

<A NAME="cancel()"><!-- --></A><H3>
cancel</H3>
<PRE>
public void <B>cancel</B>()</PRE>
<DL>
<DD>终止此计时器，丢弃所有当前已安排的任务。这不会干扰当前正在执行的任务（如果存在）。一旦终止了计时器，它的执行线程也会终止，将无法再安排其他任务。

<p>注意，在此计时器调用的计时器任务的 run 方法内调用此方法，就可以绝对确保正在执行的任务是此计时器所执行的最后一个任务。

<p>可以重复调用此方法；但是第二次和后续调用无效。
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="purge()"><!-- --></A><H3>
purge</H3>
<PRE>
public int <B>purge</B>()</PRE>
<DL>
<DD>从此计时器的任务队列中移除所有已取消的任务。<i>调用此方法对计时器的行为没有影响</i>，但是将取消对队列中已取消任务的引用。如果没有对这些任务的外部引用，则它们就成为垃圾回收的合格对象。

<p>多数程序无需调用此方法。它设计用于一些罕见的应用程序，这些程序可取消大量的任务。调用此方法会以时间来换取空间：此方法的运行时可能与 n + c log n 成正比，其中 n 是队列中的任务数，而 c 是取消的任务数。

<p>注意，从此计时器上所安排的任务中调用此方法是允许的。
<P>
<DD><DL>

<DT><B>返回：</B><DD>从队列中移除的任务数。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</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/Timer.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="StringTokenizer.html" title="java.util 中的类"><B>上一个类</B></A>&nbsp;
&nbsp;<A HREF="TimerTask.html" title="java.util 中的类"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../index.html@java_2Futil_2FTimer.html" target="_top"><B>框架</B></A>  &nbsp;
&nbsp;<A HREF="Timer.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>