JavaTM 2
Platform
Std. Ed. v1.4.0

java.util
クラス TimerTask

java.lang.Object
  |
  +--java.util.TimerTask
すべての実装インタフェース:
Runnable

public abstract class TimerTask
extends Object
implements Runnable

Timer によって 1 回または繰り返し実行するようスケジュールされるタスクです。

導入されたバージョン:
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()
このタイマータスクを取り消します。タスクが 1 回実行されるようにスケジュールされたがまだ実行されていないか、またはスケジュールされていない場合、タスクは実行されません。タスクが繰り返し実行されるようスケジュールされている場合、タスクは二度と実行されません (この呼び出しが発生したときにタスクが実行中の場合、タスクは実行を完了しますが、タスクは二度と実行されません)。

繰り返しタイマータスクの run メソッドからこのメソッドを呼び出すと、タイマータスクは二度と実行されなくなります。

このメソッドは、繰り返し呼び出されます。2 回目以降の呼び出しには、効果はありません。

戻り値:
このタスクが 1 回実行されるようにスケジュールされたがまだ実行されていないか、またはこのタスクが繰り返し実行されるようにスケジュールされている場合は true。タスクが 1 回実行されるようにスケジュールされてすでに実行されているか、またはタスクがスケジュールされてないか、あるいはタスクがすでに取り消されている場合は false を返す (大まかに言うと、このメソッドではスケジュールされている 1 回以上実行されない場合に true を返す)

scheduledExecutionTime

public long scheduledExecutionTime()
このタスクを最近「実際に」実行するように「スケジュールされた」実行時間を返します (このメソッドがタスクの実行中に呼び出された場合、戻り値は進行中のタスク実行のスケジュールされた実行時間になります)。

このメソッドは通常、タスクの実行メソッドから呼び出され、現在のタスクが、スケジュールどおりに作業が実行されているかを判断します。

public void run() {
       if (System.currentTimeMillis() - scheduledExecutionTime() >=
           MAX_TARDINESS)
               return;  // Too late; skip this execution.
       // Perform the task
   }
このメソッドは通常、「固定遅延実行」の繰り返しタスクとともに使用されることはありません。「固定遅延実行」の繰り返しタスクでは、スケジュールされた実行時間はずらすことが可能であり、それほど重要ではないからです。

戻り値:
このタスクの実行が最近スケジュールされた時間。Date.getTime() で返される形式。タスクがまだ実行されていない場合、戻り値は未定義
関連項目:
Date.getTime()

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.