org.expasy.mzjava.app.pb

Class ConsoleProgressBar

java.lang.Object

org.expasy.mzjava.app.pb.ConsoleProgressBar

All Implemented Interfaces:

ProgressBar

public final class ConsoleProgressBar
extends Object
implements ProgressBar

A simple terminal progress bar.

Description

A progress bar typically communicates the progress of some work by displaying its percentage of completion and possibly a textual display of this percentage.

A progression bar has 2 modes of execution. Depending on the a priori knowledge of the total steps, we have a Determinate mode or an Indeterminate mode.

The terminal progression bar is constituted of 2 parts:

1. the current processed step (over all steps) found in the Left Margin (LM)
2. the Progression Bar (PB) itself

Note that each LM and PB space lengths together with the length of the roaming segment in indeterminate mode are configurable. It is even possible to set the refreshing period of progression bar in this last mode.

Indeterminate Mode

   LM      PB
 < -- >< -------- >
    0  [=====     ]
    1  [ =====    ]
    2  [  =====   ]
    3  [   =====  ]
    4  [    ===== ]
    5  [     =====]
    6  [    ===== ]
    7  [   =====  ]
   ...
 

Determinate Mode

   LM      PB
 < -- >< -------- >
  0/10 [          ]
  1/10 [=         ]
  2/10 [==        ]
  3/10 [===       ]
  4/10 [====      ]
  5/10 [=====     ]
  6/10 [======    ]
  7/10 [=======   ]
  8/10 [========  ]
  9/10 [========= ]
 10/10 [==========]
 

Version:

1.0

Author:

nikitin

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConsoleProgressBar.View

Constructor Summary

Constructors

Constructor and Description
ConsoleProgressBar(ConsoleProgressBar.View view)

Method Summary

Methods

Modifier and Type	Method and Description
int	getValue()
void	incrementValue()
static ConsoleProgressBar	indeterminate()
static ConsoleProgressBar	indeterminate(ConsoleProgressBar.View view)
boolean	isIndeterminate() Return true if indeterminate
static ConsoleProgressBar	newInstance(int maximum)
static ConsoleProgressBar	newInstance(int maximum, ConsoleProgressBar.View view)
static ConsoleProgressBar	newInstance(int minimum, int maximum)
static ConsoleProgressBar	newInstance(int minimum, int maximum, ConsoleProgressBar.View view)
void	setBarLength(int length) Set the progress bar length.
void	setDoneMessage(String message)
void	setIncompleteMessage(String message)
void	setIndeterminate(boolean bool) Sets the indeterminate property of the progress bar which determines whether the progress bar is in determinate or indeterminate mode.
void	setLeftMarginLength(int length)
void	setMaximum(int maximum) Sets the progress bar's minimum value to n
void	setMaximumDoNoResetLeftMargin(int maximum)
void	setMinimum(int minimum) Sets the progress bar's maximum value to n
void	setPrintStream(PrintStream ps)
void	setRefreshBarPeriod(int period) Set the period of bar animation refresh while the bar is in indeterminate mode.
void	setSegmentLength(int length) Set the length of segment constantly animated in indeterminate mode.
void	setTaskName(String name) Set the task name (displayed in left margin)
void	setValue(int completed) Sets the progress bar's current value to n
void	setView(ConsoleProgressBar.View view)
void	start() Initialize progress bar (mandatory to restart bar in Indeterminate mode)
void	stop() Interrupt the task (mandatory to complete Inderminate mode)

Methods inherited from class java.lang.Object

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

Constructor Detail

ConsoleProgressBar

public ConsoleProgressBar(ConsoleProgressBar.View view)

Method Detail

newInstance

public static ConsoleProgressBar newInstance(int maximum)

newInstance

public static ConsoleProgressBar newInstance(int maximum,
                             ConsoleProgressBar.View view)

newInstance

public static ConsoleProgressBar newInstance(int minimum,
                             int maximum)

newInstance

public static ConsoleProgressBar newInstance(int minimum,
                             int maximum,
                             ConsoleProgressBar.View view)

indeterminate

public static ConsoleProgressBar indeterminate()

indeterminate

public static ConsoleProgressBar indeterminate(ConsoleProgressBar.View view)

setView

public void setView(ConsoleProgressBar.View view)

setTaskName

public void setTaskName(String name)

Description copied from interface: ProgressBar

Set the task name (displayed in left margin)

Specified by:

setTaskName in interface ProgressBar

setMinimum

public final void setMinimum(int minimum)

Description copied from interface: ProgressBar

Sets the progress bar's maximum value to n

Specified by:

setMinimum in interface ProgressBar

setMaximum

public final void setMaximum(int maximum)

Description copied from interface: ProgressBar

Sets the progress bar's minimum value to n

Specified by:

setMaximum in interface ProgressBar

setMaximumDoNoResetLeftMargin

public final void setMaximumDoNoResetLeftMargin(int maximum)

setLeftMarginLength

public void setLeftMarginLength(int length)

setBarLength

public void setBarLength(int length)

Set the progress bar length.

Parameters:

length - the given length.

setRefreshBarPeriod

public void setRefreshBarPeriod(int period)

Set the period of bar animation refresh while the bar is in indeterminate mode.

Parameters:

period - the period of refresh for cursor animation.

setSegmentLength

public void setSegmentLength(int length)

Set the length of segment constantly animated in indeterminate mode.

Parameters:

length - the given length (> 0 and < bar len).

setDoneMessage

public void setDoneMessage(String message)

setIncompleteMessage

public void setIncompleteMessage(String message)

setIndeterminate

public void setIndeterminate(boolean bool)

Description copied from interface: ProgressBar

Sets the indeterminate property of the progress bar which determines whether the progress bar is in determinate or indeterminate mode.

Specified by:

setIndeterminate in interface ProgressBar

start

public void start()

Initialize progress bar (mandatory to restart bar in Indeterminate mode)

stop

public void stop()

Interrupt the task (mandatory to complete Inderminate mode)

Note 1

If you want to restart another progression, you will have to call start() first.

setValue

public void setValue(int completed)

Description copied from interface: ProgressBar

Sets the progress bar's current value to n

Specified by:

setValue in interface ProgressBar

incrementValue

public void incrementValue()

getValue

public int getValue()

isIndeterminate

public final boolean isIndeterminate()

Description copied from interface: ProgressBar

Return true if indeterminate

Specified by:

isIndeterminate in interface ProgressBar

setPrintStream

public void setPrintStream(PrintStream ps)