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