java.lang.Object java.util.EventObject java.awt.AWTEvent java.awt.event.InvocationEvent
An event which executes the run() method on a Runnable when dispatched by the AWT event dispatcher thread. This class can be used as a reference implementation of ActiveEvent rather than declaring a new class and defining dispatch().
Instances of this class are placed on the EventQueue by calls to invokeLater and invokeAndWait. Client code can use this fact to write replacement functions for invokeLater and invokeAndWait without writing special-case code in any AWTEventListener objects.
Field Summary | |
---|---|
protected boolean |
catchExceptions
Set to true if dispatch() catches Throwable |
static int |
INVOCATION_DEFAULT
The default id for all InvocationEvents. |
static int |
INVOCATION_FIRST
Marks the first integer id for the range of invocation event ids. |
static int |
INVOCATION_LAST
Marks the last integer id for the range of invocation event ids. |
protected Object |
notifier
The (potentially null) Object whose notifyAll() method will be called immediately after the Runnable.run() method returns. |
protected Runnable |
runnable
The Runnable whose run() method will be called. |
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 |
Constructor Summary | |
---|---|
protected |
InvocationEvent
(
Object
source, int id,
Runnable
runnable,
Object
Constructs an InvocationEvent with the specified source and ID which will execute the runnable's run method when dispatched. |
InvocationEvent
(
Object
source,
Runnable
runnable) Constructs an InvocationEvent with the specified source which will execute the runnable's run method when dispatched. |
|
InvocationEvent
(
Object
source,
Runnable
runnable,
Object
Constructs an InvocationEvent with the specified source which will execute the runnable's run method when dispatched. |
Method Summary | |
---|---|
void |
dispatch
() Executes the Runnable's run() method and notifies the notifier (if any) when run() returns. |
Exception |
getException
() Returns any Exception caught while executing the Runnable's run() method. |
Throwable |
getThrowable
()
Returns any Throwable caught while executing the Runnable's run() method. |
long |
getWhen
() Returns the timestamp of when this event occurred. |
String |
paramString
() Returns a parameter string identifying this event. |
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 |
Field Detail |
---|
public static final int INVOCATION_FIRST
public static final int INVOCATION_DEFAULT
public static final int INVOCATION_LAST
protected Runnable runnable
protected Object notifier
protected boolean catchExceptions
Constructor Detail |
---|
public InvocationEvent(Object source, Runnable runnable)
Note that passing in an invalid id results in unspecified behavior. This method throws an IllegalArgumentException if source is null.
public InvocationEvent(Object source, Runnable runnable, Object notifier, boolean catchThrowables)boolean catchExceptions)
Note that passing in an invalid id results in unspecified behavior. This method throws an IllegalArgumentException if source is null.
protected InvocationEvent(Object source, int id, Runnable runnable, Object notifier, boolean catchThrowables)boolean catchExceptions)
Note that passing in an invalid id results in unspecified behavior. This method throws an IllegalArgumentException if source is null.
Method Detail |
---|
public void dispatch()
public Exception getException()
public ThrowablegetThrowable ()
public long getWhen()
public String paramString()