Таймер (Платформа Java SE 8 b92)

java.lang. Объект
- javax.swing. Таймер

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

Сериализуемый
```
public class Timer
extends Object
implements Serializable
```
Огни один или больше ActionEvents в указанных интервалах. Использование в качестве примера является объектом анимации, который использует a Timer как триггер для рисования его фреймов.
Установка таймера включает создание a Timer объект, регистрируя одного или более слушателей действия на этом, и запуская таймер, используя start метод. Например, следующий код создает и запускает таймер, который запускает событие действия однажды в секунду (как определено первым параметром Timer конструктор). Второй параметр Timer конструктор определяет слушателя, чтобы получить события действия таймера.
```
  int delay = 1000; //milliseconds
  ActionListener taskPerformer = new ActionListener() {
      public void actionPerformed(ActionEvent evt) {
          //...Perform a task...
      }
  };
  new Timer(delay, taskPerformer).start();
```
Timers создаются, определяя и параметр задержки и ActionListener. Параметр задержки используется, чтобы установить и начальную задержку и задержку между увольнением события в миллисекундах. Как только таймер был запущен, он ожидает начальной задержки прежде, чем запустить его первое ActionEvent зарегистрированным слушателям. После этого первого события это продолжает запускать события каждый раз, когда задержка между событиями протекла, пока это не останавливается.
После конструкции начальная задержка и задержка между событиями могут быть изменены независимо, и дополнительные ActionListeners может быть добавлен.
Если Вы хотите, чтобы таймер стрелял только в первый раз и затем остановился, вызвать setRepeats(false) на таймере.
Хотя все Timers выполняют свое ожидающее использование единственного, совместно используемого потока (создаваемый первым Timer объект, который выполняется), обработчики событий действия для Timers выполняются на другом потоке - диспетчеризирующий событие поток. Это означает что обработчики действия для Timers может безопасно выполнить операции на компонентах Swing. Однако, это также означает, что обработчики должны выполниться быстро, чтобы сохранить GUI быстро реагирующим.
В v 1.3, другом Timer class был добавлен к платформе Java: java.util.Timer. И это и javax.swing.Timer обеспечьте ту же самую основную функциональность, но java.util.Timer является более общим и имеет больше функций. javax.swing.Timer имеет две функции, которые могут сделать немного легче использовать с GUI. Во-первых, его метафора обработки событий знакома программистам GUI и может сделать контакт с диспетчеризирующим событие потоком немного более простым. Во-вторых, его автоматическое совместное использование потока означает, что Вы не должны сделать специальные шаги, чтобы избежать порождать слишком много потоков. Вместо этого Ваш таймер использует тот же самый поток, используемый, чтобы заставить курсоры мигнуть, подсказки появляются и так далее.
Можно найти дальнейшую документацию и несколько примеров использования таймеров, посещая, Как Использовать Таймеры, раздел в Учебном руководстве по Java. Для большего количества примеров и справки в выборе между этим Timer class и java.util.Timer, см. Используя Таймеры в Приложениях Swing, статью в Соединении Swing.
Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.
См. Также:

java.util.Timer

Полевая Сводка

Поля
Модификатор и Тип Поле и Описание

protected EventListenerList listenerList

Поля
Модификатор и Тип	Поле и Описание
`protected EventListenerList`	`listenerList`

Сводка конструктора

Конструкторы
Конструктор и Описание
`Timer(int delay, ActionListener listener)` Создает a `Timer` и инициализирует и начальную задержку и задержку между событиями к `delay` миллисекунды.

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

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`void`	`addActionListener(ActionListener listener)` Добавляет слушатель действия `Timer`.
`protected void`	`fireActionPerformed(ActionEvent e)` Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
`Строка`	`getActionCommand()` Возвращает строку, которая будет поставлена как команда действия в `ActionEvent`s запущенный этим таймером.
`ActionListener[]`	`getActionListeners()` Возвращает массив всех слушателей действия, зарегистрированных на этом таймере.
`int`	`getDelay()` Возвращает задержку, в миллисекундах, между взрывами событий действия.
`int`	`getInitialDelay()` Возвраты `Timer`'s начальная задержка.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)` Возвращает массив всех объектов, в настоящий момент зарегистрированных как `FooListener`s на это `Timer`.
`static boolean`	`getLogTimers()` Возвраты `true` если журналирование включается.
`boolean`	`isCoalesce()` Возвраты `true` если `Timer` объединяет многократные события действия на ожидании.
`boolean`	`isRepeats()` Возвраты `true` (значение по умолчанию), если `Timer` отправит событие действия его слушателям многократно.
`boolean`	`isRunning()` Возвраты `true` если `Timer` работает.
`void`	`removeActionListener(ActionListener listener)` Удаляет указанного слушателя действия из `Timer`.
`void`	`restart()` Перезапуски `Timer`, отмена любых взрывов на ожидании и то, чтобы заставлять это стрелять с его начальной задержкой.
`void`	`setActionCommand(String command)` Устанавливает строку, которая будет поставлена как команда действия в `ActionEvent`s запущенный этим таймером.
`void`	`setCoalesce(boolean flag)` Наборы, ли `Timer` объединяет многократное ожидание `ActionEvent` взрывы.
`void`	`setDelay(int delay)` Наборы `Timer`'s между событиями задерживаются, число миллисекунд между последовательными событиями действия.
`void`	`setInitialDelay(int initialDelay)` Наборы `Timer`'s начальная задержка, время в миллисекундах, чтобы ожидать после того, как таймер запускается прежде, чем запустить первое событие.
`static void`	`setLogTimers(boolean flag)` Включает или отключает журнал таймера.
`void`	`setRepeats(boolean flag)` Если `flag` `false`, сообщает `Timer` отправить только одно событие действия его слушателям.
`void`	`start()` Запускается `Timer`, то, чтобы заставлять это начать отправлять события действия его слушателям.
`void`	`stop()` Остановки `Timer`, то, чтобы заставлять это прекратить отправлять события действия его слушателям.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - listenerList
```
protected EventListenerList listenerList
```
- Деталь конструктора
  - Таймер
```
public Timer(int delay,
             ActionListener listener)
```
    Создает a Timer и инициализирует и начальную задержку и задержку между событиями к delay миллисекунды. Если delay меньше чем или равно нулю, огни таймера, как только он запускается. Если listener не null, это регистрируется как слушатель действия на таймере.
    
    Параметры:
    
    delay - миллисекунды для начальной и задержки между событиями
    
    listener - начальный слушатель; может быть null
    
    См. Также:
    
    addActionListener(java.awt.event.ActionListener), setInitialDelay(int), setRepeats(boolean)
- Деталь метода
  - addActionListener
```
public void addActionListener(ActionListener listener)
```
    Добавляет слушатель действия Timer.
    
    Параметры:
    
    listener - слушатель, чтобы добавить
    
    См. Также:
    
    Timer(int, java.awt.event.ActionListener)
  - removeActionListener
```
public void removeActionListener(ActionListener listener)
```
    Удаляет указанного слушателя действия из Timer.
    
    Параметры:
    
    listener - слушатель, чтобы удалить
  - getActionListeners
```
public ActionListener[] getActionListeners()
```
    Возвращает массив всех слушателей действия, зарегистрированных на этом таймере.
    
    Возвраты:
    
    весь таймер ActionListeners или пустой массив, если никакие слушатели действия в настоящий момент не регистрируются
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)
  - fireActionPerformed
```
protected void fireActionPerformed(ActionEvent e)
```
    Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
    
    Параметры:
    
    e - событие действия, чтобы стрелять
    
    См. Также:
    
    EventListenerList
  - getListeners
```
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
```
    Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это Timer. FooListeners регистрируются, используя addFooListener метод.
    Можно определить listenerType параметр с литералом class, такой как FooListener.class. Например, можно запросить a Timer экземпляр t для его слушателей действия со следующим кодом:
```
ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));
```
    Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
    Параметры:
    
    listenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener
    
    Возвраты:
    
    массив всех объектов, зарегистрированных как FooListeners на этом таймере, или пустом массиве, если никакие такие слушатели не были добавлены
    
    Броски:
    
    ClassCastException - если listenerType не определяет class или интерфейс, который реализует java.util.EventListener
    
    С тех пор:
    
    1.3
    
    См. Также:
    
    getActionListeners(), addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)
  - setLogTimers
```
public static void setLogTimers(boolean flag)
```
    Включает или отключает журнал таймера. Когда включено, объявление повешено к System.out всякий раз, когда таймер уходит.
    
    Параметры:
    
    flag - true позволять регистрировать
    
    См. Также:
    
    getLogTimers()
  - getLogTimers
```
public static boolean getLogTimers()
```
    Возвраты true если журналирование включается.
    
    Возвраты:
    
    true если журналирование включается; иначе, ложь
    
    См. Также:
    
    setLogTimers(boolean)
  - setDelay
```
public void setDelay(int delay)
```
    Наборы Timer's между событиями задерживаются, число миллисекунд между последовательными событиями действия. Это не влияет на начальное свойство задержки, которое может быть установлено setInitialDelay метод.
    
    Параметры:
    
    delay - задержка миллисекунд
    
    См. Также:
    
    setInitialDelay(int)
  - getDelay
```
public int getDelay()
```
    Возвращает задержку, в миллисекундах, между взрывами событий действия.
    
    См. Также:
    
    setDelay(int), getInitialDelay()
  - setInitialDelay
```
public void setInitialDelay(int initialDelay)
```
    Наборы Timer's начальная задержка, время в миллисекундах, чтобы ожидать после того, как таймер запускается прежде, чем запустить первое событие. На конструкцию это устанавливается быть тем же самым как задержкой между событиями, но тогда ее значение независимо и остается незатронутым изменениями к задержке между событиями.
    
    Параметры:
    
    initialDelay - начальная задержка, в миллисекундах
    
    См. Также:
    
    setDelay(int)
  - getInitialDelay
```
public int getInitialDelay()
```
    Возвраты Timer's начальная задержка.
    
    См. Также:
    
    setInitialDelay(int), setDelay(int)
  - setRepeats
```
public void setRepeats(boolean flag)
```
    Если flag false, сообщает Timer отправить только одно событие действия его слушателям.
    
    Параметры:
    
    flag - определить false заставить таймер остановиться после отправки его первого события действия
  - isRepeats
```
public boolean isRepeats()
```
    Возвраты true (значение по умолчанию), если Timer отправит событие действия его слушателям многократно.
    
    См. Также:
    
    setRepeats(boolean)
  - setCoalesce
```
public void setCoalesce(boolean flag)
```
    Наборы, ли Timer объединяет многократное ожидание ActionEvent взрывы. Занятое приложение, возможно, не в состоянии не отставать от a Timer's генерация события, заставляя многократные события действия быть поставленным в очередь. Когда обработано, приложение отправляет эти события один за другим, вызывая Timer's слушатели, чтобы получить последовательность событий без задержки между ними. Объединение избегает этой ситуации, уменьшая многократные события на ожидании до единственного события. Timers объединяют события по умолчанию.
    
    Параметры:
    
    flag - определить false выключить объединение
  - isCoalesce
```
public boolean isCoalesce()
```
    Возвраты true если Timer объединяет многократные события действия на ожидании.
    
    См. Также:
    
    setCoalesce(boolean)
  - setActionCommand
```
public void setActionCommand(String command)
```
    Устанавливает строку, которая будет поставлена как команда действия в ActionEvents запущенный этим таймером. null приемлемое значение.
    
    Параметры:
    
    command - команда действия
    
    С тех пор:
    
    1.6
  - getActionCommand
```
public String getActionCommand()
```
    Возвращает строку, которая будет поставлена как команда действия в ActionEvents запущенный этим таймером. Может быть null, который является также значением по умолчанию.
    
    Возвраты:
    
    команда действия используется в увольнении событий
    
    С тех пор:
    
    1.6
  - запустить
```
public void start()
```
    Запускается Timer, то, чтобы заставлять это начать отправлять события действия его слушателям.
    
    См. Также:
    
    stop()
  - isRunning
```
public boolean isRunning()
```
    Возвраты true если Timer работает.
    
    См. Также:
    
    start()
  - остановиться
```
public void stop()
```
    Остановки Timer, то, чтобы заставлять это прекратить отправлять события действия его слушателям.
    
    См. Также:
    
    start()
  - перезапуск
```
public void restart()
```
    Перезапуски Timer, отмена любых взрывов на ожидании и то, чтобы заставлять это стрелять с его начальной задержкой.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Таймер класса

Полевая Сводка

Сводка конструктора

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

Методы, наследованные от class java.lang. Объект

Полевая Деталь

listenerList

Деталь конструктора

Таймер

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

addActionListener

removeActionListener

getActionListeners

fireActionPerformed

getListeners

setLogTimers

getLogTimers

setDelay

getDelay

setInitialDelay

getInitialDelay

setRepeats

isRepeats

setCoalesce

isCoalesce

setActionCommand

getActionCommand

запустить

isRunning

остановиться

перезапуск