java.awt.event

Class InvocationEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.InvocationEvent

All Implemented Interfaces:

ActiveEvent ， Serializable

public class InvocationEvent
extends AWTEvent
implements ActiveEvent

在由AWT事件调度程序线程Runnable时，在Runnable上执行run()方法的事件。 这个类可以用作ActiveEvent的ActiveEvent而不是声明一个新类并定义dispatch() 。

该课程的EventQueue通过致电invokeLater和invokeAndWait而被放置在invokeAndWait 。 客户端代码可以使用此事实为invokeLater和invokeAndWait写入替换函数，而无需在任何AWTEventListener对象中写入特殊情况代码。

如果未指定的行为将引起id任何特定的参数InvocationEvent实例不在范围从INVOCATION_FIRST到INVOCATION_LAST 。

从以下版本开始：

1.2

另请参见：

ActiveEvent ， EventQueue.invokeLater(java.lang.Runnable) ， EventQueue.invokeAndWait(java.lang.Runnable) ， AWTEventListener ， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	catchExceptions 如果dispatch（）捕获Throwable并将其存储在异常实例变量中，则设置为true。
static int	INVOCATION_DEFAULT 所有InvocationEvents的默认ID。
static int	INVOCATION_FIRST 标记调用事件ID的范围的第一个整数ID。
static int	INVOCATION_LAST 标记调用事件ID的范围的最后一个整数ID。
protected Object	notifier 在Runnable.run（）方法返回或抛出异常之后或事件处理完毕后，将立即调用其notifyAll（）方法的（可能为空）的对象。
protected Runnable	runnable Runnable的run（）方法将被调用。

Fields inherited from class 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

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	InvocationEvent(Object source, int id, Runnable runnable, Object notifier, boolean catchThrowables) 构造一个 InvocationEvent ，其中指定的源和ID将在 run时执行runnable的 run方法。
	InvocationEvent(Object source, Runnable runnable) 构造一个 InvocationEvent与将执行可运行的指定的源 run时调度方法。
	InvocationEvent(Object source, Runnable runnable, Object notifier, boolean catchThrowables) 构造一个 InvocationEvent与将执行可运行的指定的源 run时调度方法。
	InvocationEvent(Object source, Runnable runnable, Runnable listener, boolean catchThrowables) 构造具有 InvocationEvent源的InvocationEvent，它将在 run时执行runnable的 run方法。

方法摘要

Modifier and Type	Method and Description
void	dispatch() 执行Runnable的 run()方法，并在 run()已返回或抛出异常时通知通知程序（如果有）。
异常	getException() 返回在执行Runnable的 run()方法时捕获的任何异常。
Throwable	getThrowable() 返回在执行Runnable的 run()方法时捕获的任何Throwable。
long	getWhen() 返回发生此事件的时间戳。
boolean	isDispatched() 如果 true事件或发送时抛出任何异常，则返回true， false返回false。
String	paramString() 返回标识此事件的参数字符串。

Methods inherited from class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

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

字段详细信息

INVOCATION_FIRST

public static final int INVOCATION_FIRST

标记调用事件ID的范围的第一个整数ID。

另请参见：

Constant Field Values

INVOCATION_DEFAULT

public static final int INVOCATION_DEFAULT

所有InvocationEvents的默认ID。

另请参见：

Constant Field Values

INVOCATION_LAST

public static final int INVOCATION_LAST

标记调用事件ID的范围的最后一个整数ID。

另请参见：

Constant Field Values

runnable

protected Runnable runnable

Runnable的run（）方法将被调用。

notifier

protected volatile Object notifier

在Runnable.run（）方法返回或抛出异常之后或事件处理完毕后，将立即调用其notifyAll（）方法的（可能为空）的对象。

另请参见：

isDispatched()

catchExceptions

protected boolean catchExceptions

如果dispatch（）捕获Throwable并将其存储在异常实例变量中，则设置为true。 如果为false，则Throwables将传播到EventDispatchThread的调度循环。

构造方法详细信息

InvocationEvent

public InvocationEvent(Object source,
                       Runnable runnable)

构造具有InvocationEvent源的InvocationEvent，它将在run时执行runnable的run方法。

这是一个方便的构造函数。 形式InvocationEvent(source, runnable)的调用行为完全相同的方式为InvocationEvent(source, runnable, null, false)的调用。

此方法抛出IllegalArgumentException如果source是null 。

参数

source -该 Object发起事件

runnable -该 Runnable其 run方法将被执行

异常

IllegalArgumentException - 如果 source为空

另请参见：

EventObject.getSource() ， InvocationEvent(Object, Runnable, Object, boolean)

InvocationEvent

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

构造具有InvocationEvent源的InvocationEvent，它将在run时执行runnable的run方法。 如果通知是非null ， notifyAll()将它称为后立即run返回或抛出异常。

形式InvocationEvent(source, runnable, notifier, catchThrowables)的调用行为完全相同的方式为InvocationEvent(source, InvocationEvent.INVOCATION_DEFAULT, runnable, notifier, catchThrowables)的调用。

此方法抛出IllegalArgumentException如果source是null 。

参数

source -该 Object发起事件

runnable - Runnable的 run方法将被执行

notifier - Object其 notifyAll方法将在 Runnable.run后 Runnable.run已返回或抛出异常或事件被处理后

catchThrowables - 指定当执行 Runnable的 run方法时是否 dispatch应捕获Throwable，或者应该将这些Throwables传播到EventDispatchThread的调度循环

异常

IllegalArgumentException - 如果 source为空

另请参见：

EventObject.getSource() ， InvocationEvent(Object, int, Runnable, Object, boolean)

InvocationEvent

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

构造具有InvocationEvent源的InvocationEvent ，在分派时将执行runnable的run方法。 如果听者不null ， listener.run()将被调用后立即run又回来了，抛出一个异常，或者被设置在事件。

此方法抛出IllegalArgumentException如果source是null 。

参数

source -该 Object发起事件

runnable -该 Runnable其 run方法将被执行

listener - Runnable运行 run()方法将在 InvocationEvent之后被调用或处理

catchThrowables - 指定执行 Runnable的 run方法时是否 dispatch应该捕获Throwable，或者应该将这些Throwables传播到EventDispatchThread的调度循环

异常

IllegalArgumentException - 如果 source为空

InvocationEvent

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

构造具有InvocationEvent源和ID的InvocationEvent ，在分派时将执行runnable的run方法。 如果通知是非null ， notifyAll将它称为后立即run返回或抛出异常。

此方法抛出IllegalArgumentException如果source是null 。

参数

source -该 Object发起事件

id - 指示事件类型的整数。 有关允许值的信息，请参阅InvocationEvent的类说明

runnable -该 Runnable其 run方法将被执行

notifier - Object其 notifyAll方法将在 Runnable.run之后被调用返回或抛出异常或事件被处理之后

catchThrowables - 指定在执行 Runnable的 run方法时是否 dispatch应该捕获Throwable，或者应该将这些Throwables传播到EventDispatchThread的调度循环

异常

IllegalArgumentException - 如果 source为空

另请参见：

EventObject.getSource() ， AWTEvent.getID()

方法详细信息

dispatch

public void dispatch()

执行Runnable的 run()方法，并在 run()返回或引发异常时通知通知程序（如果有）。

Specified by:

dispatch在界面 ActiveEvent

另请参见：

isDispatched()

getException

public 异常 getException()

返回在执行Runnable的 run()方法时捕获的任何异常。

结果

引用异常，如果被抛出; 如果没有抛出异常，或者如果此InvocationEvent没有捕获异常，则为null

getThrowable

public Throwable getThrowable()

返回在执行Runnable的 run()方法时捕获的任何Throwable。

结果

引用Throwable如果被抛出; 如果没有抛出Throwable，或者如果此InvocationEvent不捕获Throwables，则为null

从以下版本开始：

1.5

getWhen

public long getWhen()

返回发生此事件的时间戳。

结果

这个事件的时间戳

从以下版本开始：

1.4

isDispatched

public boolean isDispatched()

如果true事件或调度时抛出任何异常，返回true， false返回false。 该方法应该被调用notifier.wait()方法的等待线程调用。 由于虚假唤醒是可能的（如Object.wait()中所述 ），该方法应该在等待循环中使用，以确保事件被分派：

  while (!event.isDispatched()) {
         notifier.wait();
     } 

如果等待线程在不调度事件的情况下唤醒，则isDispatched()方法返回false ，并且while循环再次执行，从而导致唤醒的线程恢复到等待模式。

如果notifier.notifyAll()发生在等待线程进入notifier.wait()方法之前， while循环确保等待线程不会进入notifier.wait()方法。 否则，不能保证等待线程从等待中醒来。

结果

true如果事件已经调度，或者调度时抛出任何异常， false false

从以下版本开始：

1.7

另请参见：

dispatch() ， notifier ， catchExceptions

paramString

public String paramString()

返回标识此事件的参数字符串。 此方法对于事件记录和调试很有用。

重写：

paramString在类别 AWTEvent

结果

标识事件及其属性的字符串