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 voidCauses 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 UiSynchronizerReturns a default instance of the synchronizer, ornullif it is not available at this time (e.g., when running headless).abstract ThreadReturns the user-interface thread the synchronizer uses to execute runnables.abstract voidCauses 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, ornullif 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
-