Module is.codion.swing.common.model

Package is.codion.swing.common.model.worker

Class ProgressWorker<T,V>

java.lang.Object

javax.swing.SwingWorker<T,V>

is.codion.swing.common.model.worker.ProgressWorker<T,V>

Type Parameters:

T - the type of result this ProgressWorker produces.

V - the type of intermediate result produced by this worker

All Implemented Interfaces:

Runnable, Future<T>, RunnableFuture<T>

public final class ProgressWorker<T,V>
extends SwingWorker<T,V>

A SwingWorker implementation. Note that instances of this class are not reusable.

Note that this class does NOT coalesce progress reports or intermediate result publishing, but simply pushes those directly to the onProgress and onPublish handlers to run on the Event Dispatch Thread.

 ProgressWorker.builder(this::performTask)
   .onStarted(this::displayDialog)
   .onDone(this::closeDialog)
   .onResult(this::handleResult)
   .onProgress(this::displayProgress)
   .onPublish(this::publishMessage)
   .onCancelled(this::displayCancelledMessage)
   .onException(this::displayException)
   .execute();
 

See Also:

• builder(ResultTask)
• builder(ProgressResultTask)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ProgressWorker.Builder<T,V>	Builds a ProgressWorker instance.
static interface	ProgressWorker.ProgressReporter<V>	Reports progress and publishes intermediate results for a ProgressWorker
static interface	ProgressWorker.ProgressResultTask<T,V>	A progress aware background task producing a result.
static interface	ProgressWorker.ResultTask<T>	A background task producing a result.

Nested classes/interfaces inherited from class javax.swing.SwingWorker

SwingWorker.StateValue

Method Summary

Modifier and Type	Method	Description
static <T, V> ProgressWorker.Builder<T,V>	builder(ProgressWorker.ProgressResultTask<T,V> task)
static <T> ProgressWorker.Builder<T,?>	builder(ProgressWorker.ResultTask<T> task)
protected T	doInBackground()
protected void	done()

Methods inherited from class javax.swing.SwingWorker

addPropertyChangeListener, cancel, execute, firePropertyChange, get, get, getProgress, getPropertyChangeSupport, getState, isCancelled, isDone, process, publish, removePropertyChangeListener, run, setProgress

Methods inherited from class java.lang.Object

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

Method Details

builder

public static <T> ProgressWorker.Builder<T,?> builder(ProgressWorker.ResultTask<T> task)

Type Parameters:

T - the worker result type

Parameters:

task - the task to run

Returns:

a new ProgressWorker.Builder instance

builder

public static <T,
V> ProgressWorker.Builder<T,V> builder(ProgressWorker.ProgressResultTask<T,V> task)

Type Parameters:

T - the worker result type

V - the intermediate result type

Parameters:

task - the task to run

Returns:

a new ProgressWorker.Builder instance

doInBackground

protected T doInBackground()
                    throws Exception

Specified by:

doInBackground in class SwingWorker<T,V>

Throws:

Exception

done

protected void done()

Overrides:

done in class SwingWorker<T,V>