Класс 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

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(). Возвращаемое значение не определено, если задача ещё не начала своё первое выполнение.

См. также:

© 1993, 2023, 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/21/docs/api/java.base/java/util/TimerTask.html