クラスTimerTask

java.lang.Object
java.util.TimerTask
すべての実装されたインタフェース:
Runnable
public abstract class TimerTask extends Object implements Runnable
Timerで1回または繰り返し実行するようにスケジュールできるタスク。

タイマー・タスクは再利用できません。 タスクがTimerで実行するようにスケジュールされるか、取り消されると、それ以降に実行をスケジュールしようとすると、IllegalStateExceptionがスローされます。

導入されたバージョン:
1.3

  • コンストラクタのサマリー

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    protected
    TimerTask()
    新しいタイマー・タスクが作成されます。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    boolean
    cancel()
    このタイマー・タスクを取り消します。
    abstract void
    run()
    このタイマー・タスクによって実行されるアクションです。
    long
    scheduledExecutionTime()
    このタスクの最新の実際の実行のスケジュールされた実行時間を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • TimerTask

      protected TimerTask()
      新しいタイマー・タスクが作成されます。

  • メソッドの詳細

    • run

      public abstract void run()
      このタイマー・タスクによって実行されるアクションです。
      定義:
      run、インタフェースRunnable

    • 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()で返される形式。 タスクがまだ実行されていない場合、戻り値は未定義
      関連項目: