当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

TimerTask (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.util
类 TimerTask

java.lang.Object
  java.util.TimerTask

所有已实现的接口：

Runnable

---

public abstract class TimerTask
extends Object
implements Runnable

由 Timer 安排为一次执行或重复执行的任务。

从以下版本开始：

1.3

另请参见：

Timer

---

构造方法摘要
protected	TimerTask()           创建一个新的计时器任务。

 

方法摘要
boolean	cancel()           取消此计时器任务。
abstract  void	run()           此计时器任务要执行的操作。
long	scheduledExecutionTime()           返回此任务最近实际 执行的已安排 执行时间。

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

构造方法详细信息

TimerTask

protected TimerTask()

创建一个新的计时器任务。

方法详细信息

run

public abstract void run()

此计时器任务要执行的操作。

指定者：

接口 Runnable 中的 run

另请参见：

Thread.run()

---

cancel

public boolean cancel()

取消此计时器任务。如果任务安排为一次执行且还未运行，或者尚未安排，则永远不会运行。如果任务安排为重复执行，则永远不会再运行。（如果发生此调用时任务正在运行，则任务将运行完，但永远不会再运行。）

注意，从重复的计时器任务的 run 方法中调用此方法绝对保证计时器任务不会再运行。

此方法可以反复调用；第二次和以后的调用无效。

返回：

如果此任务安排为一次执行且尚未运行，或者此任务安排为重复执行，则返回 true。如果此任务安排为一次执行且已经运行，或者此任务尚未安排，或者此任务已经取消，则返回 false。（一般来说，如果此方法不允许发生一个或多个已安排执行，则返回 true。）

---

scheduledExecutionTime

public long scheduledExecutionTime()

返回此任务最近实际 执行的已安排 执行时间。（如果在任务执行过程中调用此方法，则返回值为此任务执行的已安排执行时间。）

通常从一个任务的 run 方法中调用此方法，以确定当前任务执行是否能充分及时地保证完成已安排活动：

   public void run() {
       if (System.currentTimeMillis() - scheduledExecutionTime() >=
           MAX_TARDINESS)
               return;  // Too late; skip this execution.
       // Perform the task
   }
 

通常，此方法不 与固定延迟执行 的重复任务一起使用，因为其已安排执行时间允许随时间浮动，所以毫无意义。

返回：

最近发生此任务执行安排的时间，采用 Date.getTime() 返回的格式。如果任务已开始其首次执行，则返回值不确定。

另请参见：

Date.getTime()

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。