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 ProgressWorker

All Implemented Interfaces:

Runnable, Future<T>, RunnableFuture<T>

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

A SwingWorker implementation. Instances of this class are not reusable.

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

The onStarted handler is guaranteed to be called on the Event Dispatch Thread before the background task executes, and the onDone handler is guaranteed to be called after the background task completes.

 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()

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ProgressWorker.Builder<T,V>	Builds a ProgressWorker instance.
static interface	ProgressWorker.BuilderFactory	Provides builders for a given task type.
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.ProgressTask<V>	A progress aware background task.
static interface	ProgressWorker.ResultTask<T>	A background task producing a result.
static interface	ProgressWorker.Task	A background task.

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

SwingWorker.StateValue

Nested classes/interfaces inherited from interface java.util.concurrent.Future

Future.State

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_MAXIMUM

Method Summary

Modifier and Type	Method	Description
static ProgressWorker.BuilderFactory	builder()
protected @Nullable 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

Methods inherited from interface java.util.concurrent.Future

exceptionNow, resultNow, state

Field Details

DEFAULT_MAXIMUM

public static final int DEFAULT_MAXIMUM

See Also:

• Constant Field Values

Method Details

builder

public static ProgressWorker.BuilderFactory builder()

Returns:

a ProgressWorker.BuilderFactory

doInBackground

protected @Nullable 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>