java.awt.event
Class InvocationEvent
java.lang.Object
|
+--java.util.EventObject
|
+--java.awt.AWTEvent
|
+--java.awt.event.InvocationEvent
All Implemented Interfaces:
ActiveEvent, Serializable
This event executes Runnable#run() of a target object when it is
dispatched. This class is used by calls to invokeLater and
invokeAndWait, so client code can use this fact to avoid
writing special-casing AWTEventListener objects.
Since:Author:- Aaron M. Renn <arenn@urbanophile.com>
See Also:
INVOCATION_DEFAULT
public static final int INVOCATION_DEFAULTThis is the default id for this event type.
INVOCATION_FIRST
public static final int INVOCATION_FIRSTThis is the first id in the range of event ids used by this class.
INVOCATION_LAST
public static final int INVOCATION_LASTThis is the last id in the range of event ids used by this class.
catchExceptions
protected boolean catchExceptions This variable is set to true if exceptions are caught
and stored in a variable during the call to run(), otherwise
exceptions are ignored and propagate up.
notifier
protected Object notifier This is the object to call notifyAll() on when
the call to run() returns, or null if no
object is to be notified.
runnable
protected Runnable runnable This is the Runnable object to call when dispatched.
InvocationEvent
protected InvocationEvent(java.lang.Object source, int id, java.lang.Runnable runnable, java.lang.Object notifier, boolean catchExceptions) Initializes a new instance of InvocationEvent with the
specified source, runnable, and notifier. It will also catch exceptions
if specified. If notifier is non-null, this will call notifyAll() on
the object when the runnable is complete. If catchExceptions is true,
this traps any exception in the runnable, otherwise it lets the exception
propagate up the Event Dispatch thread. Note that an invalid id leads to
unspecified results.
Parameters:
InvocationEvent
public InvocationEvent(java.lang.Object source, java.lang.Runnable runnable) Initializes a new instance of InvocationEvent with the
specified source and runnable.
Parameters:
Throws:
InvocationEvent
public InvocationEvent(java.lang.Object source, java.lang.Runnable runnable, java.lang.Object notifier, boolean catchExceptions) Initializes a new instance of InvocationEvent with the
specified source, runnable, and notifier. It will also catch exceptions
if specified. If notifier is non-null, this will call notifyAll() on
the object when the runnable is complete. If catchExceptions is true,
this traps any exception in the runnable, otherwise it lets the exception
propagate up the Event Dispatch thread.
Parameters:
dispatch
public void dispatch() This method calls the run() method of the runnable, traps
exceptions if instructed to do so, and calls notifyAll()
on any notifier if all worked successfully.
getException
public Exception getException() This method returns the exception that occurred during the execution of
the runnable, or null if not exception was thrown or
exceptions were not caught.
Returns:
- the exception thrown by the runnable
getWhen
public long getWhen() Gets the timestamp of when this event was created.
Since:Returns:
- the timestamp of this event
paramString
public String paramString() This method returns a string identifying this event. This is formatted as:
"INVOCATION_DEFAULT,runnable=" + runnable + ",notifier=" + notifier
+ ",catchExceptions=" + catchExceptions + ",when=" + getWhen().
Returns:
- a string identifying this event
invokeLaterandinvokeAndWait, so client code can use this fact to avoid writing special-casing AWTEventListener objects.