org.hkijena.jipipe.api

Class JIPipeProgressInfo

java.lang.Object

org.hkijena.jipipe.api.JIPipeProgressInfo

All Implemented Interfaces:

Cancelable

Direct Known Subclasses:

JIPipePercentageProgressInfo

public class JIPipeProgressInfo
extends Object
implements Cancelable

This object is available inside a JIPipeRunnable and contains methods to report progress, logs, and request cancellation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JIPipeProgressInfo.StatusUpdatedEvent

Constructor Summary

Constructors

Constructor and Description
JIPipeProgressInfo()
JIPipeProgressInfo(JIPipeProgressInfo other)

Method Summary

Modifier and Type	Method and Description
void	addMaxProgress(int maxProgress)
void	addProgress(int progress)
void	cancel()
void	cancel(String reason)
void	clearLog()
JIPipeProgressInfo	detachProgress() Creates a sub-progress that detaches the references to the global process counters.
String	getCancelReason()
EventBus	getEventBus()
StringBuilder	getLog()
int	getMaxProgress()
int	getProgress()
void	incrementProgress()
boolean	isCanceled()
boolean	isCancelled()
boolean	isDetachedProgress() Returns true if the progress was detached from the root JIPipeProgressInfo
boolean	isLogToStdOut()
void	log(String message) Writes a message into the log
JIPipePercentageProgressInfo	percentage(String text)
JIPipeProgressInfo	resolve(String logPrepend) Creates a sub-progress that has the same cancellation and progress, but shows the new category in front of sub-messages
JIPipeProgressInfo	resolve(String text, int index, int size) Creates a sub-progress that has the same cancellation and progress, but shows the new category in front of sub-messages.
JIPipeProgressInfo	resolveAndLog(String logPrepend) Applies resolve(logPrepend) and then logs an empty message
JIPipeProgressInfo	resolveAndLog(String text, int index, int size) Creates a sub-progress that has the same cancellation and progress, but shows the new category in front of sub-messages.
void	resolveAndLogForEach(String text, byte[] collection, BiConsumer<Byte,JIPipeProgressInfo> function) Applies a for-each operation where the progress is logged
<T> void	resolveAndLogForEach(String text, Collection<T> collection, BiConsumer<T,JIPipeProgressInfo> function) Applies a for-each operation where the progress is logged
void	resolveAndLogForEach(String text, double[] collection, BiConsumer<Double,JIPipeProgressInfo> function) Applies a for-each operation where the progress is logged
void	resolveAndLogForEach(String text, float[] collection, BiConsumer<Float,JIPipeProgressInfo> function) Applies a for-each operation where the progress is logged
void	resolveAndLogForEach(String text, int[] collection, BiConsumer<Integer,JIPipeProgressInfo> function) Applies a for-each operation where the progress is logged
void	resolveAndLogForEach(String text, long[] collection, BiConsumer<Long,JIPipeProgressInfo> function) Applies a for-each operation where the progress is logged
void	resolveAndLogForEach(String text, short[] collection, BiConsumer<Short,JIPipeProgressInfo> function) Applies a for-each operation where the progress is logged
<T> void	resolveAndLogForEach(String text, T[] collection, BiConsumer<T,JIPipeProgressInfo> function) Applies a for-each operation where the progress is logged
void	setLogToStdOut(boolean value)
void	setMaxProgress(int maxProgress)
void	setProgress(int progress)
void	setProgress(int count, int total) Sets the progress and max progress

Methods inherited from class java.lang.Object

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

Constructor Detail

JIPipeProgressInfo

public JIPipeProgressInfo()

JIPipeProgressInfo

public JIPipeProgressInfo(JIPipeProgressInfo other)

Method Detail

clearLog

public void clearLog()

incrementProgress

public void incrementProgress()

getProgress

public int getProgress()

setProgress

public void setProgress(int progress)

getMaxProgress

public int getMaxProgress()

setMaxProgress

public void setMaxProgress(int maxProgress)

isCancelled

public boolean isCancelled()

isCanceled

public boolean isCanceled()

Specified by:

isCanceled in interface Cancelable

cancel

public void cancel(String reason)

Specified by:

cancel in interface Cancelable

getCancelReason

public String getCancelReason()

Specified by:

getCancelReason in interface Cancelable

cancel

public void cancel()

getLog

public StringBuilder getLog()

isLogToStdOut

public boolean isLogToStdOut()

setLogToStdOut

public void setLogToStdOut(boolean value)

log

public void log(String message)

Writes a message into the log

Parameters:

message - the message

isDetachedProgress

public boolean isDetachedProgress()

Returns true if the progress was detached from the root JIPipeProgressInfo

Returns:

if the progress was detached

detachProgress

public JIPipeProgressInfo detachProgress()

Creates a sub-progress that detaches the references to the global process counters.

Returns:

progress info with the same properties as the current one, but with a detached progress

resolve

public JIPipeProgressInfo resolve(String logPrepend)

Creates a sub-progress that has the same cancellation and progress, but shows the new category in front of sub-messages

Parameters:

logPrepend - the category

Returns:

progress info with the same properties as the current one, but with messages prepended

resolve

public JIPipeProgressInfo resolve(String text,
                                  int index,
                                  int size)

Creates a sub-progress that has the same cancellation and progress, but shows the new category in front of sub-messages. This is a shortcut for resolve(text + " " + (index + 1) + "/" + size)

Parameters:

text - the category

index - index of the index operation

size - size of the index operation

Returns:

progress info with the same properties as the current one, but with messages prepended

resolveAndLog

public JIPipeProgressInfo resolveAndLog(String logPrepend)

Applies resolve(logPrepend) and then logs an empty message

Parameters:

logPrepend - the category

Returns:

progress info with the same properties as the current one, but with messages prepended

resolveAndLog

public JIPipeProgressInfo resolveAndLog(String text,
                                        int index,
                                        int size)

Creates a sub-progress that has the same cancellation and progress, but shows the new category in front of sub-messages. Shortcut for resolveAndLog(text + " " + (index + 1) + "/" + size)

Parameters:

text - the category

index - index of the index operation

size - size of the index operation

Returns:

progress info with the same properties as the current one, but with messages prepended

resolveAndLogForEach

public <T> void resolveAndLogForEach(String text,
                                     Collection<T> collection,
                                     BiConsumer<T,JIPipeProgressInfo> function)

Applies a for-each operation where the progress is logged

Type Parameters:

T - collection contents

Parameters:

text - the text

collection - the iterated collection

function - the function executed for each item in the collection

resolveAndLogForEach

public <T> void resolveAndLogForEach(String text,
                                     T[] collection,
                                     BiConsumer<T,JIPipeProgressInfo> function)

Applies a for-each operation where the progress is logged

Type Parameters:

T - collection contents

Parameters:

text - the text

collection - the iterated collection

function - the function executed for each item in the collection

resolveAndLogForEach

public void resolveAndLogForEach(String text,
                                 int[] collection,
                                 BiConsumer<Integer,JIPipeProgressInfo> function)

Applies a for-each operation where the progress is logged

Parameters:

text - the text

collection - the iterated collection

function - the function executed for each item in the collection

resolveAndLogForEach

public void resolveAndLogForEach(String text,
                                 byte[] collection,
                                 BiConsumer<Byte,JIPipeProgressInfo> function)

Applies a for-each operation where the progress is logged

Parameters:

text - the text

collection - the iterated collection

function - the function executed for each item in the collection

resolveAndLogForEach

public void resolveAndLogForEach(String text,
                                 long[] collection,
                                 BiConsumer<Long,JIPipeProgressInfo> function)

Applies a for-each operation where the progress is logged

Parameters:

text - the text

collection - the iterated collection

function - the function executed for each item in the collection

resolveAndLogForEach

public void resolveAndLogForEach(String text,
                                 short[] collection,
                                 BiConsumer<Short,JIPipeProgressInfo> function)

Applies a for-each operation where the progress is logged

Parameters:

text - the text

collection - the iterated collection

function - the function executed for each item in the collection

resolveAndLogForEach

public void resolveAndLogForEach(String text,
                                 float[] collection,
                                 BiConsumer<Float,JIPipeProgressInfo> function)

Applies a for-each operation where the progress is logged

Parameters:

text - the text

collection - the iterated collection

function - the function executed for each item in the collection

resolveAndLogForEach

public void resolveAndLogForEach(String text,
                                 double[] collection,
                                 BiConsumer<Double,JIPipeProgressInfo> function)

Applies a for-each operation where the progress is logged

Parameters:

text - the text

collection - the iterated collection

function - the function executed for each item in the collection

setProgress

public void setProgress(int count,
                        int total)

Sets the progress and max progress

Parameters:

count - the progress

total - the max progress

getEventBus

public EventBus getEventBus()

addMaxProgress

public void addMaxProgress(int maxProgress)

addProgress

public void addProgress(int progress)

percentage

public JIPipePercentageProgressInfo percentage(String text)