Класс Timer

public class Timer
extends Object

Объект для планирования задач для выполнения в фоновом потоке. Задачи могут быть запланированы для однократного выполнения или для многократного выполнения через регулярные интервалы.

Каждому объекту Timer соответствует один фоновый поток, используемый для последовательного выполнения всех задач таймера. Задачи таймера должны выполняться быстро. Если задача таймера занимает слишком много времени, она «забирает» поток выполнения задач таймера. Это, в свою очередь, может задерживать выполнение последующих задач, которые могут «накапливаться» и выполняться с большой скоростью, когда (и если) проблемная задача, наконец, завершится.

После того, как последняя активная ссылка на объект Timer исчезнет и все ожидающие задачи завершат выполнение, поток выполнения задач таймера завершается корректно (и становится доступным для сборки мусора). Однако это может занять произвольно долгое время. По умолчанию, поток выполнения задач не работает как демон-поток, поэтому он может препятствовать завершению приложения. Если вызывающий код хочет быстро завершить поток выполнения задач таймера, вызывающий код должен вызвать метод cancel таймера.

Если поток выполнения задач таймера завершается неожиданно, например, потому что был вызван метод stop, любая дальнейшая попытка запланировать задачу в таймере приведет к IllegalStateException, как если бы был вызван метод cancel таймера.

Этот класс потокобезопасен: несколько потоков могут совместно использовать один объект Timer без необходимости внешней синхронизации.

Этот класс не гарантирует реального времени: он планирует задачи, используя метод Object.wait(long).

В Java 5.0 был введен пакет java.util.concurrent и одной из утилитов для многопоточности в нем является ScheduledThreadPoolExecutor, который представляет собой пул потоков для многократного выполнения задач с заданной скоростью или задержкой. Он эффективно является более универсальной заменой сочетанию Timer/TimerTask, поскольку он позволяет использовать несколько потоков обслуживания, принимает различные единицы времени и не требует наследования от TimerTask (достаточно реализовать Runnable). Настройка ScheduledThreadPoolExecutor с одним потоком эквивалентна Timer.

Примечание для реализации: Этот класс масштабируется до большого количества одновременно запланированных задач (тысячи задач не должны представлять проблемы). Внутренне он использует двоичную кучу для представления очереди задач, поэтому стоимость планирования задачи составляет O(log n), где n — количество одновременно запланированных задач.

Примечание для реализации: Все конструкторы запускают поток таймера.

Конструкторы

Timer

public Timer()

Создаёт новый таймер. Сопутствующая нить не выполняется как демоническая.

Timer

public Timer(boolean isDaemon)

Создаёт новый таймер, чья сопутствующая нить может быть указана для выполнения как демонической. Демоническая нить используется, если таймер будет использоваться для планирования повторяющихся «поддерживающих операций», которые должны выполняться до тех пор, пока приложение работает, но не должны удлинять срок жизни приложения.

Параметры:

isDaemon - true, если сопутствующая нить должна выполняться как демоническая.

Timer

public Timer(String name)

Создаёт новый таймер, чья сопутствующая нить имеет указанное имя. Сопутствующая нить не выполняется как демоническая.

Параметры:

name - имя сопутствующей нити

Исключения:

NullPointerException - если name равно null

С:

1.5

Timer

public Timer(String name,
             boolean isDaemon)

Создаёт новый таймер, чья сопутствующая нить имеет указанное имя и может быть указана для выполнения как демонической.

Параметры:

name - имя сопутствующей нити

isDaemon - true, если сопутствующая нить должна выполняться как демоническая

Исключения:

NullPointerException - если name равно null

С:

1.5

Методы

schedule

public void schedule(TimerTask task,
                     long delay)

Планирует указанную задачу для выполнения после указанной задержки.

Параметры:

task - планируемая задача.

delay - задержка в миллисекундах перед выполнением задачи.

Исключения:

IllegalArgumentException - если delay отрицательное, или delay + System.currentTimeMillis() отрицательное.

IllegalStateException - если задача уже была запланирована или отменена, таймер был отменён или нить таймера завершена.

NullPointerException - если task равно null

schedule

public void schedule(TimerTask task,
                     Date time)

Планирует указанную задачу для выполнения в указанное время. Если время в прошлом, задача планируется для немедленного выполнения.

Параметры:

task - планируемая задача.

time - время выполнения задачи.

Исключения:

IllegalArgumentException - если time.getTime() отрицательное.

IllegalStateException - если задача уже была запланирована или отменена, таймер был отменён или нить таймера завершена.

NullPointerException - если task или time равно null

schedule

public void schedule(TimerTask task,
                     long delay,
                     long period)

Параметры:

task - планируемая задача.

delay - задержка в миллисекундах перед выполнением задачи.

period - время в миллисекундах между последовательными выполнениями задачи.

Исключения:

IllegalArgumentException - если delay < 0, или delay + System.currentTimeMillis() < 0, или period <= 0

IllegalStateException - если задача уже была запланирована или отменена, таймер был отменён или нить таймера завершена.

NullPointerException - если task равно null

schedule

public void schedule(TimerTask task,
                     Date firstTime,
                     long period)

Параметры:

task - планируемая задача.

firstTime - Первое время выполнения задачи.

period - время в миллисекундах между последовательными выполнениями задачи.

Исключения:

IllegalArgumentException - если firstTime.getTime() < 0, или period <= 0

IllegalStateException - если задача уже была запланирована или отменена, таймер был отменён или нить таймера завершена.

NullPointerException - если task или firstTime равно null

scheduleAtFixedRate

public void scheduleAtFixedRate(TimerTask task,
                                long delay,
                                long period)

Параметры:

task - планируемая задача.

delay - задержка в миллисекундах перед выполнением задачи.

period - время в миллисекундах между последовательными выполнениями задачи.

Исключения:

IllegalArgumentException - если delay < 0, или delay + System.currentTimeMillis() < 0, или period <= 0

IllegalStateException - если задача уже была запланирована или отменена, таймер был отменён или нить таймера завершена.

NullPointerException - если task равно null

scheduleAtFixedRate

public void scheduleAtFixedRate(TimerTask task,
                                Date firstTime,
                                long period)

Параметры:

task - планируемая задача.

firstTime - Первое время выполнения задачи.

period - время в миллисекундах между последовательными выполнениями задачи.

Исключения:

IllegalArgumentException - если firstTime.getTime() < 0 или period <= 0

IllegalStateException - если задача уже была запланирована или отменена, таймер был отменён или нить таймера завершена.

NullPointerException - если task или firstTime равно null

cancel

public void cancel()

purge

public int purge()

Возвращает:

количество задач, удаленных из очереди.

С:

1.5