java.awt

Класс EventQueue

java.lang. Объект

java.awt. EventQueue

public class EventQueue
extends Object

EventQueue независимый от платформы класс что события очередей, и от базовых равноправных классов и от доверяемых классов приложений.

Это инкапсулирует асинхронное событие, диспетчеризируют машину, которая извлекает события из очереди и диспетчеризирует их, вызывая dispatchEvent(AWTEvent) метод на этом EventQueue с событием, которое будет диспетчеризировано как параметр. Определенное поведение этой машины является зависящим от реализации. Единственные требования - то, что события, которые фактически ставились в очередь этой очереди (отмечают что события, отправляемые на EventQueue может быть объединен), диспетчеризируются:

Последовательно.

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

В том же самом порядке, поскольку они ставятся в очередь.

Таким образом, если AWTEvent A ставится в очередь к EventQueue прежде AWTEvent B тогда событие B не будет диспетчеризировано перед событием A.

Некоторые апплеты раздела браузеров в различных кодовых базах в отдельные контексты, и устанавливают стены между этими контекстами. В таком сценарии будет тот EventQueue на контекст. Другие браузеры помещают все апплеты в тот же самый контекст, подразумевая, что будет только сингл, глобальный EventQueue для всех апплетов. Это поведение является зависящим от реализации. Консультируйтесь с документацией своего браузера для получения дополнительной информации.

Для получения информации о проблемах поточной обработки события диспетчеризируйте машину, видьте, что AWT Распараллеливает Проблемы.

С тех пор:

1.1

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

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

Конструктор и Описание
EventQueue()

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

Методы

Модификатор и Тип	Метод и Описание
SecondaryLoop	createSecondaryLoop() Создает новое secondary loop связанный с этой очередью событий.
protected void	dispatchEvent(AWTEvent event) Диспетчеризирует событие.
static AWTEvent	getCurrentEvent() Возвращает событие, в настоящий момент диспетчеризируемое EventQueue связанный с вызывающим потоком.
static long	getMostRecentEventTime() Возвращает метку времени нового события, у которого была метка времени, и это было диспетчеризировано от EventQueue связанный с вызывающим потоком.
AWTEvent	getNextEvent() Удаляет событие из EventQueue и возвраты это.
static void	invokeAndWait(Runnable runnable) Причины runnable иметь run метод, призванный dispatch thread из the system EventQueue.
static void	invokeLater(Runnable runnable) Причины runnable иметь run метод, призванный dispatch thread из the system EventQueue.
static boolean	isDispatchThread() Возвращает true, если вызывающий поток the current AWT EventQueue's диспетчеризируют поток.
AWTEvent	peekEvent() Возвращает первое событие на EventQueue не удаляя это.
AWTEvent	peekEvent(int id) Возвращает первое событие с указанным идентификатором, если любой.
protected void	pop() События диспетчеризации остановок, используя это EventQueue.
void	postEvent(AWTEvent theEvent) Отправляет событие с 1.1 стилями на EventQueue.
void	push(EventQueue newEventQueue) Заменяет существующее EventQueue с указанным.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

EventQueue

public EventQueue()

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

постсобытие

public void postEvent(AWTEvent theEvent)

Отправляет событие с 1.1 стилями на EventQueue. Если есть существующее событие на очереди с тем же самым ID и источником события, источником Component's coalesceEvents метод вызовут.

Параметры:

theEvent - экземпляр java.awt.AWTEvent, или подкласс этого

Броски:

NullPointerException - если theEvent null

getNextEvent

public AWTEvent getNextEvent()
                      throws InterruptedException

Удаляет событие из EventQueue и возвраты это. Этот метод блокирует, пока событие не было отправлено другим потоком.

Возвраты:

следующее AWTEvent

Броски:

InterruptedException - если какой-либо поток прервал этот поток

peekEvent

public AWTEvent peekEvent()

Возвращает первое событие на EventQueue не удаляя это.

Возвраты:

первое событие

peekEvent

public AWTEvent peekEvent(int id)

Возвращает первое событие с указанным идентификатором, если любой.

Параметры:

id - идентификатор типа события требуется

Возвраты:

первое событие указанного идентификатора или null если нет такого события

dispatchEvent

protected void dispatchEvent(AWTEvent event)

Диспетчеризирует событие. Способ, которым диспетчеризируется событие, зависит от типа события и типа исходного объекта события:

Тип события	Исходный Тип	Диспетчеризированный
ActiveEvent	Любой	event.dispatch ()
Другой	Компонент	source.dispatchEvent (AWTEvent)
Другой	MenuComponent	source.dispatchEvent (AWTEvent)
Другой	Другой	Никакое действие не (проигнорировано)

Параметры:

event - экземпляр java.awt.AWTEvent, или подкласс этого

Броски:

NullPointerException - если event null

С тех пор:

1.2

getMostRecentEventTime

public static long getMostRecentEventTime()

Возвращает метку времени нового события, у которого была метка времени, и это было диспетчеризировано от EventQueue связанный с вызывающим потоком. Если событие с меткой времени будет в настоящий момент диспетчеризировано, то ее метка времени будет возвращена. Если никакие события еще не были диспетчеризированы, время инициализации EventQueue будет возвращено вместо этого. В текущей версии JDK, только InputEvents, ActionEvents, и InvocationEventу s есть метки времени; однако, будущие версии JDK могут добавить метки времени к дополнительным типам события. Отметьте, что этот метод должен только быть вызван из приложения event dispatching thread. Если этот метод вызывается от другого потока, время существующей системы (как сообщающийся System.currentTimeMillis()) будет возвращен вместо этого.

Возвраты:

метка времени последнего InputEvent, ActionEvent, или InvocationEvent быть диспетчеризированным, или System.currentTimeMillis() если этот метод вызывается на поток кроме потока диспетчеризации события

С тех пор:

1.4

См. Также:

InputEvent.getWhen(), ActionEvent.getWhen(), InvocationEvent.getWhen(), isDispatchThread()

getCurrentEvent

public static AWTEvent getCurrentEvent()

Возвращает событие, в настоящий момент диспетчеризируемое EventQueue связанный с вызывающим потоком. Это полезно, если метод нуждается в доступе к событию, но не был разработан, чтобы получить ссылку на это как параметр. Отметьте, что этот метод должен только быть вызван от потока диспетчеризации события приложения. Если этот метод будет вызван от другого потока, то нуль будет возвращен.

Возвраты:

событие, в настоящий момент диспетчеризируемое, или нуль, если этот метод вызывается на поток кроме потока диспетчеризации события

С тех пор:

1.4

продвинуть

public void push(EventQueue newEventQueue)

Заменяет существующее EventQueue с указанным. Любые события на ожидании передаются новому EventQueue для того, чтобы обработать этим.

Параметры:

newEventQueue - EventQueue (или подкласс этого) экземпляр, чтобы быть использованием

Броски:

NullPointerException - если newEventQueue null

С тех пор:

1.2

См. Также:

pop()

появиться

protected void pop()
            throws EmptyStackException

События диспетчеризации остановок, используя это EventQueue. Любые события на ожидании передаются предыдущему EventQueue для того, чтобы обработать.

Предупреждение: Чтобы избежать мертвой блокировки, не объявляйте этот метод, синхронизируемый в подклассе.

Броски:

EmptyStackException - если никакое предыдущее нажатие не было сделано на этом EventQueue

С тех пор:

1.2

См. Также:

push(java.awt.EventQueue)

createSecondaryLoop

public SecondaryLoop createSecondaryLoop()

Создает новое secondary loop связанный с этой очередью событий. Используйте SecondaryLoop.enter() и SecondaryLoop.exit() методы, чтобы запуститься и остановить цикл события и диспетчеризировать события от этой очереди.

Возвраты:

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

С тех пор:

1.7

См. Также:

SecondaryLoop.enter(), SecondaryLoop.exit()

isDispatchThread

public static boolean isDispatchThread()

Возвращает true, если вызывающий поток the current AWT EventQueue's диспетчеризируют поток. Используйте этот метод, чтобы гарантировать, что определенная задача выполняется (или не бывшей) там.

Отметьте: используйте invokeLater(java.lang.Runnable) или invokeAndWait(java.lang.Runnable) методы, чтобы выполнить задачу в the current AWT EventQueue's диспетчеризируют поток.

Возвраты:

истина, работая в the current AWT EventQueue's диспетчеризируют поток

С тех пор:

1.2

См. Также:

invokeLater(java.lang.Runnable), invokeAndWait(java.lang.Runnable), Toolkit.getSystemEventQueue()

invokeLater

public static void invokeLater(Runnable runnable)

Причины runnable иметь run метод, призванный dispatch thread из the system EventQueue. Это произойдет после того, как все события на ожидании обрабатываются.

Параметры:

runnable - Runnable чей run метод должен быть выполнен асинхронно в event dispatch thread из the system EventQueue

С тех пор:

1.2

См. Также:

invokeAndWait(java.lang.Runnable), Toolkit.getSystemEventQueue(), isDispatchThread()

invokeAndWait

public static void invokeAndWait(Runnable runnable)
                          throws InterruptedException,
                                 InvocationTargetException

Причины runnable иметь run метод, призванный dispatch thread из the system EventQueue. Это произойдет после того, как все события на ожидании обрабатываются. Блоки вызова, пока это не произошло. Этот метод бросит Ошибку если вызвано от event dispatcher thread.

Параметры:

runnable - Runnable чей run метод должен быть выполнен синхронно в event dispatch thread из the system EventQueue

Броски:

InterruptedException - если какой-либо поток прервал этот поток

InvocationTargetException - если throwable бросается, работая runnable

С тех пор:

1.2

См. Также:

invokeLater(java.lang.Runnable), Toolkit.getSystemEventQueue(), isDispatchThread()