com.xmlmind.guiutil

Class PossiblyLengthyTaskMonitor

java.lang.Object

com.xmlmind.guiutil.PossiblyLengthyTaskMonitor

All Implemented Interfaces:

ProgressMonitor

public final class PossiblyLengthyTaskMonitor
extends Object
implements ProgressMonitor

Not part of the public documented API: the ProgressMonitor used by a PossiblyLengthyTask when the task to be executed can be monitored.

Field Summary

Fields

Modifier and Type	Field and Description
String	messageLog
AtomicReference<ThreadMonitorDialog>	monitorDialog

Constructor Summary

Constructors

Constructor and Description
PossiblyLengthyTaskMonitor(AtomicReference<ThreadMonitorDialog> ref, String messageLog)

Method Summary

Modifier and Type	Method and Description
int	getAnimateMillis()
boolean	message(String message, Console.MessageType messageType) Invoked by the lengthy task to give this monitor information about the step being executed.
void	setAnimateMillis(int ms)
void	start() Invoked by the lengthy task to inform this monitor that the execution of the task has started.
boolean	step(int step) Invoked by the lengthy task to inform this monitor each time a new step is about to be executed.
boolean	stepCount(int stepCount) Invoked by the lengthy task to inform this monitor about the total numbers of steps comprising the task.
void	stop() Invoked by the lengthy task to inform this monitor that the execution of the task has stopped, whatever the reason (success, canceled, error).

Methods inherited from class java.lang.Object

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

Field Detail

monitorDialog

public final AtomicReference<ThreadMonitorDialog> monitorDialog

messageLog

public final String messageLog

Constructor Detail

PossiblyLengthyTaskMonitor

public PossiblyLengthyTaskMonitor(AtomicReference<ThreadMonitorDialog> ref,
                                  String messageLog)

Method Detail

setAnimateMillis

public void setAnimateMillis(int ms)

getAnimateMillis

public int getAnimateMillis()

start

public void start()

Description copied from interface: ProgressMonitor

Invoked by the lengthy task to inform this monitor that the execution of the task has started.

This method is guaranteed to be invoked once before any other method.

Specified by:

start in interface ProgressMonitor

stepCount

public boolean stepCount(int stepCount)

Description copied from interface: ProgressMonitor

Invoked by the lengthy task to inform this monitor about the total numbers of steps comprising the task.

This method is guaranteed to be invoked once before any invocation of ProgressMonitor.step(int). Therefore the simplest sequence of invocations is:

start
stepCount
step
step
...
step
stop

Note that in the above example, ProgressMonitor.message(java.lang.String, com.xmlmind.util.Console.MessageType) is never invoked.

Specified by:

stepCount in interface ProgressMonitor

Parameters:

stepCount - total numbers of steps comprising the lengthy task. This number is computed once for all. A negative value means that this number cannot be determined.

Returns:

false if this monitor wants to cancel the lengthy task; true otherwise

step

public boolean step(int step)

Description copied from interface: ProgressMonitor

Invoked by the lengthy task to inform this monitor each time a new step is about to be executed.

Specified by:

step in interface ProgressMonitor

Parameters:

step - current step. First step is step 0. Last step is step stepCount-1, when stepCount is strictly positive.

Returns:

false if this monitor wants to cancel the lengthy task; true otherwise

message

public boolean message(String message,
                       Console.MessageType messageType)

Description copied from interface: ProgressMonitor

Invoked by the lengthy task to give this monitor information about the step being executed.

This method may be invoked any number of times (including 0), at any time, between ProgressMonitor.start() and ProgressMonitor.stop().

Specified by:

message in interface ProgressMonitor

Parameters:

message - message containing information about the step being executed

messageType - type of message. May be null which is equivalent to INFO.

Returns:

false if this monitor wants to cancel the lengthy task; true otherwise

stop

public void stop()

Description copied from interface: ProgressMonitor

Invoked by the lengthy task to inform this monitor that the execution of the task has stopped, whatever the reason (success, canceled, error).

This method is guaranteed to be invoked once when ProgressMonitor.start() has also been invoked. No other method will be invoked after that.

Specified by:

stop in interface ProgressMonitor