io.datafx.core.concurrent

Class ConcurrentUtils

java.lang.Object

io.datafx.core.concurrent.ConcurrentUtils

public class ConcurrentUtils
extends java.lang.Object

Utility class for concurrency issues in JavaFX

Method Summary

Modifier and Type	Method and Description
static javafx.beans.property.ReadOnlyBooleanProperty	createIsDoneProperty(javafx.concurrent.Worker<?> worker) Returns a property that defines the state of the given worker.
static <T> DataFxService<T>	createService(java.util.concurrent.Callable<T> callable)
static DataFxService<java.lang.Void>	createService(java.lang.Runnable runnable)
static <T> DataFxService<T>	createService(javafx.concurrent.Task<T> task)
static <T> javafx.concurrent.Worker<T>	executeService(java.util.concurrent.Executor executor, javafx.concurrent.Service<T> service)
static <V> javafx.beans.binding.BooleanBinding	isFinishedProperty(javafx.concurrent.Worker<V> worker)
static void	runAndWait(java.lang.Runnable runnable) Runs the given Runnable on the JavaFX Application Thread.
static <T> T	runCallableAndWait(java.util.concurrent.Callable<T> callable) Runs the given Callable on the JavaFX Application Thread.
static <T> void	then(javafx.concurrent.Worker<T> worker, java.util.function.Consumer<T> consumer) The given consumer will be called once the worker is finished.
static <T> T	waitFor(javafx.concurrent.Worker<T> worker) This methods blocks until the worker is done and returns the result value of the worker.

Methods inherited from class java.lang.Object

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

Method Detail

runAndWait

public static void runAndWait(java.lang.Runnable runnable)
                       throws java.lang.InterruptedException,
                              java.util.concurrent.ExecutionException

Runs the given Runnable on the JavaFX Application Thread. The method blocks until the Runnable is executed completely. You should use the ProcessChain for concurrent tasks and background tasks instead of using this low level API.

Parameters:

runnable - the runnable that will be executed on the JavaFX Application Thread

Throws:

java.lang.InterruptedException - if the JavaFX Application Thread was interrupted while waiting

java.util.concurrent.ExecutionException - if the call of the run method of the Runnable threw an exception

runCallableAndWait

public static <T> T runCallableAndWait(java.util.concurrent.Callable<T> callable)
                                throws java.lang.InterruptedException,
                                       java.util.concurrent.ExecutionException

Runs the given Callable on the JavaFX Application Thread. The method blocks until the Callable is executed completely. The return value of the call() method of the callable will be returned You should use the ProcessChain for concurrent tasks and background tasks instead of using this low level API.

Type Parameters:

T - return type of the callable

Parameters:

callable - the callable that will be executed on the JavaFX Application Thread

Returns:

return value of the executed call() method of the Callable

Throws:

java.lang.InterruptedException - if the JavaFX Application Thread was interrupted while waiting

java.util.concurrent.ExecutionException - if the call of the run method of the Callable threw an exception

createService

public static DataFxService<java.lang.Void> createService(java.lang.Runnable runnable)

createService

public static <T> DataFxService<T> createService(java.util.concurrent.Callable<T> callable)

createService

public static <T> DataFxService<T> createService(javafx.concurrent.Task<T> task)

executeService

public static <T> javafx.concurrent.Worker<T> executeService(java.util.concurrent.Executor executor,
                                                             javafx.concurrent.Service<T> service)

isFinishedProperty

public static <V> javafx.beans.binding.BooleanBinding isFinishedProperty(javafx.concurrent.Worker<V> worker)

then

public static <T> void then(javafx.concurrent.Worker<T> worker,
                            java.util.function.Consumer<T> consumer)

The given consumer will be called once the worker is finished. The result of the worker will be passed to the consumer.

Type Parameters:

T - the resukt type of the worker

Parameters:

worker - the worker

consumer - the consumer

createIsDoneProperty

public static javafx.beans.property.ReadOnlyBooleanProperty createIsDoneProperty(javafx.concurrent.Worker<?> worker)

Returns a property that defines the state of the given worker. Once the worker is done the value of the property will be set to true

Parameters:

worker - the worker

Returns:

the property

waitFor

public static <T> T waitFor(javafx.concurrent.Worker<T> worker)
                     throws java.lang.InterruptedException

This methods blocks until the worker is done and returns the result value of the worker. If the worker was canceled an exception will be thrown.

Type Parameters:

T - result type of the worker

Parameters:

worker - The worker

Returns:

the result

Throws:

java.lang.InterruptedException - if the worker was canceled