java.awt
클래스 EventQueue

java.lang.Object 
  java.awt.EventQueue

public class EventQueue
extends Object 

EventQueue는 어느 플랫폼으로도 공통의 클래스이며, 기본이 되는 피어 클래스와 신뢰할 수 있는 어플리케이션 클래스로부터의 이벤트를 큐에 넣습니다.

큐로부터 이벤트를 추출하는 비동기 이벤트디스패치 도구를 캡슐화해, 디스패치 되는 이벤트를 인수로서 EventQueue dispatchEvent(AWTEvent) 메서드를 호출하는 것으로 디스패치 합니다. 실제의 동작은 구현에 따라서 다릅니다. 유일한 제한은 이 큐 (EventQueue에 보내진 이벤트는 합체 할 수 있다)에 실제로 넣을 수 있던 이벤트입니다.

차례차례 처리

이 큐로부터의 복수의 이벤트를 동시에 디스패치 할 수 없습니다.

큐에 넣어진 차례와 같다

AWTEvent A가 AWTEvent B 보다 전에 EventQueue 큐에 넣어졌을 경우, 이벤트 B가 이벤트 A 보다 전에 디스패치 될 것은 없습니다.

브라우저에 따라서는 코드 베이스가 다른 애플릿을 개별의 컨텍스트에 분할해, 이러한 컨텍스트를 독립해 취급하는 것이 있습니다. 이 경우 각 컨텍스트 마다 1개의 EventQueue가 존재하게 됩니다. 모든 애플릿을 같은 컨텍스트에 두어, 1개의 글로벌 EventQueue로 모든 애플릿을 동작시키는 브라우저도 있습니다. 이 동작은 구현에 결정됩니다. 자세한 것은 브라우저의 문서를 참조하십시오.

이벤트디스패치 기능의 thread 문제에 대해서는「AWT Threading Issues」를 참조하십시오.

도입된 버전 :

1.1

생성자 개요

EventQueue ()

메서드 개요

protected void	dispatchEvent (AWTEvent event) 이벤트를 디스패치 합니다.
static AWTEvent	getCurrentEvent () 불려 간 thread에 관련된 EventQueue에 현재 디스패치 되고 있는 이벤트를 리턴합니다.
static long	getMostRecentEventTime () 불려 간 thread에 관련된 EventQueue로 부터 디스패치 된, 제일 새로운 타임 스탬프를 가지는 이벤트의 타임 스탬프를 리턴합니다.
AWTEvent	getNextEvent () EventQueue로 부터 이벤트를 삭제해, 그 이벤트를 리턴합니다.
static void	invokeAndWait (Runnable runnable) runnable run 메서드가 EventQueue 디스패치스레드로 호출되도록 합니다.
static void	invokeLater (Runnable runnable) runnable run 메서드가 EventQueue 디스패치스레드로 호출되도록 합니다.
static boolean	isDispatchThread () 호출측 thread가 현재의 AWT EventQueue 디스패치스레드의 경우에 true를 리턴합니다.
AWTEvent	peekEvent () EventQueue 최초의 이벤트를 삭제하지 않고 리턴합니다.
AWTEvent	peekEvent (int id) 지정된 ID를 가지는 이벤트가 있는 경우, 그 중의 최초의 이벤트를 리턴합니다.
protected void	pop () 이 EventQueue를 사용하는 이벤트의 디스패치를 정지합니다.
void	postEvent (AWTEvent theEvent) 1. 1 형식의 이벤트를 EventQueue에 송신합니다.
void	push (EventQueue newEventQueue) 기존의 EventQueue를, 지정된 EventQueue로 옮겨놓습니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

EventQueue

public EventQueue()

메서드의 상세

postEvent

public void postEvent(AWTEvent  theEvent)

1.1 형식의 이벤트를 EventQueue에 송신합니다. 같은 ID 및 이벤트 소스를 가지는 큐에 이벤트가 있는 경우는 소스 Component coalesceEvents 메서드가 호출됩니다.

파라미터:

theEvent - java.awt.AWTEvent 인스턴스, 또는 그 서브 클래스

예외:

NullPointerException - theEvent이 null인 경우

getNextEvent

public AWTEvent  getNextEvent()
                      throws InterruptedException 

EventQueue로 부터 이벤트를 삭제해, 그 이벤트를 리턴합니다. 이 메서드는 다른 thread에 의해 이벤트가 송신될 때까지 블록 됩니다.

반환값:

다음의 AWTEvent

예외:

InterruptedException - 별의 thread가 이 thread에 끼어들었을 경우

peekEvent

public AWTEvent  peekEvent()

EventQueue 최초의 이벤트를 삭제하지 않고 리턴합니다.

반환값:

최초의 이벤트

peekEvent

public AWTEvent  peekEvent(int id)

지정된 ID를 가지는 이벤트가 있는 경우, 그 중의 최초의 이벤트를 리턴합니다.

파라미터:

id - 요구하는 이벤트형의 ID

반환값:

지정된 ID를 가지는 최초의 이벤트. 이 ID를 가지는 이벤트가 존재하지 않는 경우는 null

dispatchEvent

protected void dispatchEvent(AWTEvent  event)

이벤트를 디스패치 합니다. 디스패치 방법은 이벤트의 형태 및 이벤트의 소스 객체의 형태에 따라서 다릅니다.

이벤트형	소스형	디스패치 방법
ActiveEvent	Any	event.dispatch()
그 외	Component	source.dispatchEvent(AWTEvent)
그 외	MenuComponent	source.dispatchEvent(AWTEvent)
그 외	그 외	처리되지 않는다 (무시된다)

파라미터:

event - java.awt.AWTEvent 인스턴스, 또는 그 서브 클래스

예외:

NullPointerException - event이 null인 경우

getMostRecentEventTime

public static long getMostRecentEventTime()

불려 간 thread에 관련된 EventQueue로 부터 디스패치 된, 제일 새로운 타임 스탬프를 가지는 이벤트의 타임 스탬프를 리턴합니다. 타임 스탬프를 가지는 이벤트가 디스패치중의 경우, 그 타임 스탬프가 리턴됩니다 . 이벤트가 전혀 디스패치되어 있지 않은 경우, EventQueue가 초기화된 시간이 리턴됩니다 . JDK 현재의 버전에 서는 InputEvent, ActionEvent 및 InvocationEvent 만이 타임 스탬프를 가집니다만, 장래의 버전에 서는 다른 이벤트형에도 타임 스탬프가 추가될 가능성이 있습니다. 이 메서드는 어플리케이션의 이벤트디스패치스레드로부터 마셔 호출하도록의해 주세요. 다른 thread로부터 호출했을 경우, System.currentTimeMillis()로 리포트되는 현재의 시스템 시각이 리턴됩니다 .

반환값:

디스패치 되는 마지막 InputEvent, ActionEvent, 또는 InvocationEvent 타임 스탬프. 이 메서드가 이벤트디스패치스레드 이외로부터 호출되는 경우는 System.currentTimeMillis()

도입된 버전 :

1.4

관련 항목:

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

getCurrentEvent

public static AWTEvent  getCurrentEvent()

불려 간 thread에 관련된 EventQueue에 현재 디스패치 되고 있는 이벤트를 리턴합니다. 메서드가 이벤트에 액세스 할 필요가 있어, 이벤트에의 참조를 인수로서 받도록 설계되어 있지 않은 경우에 유효합니다. 이 메서드는 어플리케이션의 이벤트디스패치스레드로부터만 호출하도록의해 주세요. 다른 thread로부터 호출했을 경우, null이 리턴됩니다 .

반환값:

현재 디스패치 되고 있는 이벤트. 이 메서드가 이벤트디스패치스레드 이외의 thread로부터 불려가 고 있는 경우는 null

도입된 버전 :

1.4

push

public void push(EventQueue  newEventQueue)

기존의 EventQueue를, 지정된 EventQueue로 옮겨놓습니다. 대기 상태의 이벤트는 처리를 위해서 새로운 EventQueue에 전송 됩니다.

파라미터:

newEventQueue - 사용되는 EventQueue 또는 그 서브 클래스의 인스턴스

예외:

NullPointerException - newEventQueue가 null인 경우

관련 항목:

pop()

pop

protected void pop()
            throws EmptyStackException 

이 EventQueue를 사용하는 이벤트의 디스패치를 정지합니다. 대기 상태의 이벤트는 처리를 위해서 전의 EventQueue에 전송 됩니다.

경고: 데드 록 회피를 위해, 이 메서드를 서브 클래스에서 동기 선언하지 않게 합니다.

예외:

EmptyStackException - 이 EventQueue로 이전에 푸쉬를 하지 않은 경우

관련 항목:

push(java.awt.EventQueue)

isDispatchThread

public static boolean isDispatchThread()

호출측 thread가 현재의 AWT EventQueue 디스패치스레드의 경우에 true를 리턴합니다. 이 메서드를 사용하면, 지정된 태스크를 현재의 AWT EventDispatchThread로 확실히 실행시키는 (또는 실행시키지 않게 한다) 일이 생깁니다.

반환값:

현재의 AWT EventQueue 디스패치스레드로 동작하고 있는 경우는 true

invokeLater

public static void invokeLater(Runnable  runnable)

runnable run 메서드가 EventQueue 디스패치스레드로 호출되도록 합니다. 대기 상태의 모든 이벤트가 처리된 뒤에 호출합니다.

파라미터:

runnable - run 메서드가 EventQueue로 동기 실행되지 않으면 안 되는 Runnable

도입된 버전 :

1.2

관련 항목:

invokeAndWait(java.lang.Runnable)

invokeAndWait

public static void invokeAndWait(Runnable  runnable)
                          throws InterruptedException,

                                 InvocationTargetException 

runnable run 메서드가 EventQueue 디스패치스레드로 호출되도록 합니다. 대기 상태의 모든 이벤트가 처리된 후에 실행됩니다. 호출은 이것이 실행될 때까지 블록 됩니다. 이 메서드는 이벤트 디스팻쳐 thread로부터 불려가 면 Error를 Throw 합니다.

파라미터:

runnable - run 메서드가 EventQueue로 동기 실행되지 않으면 안 되는 Runnable

예외:

InterruptedException - 별의 thread가 이 thread에 끼어들었을 경우

InvocationTargetException - runnable 동작중에 Throwable가 발생되는 경우

도입된 버전 :

1.2

관련 항목:

invokeLater(java.lang.Runnable)