com.sun.glass.ui

Class InvokeLaterDispatcher

java.lang.Object

java.lang.Thread

com.sun.glass.ui.InvokeLaterDispatcher

All Implemented Interfaces:

java.lang.Runnable

public final class InvokeLaterDispatcher
extends java.lang.Thread

A dispatcher for Application.invokeLater() that submits deferred runnables to the native system one by one. A native system may by default execute all submitted runnables before actually leaving a nested event loop. However, there is an assumption that a runnable that calls the Application.leaveNestedEventLoop() method must be the last runnable executed in the current inner event loop. The next runnable that might have already been submitted by client code, must be invoked in the context of the outer event loop. To satisfy this requirement the runnables must be submitted to the native system one by one. This allows for fine grain control over executing the deferred tasks when it comes to entering/leaving nested event loops despite of native system limitations.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	InvokeLaterDispatcher.Future
static interface	InvokeLaterDispatcher.InvokeLaterSubmitter An InvokeLaterDispatcher client implements this interface to allow the dispatcher to submit runnables to the native system.

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.concurrent.BlockingDeque<java.lang.Runnable>	deque
private InvokeLaterDispatcher.InvokeLaterSubmitter	invokeLaterSubmitter
private boolean	leavingNestedEventLoop
private java.lang.Object	LOCK
private boolean	nestedEventLoopEntered

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
InvokeLaterDispatcher(InvokeLaterDispatcher.InvokeLaterSubmitter invokeLaterSubmitter)

Method Summary

Modifier and Type	Method and Description
void	invokeAndWait(java.lang.Runnable runnable)
void	invokeLater(java.lang.Runnable command) Schedules execution of a runnable on the event thread.
void	notifyEnteringNestedEventLoop() Notifies that a nested event loop is going to be entered.
void	notifyLeavingNestedEventLoop() Notifies that the application is leaving a nested event loop.
void	notifyLeftNestedEventLoop() Notifies that the application has left a nested event loop.
void	run()

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

deque

private final java.util.concurrent.BlockingDeque<java.lang.Runnable> deque

LOCK

private final java.lang.Object LOCK

nestedEventLoopEntered

private boolean nestedEventLoopEntered

leavingNestedEventLoop

private volatile boolean leavingNestedEventLoop

invokeLaterSubmitter

private final InvokeLaterDispatcher.InvokeLaterSubmitter invokeLaterSubmitter

Constructor Detail

InvokeLaterDispatcher

public InvokeLaterDispatcher(InvokeLaterDispatcher.InvokeLaterSubmitter invokeLaterSubmitter)

Method Detail

run

public void run()

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread

invokeAndWait

public void invokeAndWait(java.lang.Runnable runnable)

invokeLater

public void invokeLater(java.lang.Runnable command)

Schedules execution of a runnable on the event thread.

See Also:

Application.invokeLater(Runnable)

notifyEnteringNestedEventLoop

public void notifyEnteringNestedEventLoop()

Notifies that a nested event loop is going to be entered. An InvokeLaterDispatcher client is responsible for calling this method just before the enterNestedEventLoop() is dispatched to the native system for actually starting the nested loop.

notifyLeavingNestedEventLoop

public void notifyLeavingNestedEventLoop()

Notifies that the application is leaving a nested event loop.

notifyLeftNestedEventLoop

public void notifyLeftNestedEventLoop()

Notifies that the application has left a nested event loop.