java.util.concurrent

Интерфейсный ScheduledExecutorService

Все Суперинтерфейсы:

Исполнитель, Эксекуторсервайс

Все Известные Классы с реализацией:

ScheduledThreadPoolExecutor

public interface ScheduledExecutorService
extends ExecutorService

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

Методы schedule создают задачи с различными задержками и возвращают объект задачи, который может использоваться, чтобы отменить или проверить выполнение. Методы scheduleAtFixedRate И scheduleWithFixedDelay создают и выполняют задачи, которые работают периодически пока не отменено.

Команды представили использование Executor.execute(java.lang.Runnable) и ExecutorService Методы submit планируются с требуемой задержкой нуля. Нуль и отрицательные задержки (но не периоды) также позволяются в методах schedule, и обрабатываются как запросы на непосредственное выполнение.

Все методы schedule принимают относительные задержки и периоды как параметры, не абсолютные времена или даты. Это - простой вопрос, чтобы преобразовать абсолютное время, представленное как a Date к необходимой форме. Например, чтобы запланировать в определенном будущем date, можно использовать: schedule(task, date.getTime() - System.currentTimeMillis(), TimeUnit.MILLISECONDS). Остерегайтесь однако, что истечение относительной задержки не должно совпасть с текущим Date, в котором задача включается из-за сетевых протоколов синхронизации времени, дрейфа часов, или других факторов. Executors класс обеспечивает удобные методы фабрики для реализаций ScheduledExecutorService, обеспеченных в этом пакете.

Пример использования

Вот класс с методом, который устанавливает ScheduledExecutorService, чтобы подать звуковой сигнал каждые десять секунд в течение часа:

 import static java.util.concurrent.TimeUnit.*;
 class BeeperControl {
   private final ScheduledExecutorService scheduler =
     Executors.newScheduledThreadPool(1);

   public void beepForAnHour() {
     final Runnable beeper = new Runnable() {
       public void run() { System.out.println("beep"); }
     };
     final ScheduledFuture<?> beeperHandle =
       scheduler.scheduleAtFixedRate(beeper, 10, 10, SECONDS);
     scheduler.schedule(new Runnable() {
       public void run() { beeperHandle.cancel(true); }
     }, 60 * 60, SECONDS);
   }
 }

С тех пор:

1.5

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
<V> ScheduledFuture<V>	schedule(Callable<V> callable, long delay, TimeUnit unit) Создает и выполняет ScheduledFuture, который становится включенным после данной задержки.
ScheduledFuture<?>	schedule(Runnable command, long delay, TimeUnit unit) Создает и выполняет действие с одним выстрелом, которое становится включенным после данной задержки.
ScheduledFuture<?>	scheduleAtFixedRate(Runnable command, long initialDelay, long period, TimeUnit unit) Создает и выполняет периодическое действие, которое становится включенным сначала после данной начальной задержки, и впоследствии с установленным сроком; это - выполнение, начнется после initialDelay тогда initialDelay+period, тогда initialDelay + 2 * period, и так далее.
ScheduledFuture<?>	scheduleWithFixedDelay(Runnable command, long initialDelay, long delay, TimeUnit unit) Создает и выполняет периодическое действие, которое становится включенным сначала после данной начальной задержки, и впоследствии с данной задержкой между завершением одного выполнения и началом следующего.

Методы, наследованные от интерфейса java.util.concurrent. ExecutorService

awaitTermination, invokeAll, invokeAll, invokeAny, invokeAny, isShutdown, isTerminated, shutdown, shutdownNow, submit, submit, submit

Методы, наследованные от интерфейса java.util.concurrent. Исполнитель

выполниться

Деталь метода

расписание

ScheduledFuture<?> schedule(Runnable command,
                          long delay,
                          TimeUnit unit)

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

Параметры:

command - задача выполниться

delay - время с этого времени, чтобы задержать выполнение

unit - единица измерения времени параметра задержки

Возвраты:

завершение представления ScheduledFuture на ожидании задачи и чей метод get() возвратит null после завершения

Броски:

RejectedExecutionException - если задача не может быть запланирована для выполнения

NullPointerException - если команда является нулем

расписание

<V> ScheduledFuture<V> schedule(Callable<V> callable,
                              long delay,
                              TimeUnit unit)

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

Параметры:

callable - функция, чтобы выполниться

delay - время с этого времени, чтобы задержать выполнение

unit - единица измерения времени параметра задержки

Возвраты:

ScheduledFuture, который может использоваться, чтобы извлечь результат или отмену

Броски:

RejectedExecutionException - если задача не может быть запланирована для выполнения

NullPointerException - если вызываемый нуль

scheduleAtFixedRate

ScheduledFuture<?> scheduleAtFixedRate(Runnable command,
                                     long initialDelay,
                                     long period,
                                     TimeUnit unit)

Создает и выполняет периодическое действие, которое становится включенным сначала после данной начальной задержки, и впоследствии с установленным сроком; это - выполнение, начнется после initialDelay тогда initialDelay+period, тогда initialDelay + 2 * period, и так далее. Если какое-либо выполнение задачи встречается с исключением, последующее выполнение подавляется. Иначе, задача только завершится через отмену или завершение исполнителя. Если какое-либо выполнение этой задачи занимает больше времени чем ее период, то последующее выполнение может запуститься поздно, но не будет одновременно выполняться.

Параметры:

command - задача выполниться

initialDelay - время, чтобы задержать первое выполнение

period - период между последовательным выполнением

unit - единица измерения времени initialDelay и параметров периода

Возвраты:

завершение представления ScheduledFuture на ожидании задачи, и чей метод get() выдаст исключение на отмену

Броски:

RejectedExecutionException - если задача не может быть запланирована для выполнения

NullPointerException - если команда является нулем

IllegalArgumentException - если период, меньше чем или равный нулю

scheduleWithFixedDelay

ScheduledFuture<?> scheduleWithFixedDelay(Runnable command,
                                        long initialDelay,
                                        long delay,
                                        TimeUnit unit)

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

Параметры:

command - задача выполниться

initialDelay - время, чтобы задержать первое выполнение

delay - задержка между завершением одного выполнения и началом следующего

unit - единица измерения времени initialDelay и параметров задержки

Возвраты:

завершение представления ScheduledFuture на ожидании задачи, и чей метод get() выдаст исключение на отмену

Броски:

RejectedExecutionException - если задача не может быть запланирована для выполнения

NullPointerException - если команда является нулем

IllegalArgumentException - если задержка, меньше чем или равная нулю