Класс 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/TimerTask.html