Package org.openstreetmap.josm.gui.progress

Class NullProgressMonitor

java.lang.Object

org.openstreetmap.josm.gui.progress.NullProgressMonitor

All Implemented Interfaces:

ProgressMonitor

public final class NullProgressMonitor
extends java.lang.Object
implements ProgressMonitor

A singleton progress monitor that does nothing.

Since:

1811

Nested Class Summary

Nested classes/interfaces inherited from interface org.openstreetmap.josm.gui.progress.ProgressMonitor

ProgressMonitor.CancelListener

Field Summary

Fields

Modifier and Type	Field	Description
static ProgressMonitor	INSTANCE	The unique instance

Fields inherited from interface org.openstreetmap.josm.gui.progress.ProgressMonitor

ALL_TICKS, DEFAULT_TICKS

Constructor Summary

Constructors

Modifier	Constructor	Description
private	NullProgressMonitor()

Method Summary

Modifier and Type	Method	Description
void	addCancelListener(ProgressMonitor.CancelListener listener)	Add listener for user abort action
void	appendLogMessage(java.lang.String message)	Appends a message to the log managed by the progress monitor.
void	beginTask(java.lang.String title)	Starts this progress monitor.
void	beginTask(java.lang.String title, int ticks)	Starts this progress monitor.
void	cancel()	Abort current operation, usually called when user somehow requested an abort
ProgressMonitor	createSubTaskMonitor(int ticks, boolean internal)	Creates subtasks monitor.
void	finishTask()	Finish this progress monitor, close the dialog or inform the parent progress monitor that it can continue with other tasks.
ProgressTaskId	getProgressTaskId()	Returns the task ID of the progress dialog Should be used only by PleaseWaitRunnable
int	getTicks()	Get the current number of work units
int	getTicksCount()	Get the total number of work units
java.awt.Component	getWindowParent()	Return the parent windows of progress dialog
void	indeterminateSubTask(java.lang.String title)	Subtask that will show progress running back and forth
void	invalidate()	Can be used if method receives ProgressMonitor, but it's not interested progress monitoring.
boolean	isCanceled()	Returns the state of user aborts
void	removeCancelListener(ProgressMonitor.CancelListener listener)	Remove listener for user abort action
void	setCustomText(java.lang.String text)	Shows additional text
void	setExtraText(java.lang.String text)	Show extra text after normal task title.
void	setProgressTaskId(ProgressTaskId taskId)	Set the task ID of the progress dialog Should be used only by PleaseWaitRunnable.
void	setTicks(int ticks)	Set the current number of work units
void	setTicksCount(int ticks)	Set the total number of work units
void	subTask(java.lang.String title)	Normal subtask
void	worked(int ticks)	Increase number of already done work units by ticks

Methods inherited from class java.lang.Object

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

Field Detail

INSTANCE

public static final ProgressMonitor INSTANCE

The unique instance

Constructor Detail

NullProgressMonitor

private NullProgressMonitor()

Method Detail

addCancelListener

public void addCancelListener(ProgressMonitor.CancelListener listener)

Description copied from interface: ProgressMonitor

Add listener for user abort action

Specified by:

addCancelListener in interface ProgressMonitor

Parameters:

listener - the listener for cancel operation

beginTask

public void beginTask(java.lang.String title)

Description copied from interface: ProgressMonitor

Starts this progress monitor. Must be called exactly once Ticks count is set to default value

Specified by:

beginTask in interface ProgressMonitor

Parameters:

title - title text of the task

beginTask

public void beginTask(java.lang.String title,
                      int ticks)

Description copied from interface: ProgressMonitor

Starts this progress monitor. Must be called exactly once

Specified by:

beginTask in interface ProgressMonitor

Parameters:

title - title text of the task

ticks - number of work units (see ProgressMonitor.setTicksCount(int ticks))

cancel

public void cancel()

Description copied from interface: ProgressMonitor

Abort current operation, usually called when user somehow requested an abort

Specified by:

cancel in interface ProgressMonitor

createSubTaskMonitor

public ProgressMonitor createSubTaskMonitor(int ticks,
                                            boolean internal)

Description copied from interface: ProgressMonitor

Creates subtasks monitor.

Specified by:

createSubTaskMonitor in interface ProgressMonitor

Parameters:

ticks - Number of work units that should be done when subtask finishes

internal - If true then subtask can't modify task title/custom text

Returns:

subtasks monitor

finishTask

public void finishTask()

Description copied from interface: ProgressMonitor

Finish this progress monitor, close the dialog or inform the parent progress monitor that it can continue with other tasks. Must be called at least once (if called multiply times then further calls are ignored)

Specified by:

finishTask in interface ProgressMonitor

getTicks

public int getTicks()

Description copied from interface: ProgressMonitor

Get the current number of work units

Specified by:

getTicks in interface ProgressMonitor

Returns:

Number of work units already done

indeterminateSubTask

public void indeterminateSubTask(java.lang.String title)

Description copied from interface: ProgressMonitor

Subtask that will show progress running back and forth

Specified by:

indeterminateSubTask in interface ProgressMonitor

Parameters:

title - Can be null, in that case task title is not changed

invalidate

public void invalidate()

Description copied from interface: ProgressMonitor

Can be used if method receives ProgressMonitor, but it's not interested progress monitoring. Basically replaces ProgressMonitor.beginTask(String) and ProgressMonitor.finishTask() This method can be also used in finally section if method expects that some exceptions might prevent it from passing progressMonitor away. If ProgressMonitor.beginTask(String) was already called then this method does nothing.

Specified by:

invalidate in interface ProgressMonitor

isCanceled

public boolean isCanceled()

Description copied from interface: ProgressMonitor

Returns the state of user aborts

Specified by:

isCanceled in interface ProgressMonitor

Returns:

true if user aborted operation

removeCancelListener

public void removeCancelListener(ProgressMonitor.CancelListener listener)

Description copied from interface: ProgressMonitor

Remove listener for user abort action

Specified by:

removeCancelListener in interface ProgressMonitor

Parameters:

listener - the listener for cancel operation

setCustomText

public void setCustomText(java.lang.String text)

Description copied from interface: ProgressMonitor

Shows additional text

Specified by:

setCustomText in interface ProgressMonitor

Parameters:

text - custom text

setExtraText

public void setExtraText(java.lang.String text)

Description copied from interface: ProgressMonitor

Show extra text after normal task title. Hack for ProgressInputStream to show number of kB already downloaded

Specified by:

setExtraText in interface ProgressMonitor

Parameters:

text - extra text

appendLogMessage

public void appendLogMessage(java.lang.String message)

Description copied from interface: ProgressMonitor

Appends a message to the log managed by the progress monitor.

Specified by:

appendLogMessage in interface ProgressMonitor

Parameters:

message - the log message. Ignored if null or white space only.

setTicks

public void setTicks(int ticks)

Description copied from interface: ProgressMonitor

Set the current number of work units

Specified by:

setTicks in interface ProgressMonitor

Parameters:

ticks - Number of work units already done

setTicksCount

public void setTicksCount(int ticks)

Description copied from interface: ProgressMonitor

Set the total number of work units

Specified by:

setTicksCount in interface ProgressMonitor

Parameters:

ticks - Number of total work units

subTask

public void subTask(java.lang.String title)

Description copied from interface: ProgressMonitor

Normal subtask

Specified by:

subTask in interface ProgressMonitor

Parameters:

title - Can be null, in that case task title is not changed

worked

public void worked(int ticks)

Description copied from interface: ProgressMonitor

Increase number of already done work units by ticks

Specified by:

worked in interface ProgressMonitor

Parameters:

ticks - number of ticks to add

getTicksCount

public int getTicksCount()

Description copied from interface: ProgressMonitor

Get the total number of work units

Specified by:

getTicksCount in interface ProgressMonitor

Returns:

Number of total work units

setProgressTaskId

public void setProgressTaskId(ProgressTaskId taskId)

Description copied from interface: ProgressMonitor

Set the task ID of the progress dialog Should be used only by PleaseWaitRunnable. If taskId <> null then "In background" button will be shown

Specified by:

setProgressTaskId in interface ProgressMonitor

Parameters:

taskId - the task ID

getProgressTaskId

public ProgressTaskId getProgressTaskId()

Description copied from interface: ProgressMonitor

Returns the task ID of the progress dialog Should be used only by PleaseWaitRunnable

Specified by:

getProgressTaskId in interface ProgressMonitor

Returns:

the task ID

getWindowParent

public java.awt.Component getWindowParent()

Description copied from interface: ProgressMonitor

Return the parent windows of progress dialog

Specified by:

getWindowParent in interface ProgressMonitor

Returns:

component suitable as parent for dialogs that wants to be shown in front of progress dialog