examples
Class LoadImageTask

java.lang.Object
  org.jdesktop.swingworker.SwingWorker<T,V>
      org.jdesktop.application.Task<java.awt.image.BufferedImage,java.lang.Void>
          examples.LoadImageTask

All Implemented Interfaces:

java.lang.Runnable, java.util.concurrent.Future<java.awt.image.BufferedImage>

public class LoadImageTask
extends Task<java.awt.image.BufferedImage,java.lang.Void>

A Task that loads an image from a URL. Loading and decoding progress is reported via the Task progress property and messages are generated when the Task begins and when it finishes. If errors occur then warnings are logged and the Task's value is null.

Applications would typically use LoadImageTask by creating a private subclass that overrode the done method. See SingleFrameExample5.java for an example.

Resources for this class are in the resources/LoadImageTask.properties ResourceBundle.

Nested Class Summary

Nested classes/interfaces inherited from class org.jdesktop.application.Task

Task.BlockingScope, Task.InputBlocker

Nested classes/interfaces inherited from class org.jdesktop.swingworker.SwingWorker

org.jdesktop.swingworker.SwingWorker.StateValue

Constructor Summary

LoadImageTask(Application app, java.net.URL url)

Method Summary

protected void	cancelled() Called when this Task has been cancelled by SwingWorker.cancel(boolean).
protected java.awt.image.BufferedImage	doInBackground()
protected void	failed(java.lang.Throwable e) Called when an execution of this Task fails and an ExecutionExecption is thrown by get.
protected void	finished() Called unconditionally (in a finally clause) after one of the completion methods, succeeded, failed, cancelled, or interrupted, runs.
protected java.net.URL	getImageURL()
protected void	interrupted(java.lang.InterruptedException e) Called if the Task's Thread is interrupted but not explicitly cancelled.
protected void	succeeded(java.awt.image.BufferedImage image) Called when this Task has successfully completed, i.e.

Methods inherited from class org.jdesktop.application.Task

addTaskListener, done, getApplication, getContext, getDescription, getExecutionDuration, getInputBlocker, getMessage, getMessageDuration, getResourceMap, getTaskListeners, getTaskService, getTitle, getUserCanCancel, isPending, isProgressPropertyValid, isStarted, message, process, removeTaskListener, resourceName, setDescription, setInputBlocker, setMessage, setProgress, setProgress, setProgress, setTitle, setUserCanCancel

Methods inherited from class org.jdesktop.swingworker.SwingWorker

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

Methods inherited from class java.lang.Object

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

Constructor Detail

LoadImageTask

public LoadImageTask(Application app,
                     java.net.URL url)

Method Detail

getImageURL

protected final java.net.URL getImageURL()

doInBackground

protected java.awt.image.BufferedImage doInBackground()

Specified by:

doInBackground in class org.jdesktop.swingworker.SwingWorker<java.awt.image.BufferedImage,java.lang.Void>

cancelled

protected void cancelled()

Description copied from class: Task

Called when this Task has been cancelled by SwingWorker.cancel(boolean).

This method runs on the EDT. It does nothing by default.

Overrides:

cancelled in class Task<java.awt.image.BufferedImage,java.lang.Void>

See Also:

Task.done()

interrupted

protected void interrupted(java.lang.InterruptedException e)

Description copied from class: Task

Called if the Task's Thread is interrupted but not explicitly cancelled.

This method runs on the EDT. It does nothing by default.

Overrides:

interrupted in class Task<java.awt.image.BufferedImage,java.lang.Void>

Parameters:

e - the InterruptedException thrown by get

See Also:

SwingWorker.cancel(boolean), Task.done(), SwingWorker.get()

succeeded

protected void succeeded(java.awt.image.BufferedImage image)

Description copied from class: Task

Called when this Task has successfully completed, i.e. when its get method returns a value. Tasks that compute a value should override this method.

This method runs on the EDT. It does nothing by default.

Overrides:

succeeded in class Task<java.awt.image.BufferedImage,java.lang.Void>

Parameters:

image - the value returned by the get method

See Also:

Task.done(), SwingWorker.get(), Task.failed(java.lang.Throwable)

failed

protected void failed(java.lang.Throwable e)

Description copied from class: Task

Called when an execution of this Task fails and an ExecutionExecption is thrown by get.

This method runs on the EDT. It Logs an error message by default.

Overrides:

failed in class Task<java.awt.image.BufferedImage,java.lang.Void>

Parameters:

e - the cause of the ExecutionException

See Also:

Task.done(), SwingWorker.get(), Task.failed(java.lang.Throwable)

finished

protected void finished()

Description copied from class: Task

Called unconditionally (in a finally clause) after one of the completion methods, succeeded, failed, cancelled, or interrupted, runs. Subclasses can override this method to cleanup before the done method returns.

This method runs on the EDT. It does nothing by default.

Overrides:

finished in class Task<java.awt.image.BufferedImage,java.lang.Void>

See Also:

Task.done(), SwingWorker.get(), Task.failed(java.lang.Throwable)