Package com.nomagic.task
Interface ProgressStatus
- All Known Implementing Classes:
EmptyProgressStatus,SimpleProgressStatus
@OpenApiAll
public interface ProgressStatus
Progress status interface.
Usually used when performing long task to show task progress status.
Can be implemented in various ways, represented in GUI.
-
Method Summary
Modifier and TypeMethodDescriptiondefault voidThrowCanceledExceptionwhen progress has been canceled.longGet current progress value.Get progress description.longgetMax()Get progress maximum value.longgetMin()Get progress minimum value.intGet completed percentage.voidincrease()Increment progress current value.voidInitialize progress.voidInitialize progress.voidInitialize progress.booleanisCancel()booleanChecks if progress status completed.booleanChecks if progres status is indeterminate,booleanisLocked()Check if progress status is locked.voidreset()Reset progress status.voidsetCancel(boolean cancel) Call this when want current operation be canceled.voidsetCurrent(long current) Set progress current value.voidsetDescription(String description) Set progress description.voidsetIndeterminate(boolean indeterminate) Set progress status as indeterminate.voidsetLocked(boolean lock) Lock the progress status.voidsetMax(long max) Set progress maximum value.voidsetMin(long min) Set progress minimum value.
-
Method Details
-
setMin
void setMin(long min) Set progress minimum value.- Parameters:
min- minimum value
-
setMax
void setMax(long max) Set progress maximum value.- Parameters:
max- maximum value
-
setCurrent
void setCurrent(long current) Set progress current value.- Parameters:
current- current value
-
setDescription
Set progress description.- Parameters:
description- progress description
-
getPercentage
int getPercentage()Get completed percentage.- Returns:
- completed percentage
-
getMin
long getMin()Get progress minimum value.- Returns:
- minimum value
-
getMax
long getMax()Get progress maximum value.- Returns:
- maximum value
-
getCurrent
long getCurrent()Get current progress value.- Returns:
- current value
-
getDescription
String getDescription()Get progress description.- Returns:
- progress description
-
reset
void reset()Reset progress status. -
increase
void increase()Increment progress current value. -
init
Initialize progress.- Parameters:
description- progress description.min- minimum value.max- maximum value.current- current value.
-
init
Initialize progress.- Parameters:
description- progress description.min- minimum value.max- maximum value.
-
init
Initialize progress.- Parameters:
description- progress description.max- maximum value.
-
isCompleted
boolean isCompleted()Checks if progress status completed.- Returns:
truewhen progress status completed
-
setIndeterminate
void setIndeterminate(boolean indeterminate) Set progress status as indeterminate.- Parameters:
indeterminate-truefor progress status as indeterminate.
-
isIndeterminate
boolean isIndeterminate()Checks if progres status is indeterminate,- Returns:
truewhen progress status as indeterminate.
-
setLocked
void setLocked(boolean lock) Lock the progress status. Locked status does not change progress value.- Parameters:
lock-truefor progress status locking.
-
isLocked
boolean isLocked()Check if progress status is locked.- Returns:
truewhen progress status is locked.
-
setCancel
void setCancel(boolean cancel) Call this when want current operation be canceled. Actual operation can not support cancel.- Parameters:
cancel- new cancel value.
-
isCancel
boolean isCancel()- Returns:
- true if current operation is requested to be canceled.
-
cancelIfCanceled
default void cancelIfCanceled()ThrowCanceledExceptionwhen progress has been canceled.
-