Класс TimerTask

java.lang.Object

java.util.TimerTask

Все реализованные интерфейсы:: Runnable

public abstract class TimerTask extends Object implements Runnable

Задача, которая может быть запланирована на однократное или многократное выполнение с помощью Timer.

Задача таймера не является многоразовой. После того, как задача была запланирована на выполнение в Timer или отменена, последующие попытки запланировать ее на выполнение приведут к IllegalStateException.

С момента:: 1.3

Краткое описание конструкторов

TimerTask()

Модификатор	Конструктор	Описание
`protected`	Создает новую задачу таймера.

Краткое описание методов

Модификатор и тип	Метод	Описание
`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()

Действие, которое должно быть выполнено этой задачей таймера.

Указано:

run в интерфейсе Runnable

См. также:

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

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/TimerTask.html