Java java.util 类 TimerTask（JDK5）

所有类

java.util
类 TimerTask

java.lang.Object
  java.util.TimerTask

所有已实现的接口：

Runnable

public abstract class TimerTask
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements Runnable
   
   
   
   
   

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

从以下版本开始：

1.3

另请参见：

Timer

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()