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 메소드를 가지는 객체

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 되지 않았던 경우, 또는 InvocationEvent 가 Throwable 를 캐치 하지 않았던 경우는 null

도입된 버젼:

1.5

getWhen

public long getWhen()

이 이벤트가 발생한 시점의 타임 스탬프를 돌려줍니다.

반환값:

이 이벤트의 타임 스탬프

도입된 버젼:

1.4

paramString

public String  paramString()

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

오버라이드(override):

클래스 AWTEvent 내의 paramString

반환값:

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