Package uk.ac.starlink.table.join
Class TextProgressIndicator
- java.lang.Object
-
- uk.ac.starlink.table.join.TextProgressIndicator
-
- All Implemented Interfaces:
ProgressIndicator
public class TextProgressIndicator extends java.lang.Object implements ProgressIndicator
ProgressIndicator which logs progress to an output stream.- Since:
- 24 Mar 2004
- Author:
- Mark Taylor (Starlink)
-
-
Constructor Summary
Constructors Constructor Description TextProgressIndicator(java.io.PrintStream out, boolean profile)Constructs a new indicator which will output to a given stream.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidendStage()Indicates that no moreProgressIndicator.setLevel(double)calls will be made until the nextProgressIndicator.startStage(java.lang.String).voidlogMessage(java.lang.String msg)Registers a comment about the progress of the algorithm.voidsetLevel(double level)Specifies that the work of the most recently-started stage is a certain proportion complete.voidstartStage(java.lang.String stage)Indicates that a number ofProgressIndicator.setLevel(double)calls may follow, followed by aProgressIndicator.endStage()call.
-
-
-
Method Detail
-
startStage
public void startStage(java.lang.String stage)
Description copied from interface:ProgressIndicatorIndicates that a number ofProgressIndicator.setLevel(double)calls may follow, followed by aProgressIndicator.endStage()call.- Specified by:
startStagein interfaceProgressIndicator- Parameters:
stage- name/description of the processing stage
-
setLevel
public void setLevel(double level)
Description copied from interface:ProgressIndicatorSpecifies that the work of the most recently-started stage is a certain proportion complete. Calls to this method must take place between paired calls toProgressIndicator.startStage(java.lang.String)andProgressIndicator.endStage(), preferably with non-decreasing values of level.The method may throw an InterruptedException as a message to the caller that the work should be interrupted. A caller which receives such an exception should stop using resources and tidy up as soon as is convenient.
- Specified by:
setLevelin interfaceProgressIndicator- Parameters:
level- value between 0. and 1. indicating amount of completion
-
endStage
public void endStage()
Description copied from interface:ProgressIndicatorIndicates that no moreProgressIndicator.setLevel(double)calls will be made until the nextProgressIndicator.startStage(java.lang.String).- Specified by:
endStagein interfaceProgressIndicator
-
logMessage
public void logMessage(java.lang.String msg)
Description copied from interface:ProgressIndicatorRegisters a comment about the progress of the algorithm. This should not be called between calls toProgressIndicator.startStage(java.lang.String)andProgressIndicator.endStage().- Specified by:
logMessagein interfaceProgressIndicator- Parameters:
msg- message
-
-