Package org.eclipse.handly.util
Class UiSynchronizer
java.lang.Object
org.eclipse.handly.util.UiSynchronizer
Allows to execute runnables in the user-interface thread.
- Restriction:
- This class is not intended to be extended by clients.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract void
Causes therun()
method of the runnable to be invoked by the user-interface thread at the next reasonable opportunity; the caller of this method continues to run in parallel, and is not notified when the runnable has completed.static UiSynchronizer
Returns a default instance of the synchronizer, ornull
if it is not available at this time (e.g., when running headless).abstract Thread
Returns the user-interface thread the synchronizer uses to execute runnables.abstract void
Causes therun()
method of the runnable to be invoked by the user-interface thread at the next reasonable opportunity; the thread which calls this method is suspended until the runnable completes.
-
Constructor Details
-
UiSynchronizer
public UiSynchronizer()
-
-
Method Details
-
getDefault
Returns a default instance of the synchronizer, ornull
if it is not available at this time (e.g., when running headless). -
getThread
Returns the user-interface thread the synchronizer uses to execute runnables.- Returns:
- the user-interface thread (not
null
) - Throws:
IllegalStateException
- if the synchronizer can no longer be accessed (e.g., the underlying display has been disposed)
-
asyncExec
Causes therun()
method of the runnable to be invoked by the user-interface thread at the next reasonable opportunity; the caller of this method continues to run in parallel, and is not notified when the runnable has completed.- Parameters:
runnable
- code to run on the user-interface thread (notnull
)- Throws:
IllegalStateException
- if the synchronizer can no longer be accessed (e.g., the underlying display has been disposed)
-
syncExec
Causes therun()
method of the runnable to be invoked by the user-interface thread at the next reasonable opportunity; the thread which calls this method is suspended until the runnable completes.- Parameters:
runnable
- code to run on the user-interface thread (notnull
)- Throws:
IllegalStateException
- if the synchronizer can no longer be accessed (e.g., the underlying display has been disposed)ExecutionException
- if an exception occurred when executing the runnable
-