java.awt.event
클래스 InvocationEvent

java.lang.Object 
  java.util.EventObject 
      java.awt.AWTEvent 
          java.awt.event.InvocationEvent

모든 구현된 인터페이스:

ActiveEvent, Serializable

public class InvocationEvent
extends AWTEvent 
implements ActiveEvent 

AWT 이벤트의 디스펫쳐 thread에 의해 디스패치 되었을 때에 Runnable 상에서 run() 메서드를 실행하는 이벤트입니다. 이 클래스는 새로운 클래스를 선언해 dispatch()를 정의하는 대신에 ActiveEvent 참조 구현으로서 사용할 수 있습니다.

이 클래스의 인스턴스는 invokeLater 및 invokeAndWait 호출에 의해 EventQueue에 놓여집니다. 이것에 의해 클라이언트의 코드에서는 특별한 경우의 코드를 쓰는 일 없이 AWTEventListener 객체내에 invokeLater 및 invokeAndWait에 대신하는 함수를 기술할 수 있습니다 .

도입된 버전 :

1.2

관련 항목:

ActiveEvent, EventQueue.invokeLater(java.lang.Runnable), EventQueue.invokeAndWait(java.lang.Runnable), AWTEventListener, 직렬화 된 형식

필드 개요

protected boolean	catchExceptions true 로 설정했을 경우는 dispatch()가 Throwable를 캐치의해 그것을 예외의 인스턴스 변수에 포함합니다.
static int	INVOCATION_DEFAULT 모든 InvocationEvent에 대한 디폴트의 식별자입니다.
static int	INVOCATION_FIRST 호출 이벤트 식별자를 나타내는 정수형의 범위의, 최초의 번호입니다.
static int	INVOCATION_LAST 호출 이벤트 식별자를 나타내는 정수형의 범위의, 마지막 번호입니다.
protected Object	notifier Runnable.run() 메서드의 복귀 후 즉시 호출되는 notifyAll() 메서드를 가지는 객체입니다 (null인 경우도 있다).
protected Runnable	runnable 호출되는 run() 메서드를 가지는 Runnable 객체입니다.

클래스 java.awt. AWTEvent 로부터 상속된 필드

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

클래스 java.util. EventObject 로부터 상속된 필드

source

생성자 개요

protected	InvocationEvent (Object source, int id, Runnable runnable, Object notifier, boolean catchThrowables) InvocationEvent를 구축합니다.
	InvocationEvent (Object source, Runnable runnable) InvocationEvent를 구축합니다.
	InvocationEvent (Object source, Runnable runnable, Object notifier, boolean catchThrowables) InvocationEvent를 구축합니다.

메서드 개요

void	dispatch () Runnable run() 메서드를 실행해, notifier가 있으면 run()가 복귀할 경우에 통지합니다.
Exception	getException () Runnable run() 메서드 실행시에 캐치 된 Exception을 리턴합니다.
Throwable	getThrowable () Runnable run() 메서드 실행시에 캐치 된 Throwable를 리턴합니다.
long	getWhen () 이 이벤트가 발생한 시점의 타임 스탬프를 리턴합니다.
String	paramString () 이 이벤트를 특정하는 파라미터의 캐릭터 라인을 리턴합니다.

클래스 java.awt. AWTEvent 로부터 상속된 메서드

consume, getID, isConsumed, setSource, toString

클래스 java.util. EventObject 로부터 상속된 메서드

getSource

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

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

필드의 상세

INVOCATION_FIRST

public static final int INVOCATION_FIRST

호출 이벤트 식별자를 나타내는 정수형의 범위의, 최초의 번호입니다.

관련 항목:

정수 필드값

INVOCATION_DEFAULT

public static final int INVOCATION_DEFAULT

모든 InvocationEvent에 대한 디폴트의 식별자입니다.

관련 항목:

정수 필드값

INVOCATION_LAST

public static final int INVOCATION_LAST

호출 이벤트 식별자를 나타내는 정수형의 범위의, 마지막 번호입니다.

관련 항목:

정수 필드값

runnable

protected Runnable  runnable

호출되는 run() 메서드를 가지는 Runnable 객체입니다.

notifier

protected Object  notifier

Runnable.run() 메서드의 복귀 후 즉시 호출되는 notifyAll() 메서드를 가지는 객체입니다 (null인 경우도 있다).

catchExceptions

protected boolean catchExceptions

true 로 설정했을 경우는 dispatch()가 Throwable를 캐치의해 그것을 예외의 인스턴스 변수에 포함합니다. false인 경우는 Throwable는 EventDispatchThread 디스패치르프까지 보내집니다.

생성자 상세

InvocationEvent

public InvocationEvent(Object  source,
                       Runnable  runnable)

InvocationEvent를 구축합니다. 이 때, 디스패치 되었을 때에 runnable run 메서드를 실행하는 발생원의 객체를 지정합니다.

이것은 간이 생성자 입니다. InvocationEvent(source, runnable) 형식에서 호출했을 경우, InvocationEvent (source, runnable, null, false) 호출과 완전히 똑같이 동작합니다.

source가 null인 경우, 이 메서드는 IllegalArgumentException을 Throw 합니다.

파라미터:

source - 이벤트의 발생원의 Object

runnable - 실행되는 run 메서드를 가지는 Runnable 객체

예외:

IllegalArgumentException - source가 null인 경우

관련 항목:

InvocationEvent(Object, Runnable, Object, boolean)

InvocationEvent

public InvocationEvent(Object  source,
                       Runnable  runnable,
                       Object  notifier,
                       boolean catchThrowables)

InvocationEvent를 구축합니다. 이 때, 디스패치 되었을 때에 runnable run 메서드를 실행하는 발생원의 객체를 지정합니다. notifier가 null이 아닌 경우는 run 복귀 후 즉시 그 객체의 notifyAll()가 호출됩니다.

InvocationEvent(source, runnable, notifier, catchThrowables) 형식에서 호출했을 경우, InvocationEvent (source, InvocationEvent.INVOCATION_DEFAULT, runnable, notifier, catchThrowables) 호출과 완전히 똑같이 동작합니다.

source가 null인 경우, 이 메서드는 IllegalArgumentException을 Throw 합니다.

파라미터:

source - 이벤트의 발생원의 Object

runnable - 실행되는 run 메서드를 가지는 Runnable 객체

notifier - Runnable.run 복귀 후에 호출되는 notifyAll 메서드를 보관 유지하는 Object

catchThrowables - Runnable run 메서드의 실행시에 dispatch에 의해 Throwable가 캐치 되는지, 이러한 Throwable가 EventDispatchThread 디스패치르프까지 보내지는지를 지정한다

예외:

IllegalArgumentException - source가 null인 경우

관련 항목:

InvocationEvent(Object, int, Runnable, Object, boolean)

InvocationEvent

protected InvocationEvent(Object  source,
                          int id,
                          Runnable  runnable,
                          Object  notifier,
                          boolean catchThrowables)

InvocationEvent를 구축합니다. 이 때, 디스패치 되었을 때에 runnable run 메서드를 실행하는 발생원의 객체와 이벤트의 식별자를 지정합니다. notifier가 null이 아닌 경우는 run 복귀 후 즉시 그 객체의 notifyAll가 호출됩니다.

무효인 id를 건네주면, 특정할 수 없는 동작이 발생합니다. 이 메서드는 source가 null인 경우에 IllegalArgumentException을 Throw 합니다.

파라미터:

source - 이벤트의 발생원의 Object

id - 이벤트의 식별자

runnable - 실행되는 run 메서드를 가지는 Runnable 객체

notifier - Runnable.run 복귀 후에 호출되는 notifyAll 메서드를 보관 유지하는 Object

catchThrowables - Runnable run 메서드의 실행시에 dispatch에 의해 Throwable가 캐치 되는지, 이러한 Throwable가 EventDispatchThread 디스패치르프까지 보내지는지를 지정한다

예외:

IllegalArgumentException - source가 null인 경우

메서드의 상세

dispatch

public void dispatch()

Runnable run() 메서드를 실행해, notifier가 있으면 run()가 복귀할 경우에 통지합니다.

정의:

인터페이스 ActiveEvent 내의 dispatch

getException

public Exception  getException()

Runnable run() 메서드 실행시에 캐치 된 Exception을 리턴합니다.

반환값:

Exception가 Throw 되었을 경우는 그 Exception에 대한 참조. Exception가 Throw 되지 않았던 경우, 또는 InovocationEvent가 예외를 캐치 하지 않았던 경우는 null

getThrowable

public Throwable  getThrowable()

Runnable run() 메서드 실행시에 캐치 된 Throwable를 리턴합니다.

반환값:

Throwable가 Throw 되었을 경우는 그 Throwable에 대한 참조. Throwable가 Throw 되지 않았던 경우, 또는 InovocationEvent가 예외를 캐치 하지 않았던 경우는 null

getWhen

public long getWhen()

이 이벤트가 발생한 시점의 타임 스탬프를 리턴합니다.

반환값:

이 이벤트의 타임 스탬프

도입된 버전 :

1.4

paramString

public String  paramString()

이 이벤트를 특정하는 파라미터의 캐릭터 라인을 리턴합니다. 이 메서드는 이벤트 로그의 작성 및 디버그에 사용합니다.

오버라이드(override):

클래스 AWTEvent 내의 paramString

반환값:

이벤트를 특정하는 캐릭터 라인과 그 속성