ucar.nc2.ui.widget

Class ProgressMonitor

java.lang.Object

ucar.nc2.ui.widget.ProgressMonitor

public class ProgressMonitor
extends java.lang.Object

This wraps a javax.swing.ProgressMonitor, which allows tasks to be canceled. This class adds extra behavior to javax.swing.ProgressMonitor:

1. Pass in the ProgressMonitorTask you want to monitor.
2. Throws an actionEvent (on the AWT event thread) when the task is done.
3. If an error, pops up an error message.
4. Get status: success/failed/cancel when task is done.

The ProgressMonitorTask is run in a background thread while a javax.swing.ProgressMonitor dialog box shows progress. The task is checked every second to see if its done or canceled.

  Example:

 AddDatasetTask task = new AddDatasetTask(datasets);
 ProgressMonitor pm = new ProgressMonitor(task);
 pm.addActionListener( new ActionListener() {
 public void actionPerformed(ActionEvent e) {
 if (e.getActionCommand().equals("success")) {
 doGoodStuff();
 }
 }
 });
 pm.start( this, "Add Datasets", datasets.size());

 class AddDatasetTask extends ProgressMonitorTask {
 private List datasets;

 OpenDatasetTask(List datasets) { this.datasets = datasets; }

 public void run() {
 Iterator iter = datasets.iterator();
 while (iter.hasNext()) {
 AddeDataset ads = (AddeDataset) iter.next();
 this.note = ads.filenameReletive();
 try {
 ads.addImageData( currentSM.serverInfo(), results, false);
 } catch (IOException ioe) {
 error = ioe.getMessage();
 break;
 }
 if (cancel) break;
 this.progress++;
 }
 success = !cancel && !isError();
 done = true;    // do last!
 }
 }
 

See Also:

ProgressMonitorTask

Constructor Summary

Constructors

Constructor and Description
ProgressMonitor(ProgressMonitorTask task)
ProgressMonitor(ProgressMonitorTask task, int millisToPopup, int millisToDecideToPopup)

Method Summary

Modifier and Type	Method and Description
void	addActionListener(java.awt.event.ActionListener l) Add listener: action event sent when task is done.
ProgressMonitorTask	getTask()
void	removeActionListener(java.awt.event.ActionListener l) Remove listener
void	start(java.awt.Component top, java.lang.String taskName, int progressMaxCount) Call this from awt event thread.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProgressMonitor

public ProgressMonitor(ProgressMonitorTask task)

ProgressMonitor

public ProgressMonitor(ProgressMonitorTask task,
                       int millisToPopup,
                       int millisToDecideToPopup)

Method Detail

getTask

public ProgressMonitorTask getTask()

addActionListener

public void addActionListener(java.awt.event.ActionListener l)

Add listener: action event sent when task is done. event.getActionCommand() =

• "success"
• "error"
• "cancel"
• "done" if done, but success/error/cancel not set

removeActionListener

public void removeActionListener(java.awt.event.ActionListener l)

Remove listener

start

public void start(java.awt.Component top,
                  java.lang.String taskName,
                  int progressMaxCount)

Call this from awt event thread. The task is run in a background thread.

Parameters:

top - put ProgressMonitor on top of this component (may be null)

taskName - display name of task

progressMaxCount - maximum number of Progress indicator