de.up.ling.irtg.laboratory

Interface ResultManager

All Known Implementing Classes:

JsonResultManager, ResultManager.DummyManager, ResultManager.PrintingManager

public interface ResultManager

Handles the results obtained during parsing. For example, storing them, uploading them into a database, etc.

Author:

groschwitz

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ResultManager.DummyManager Does literally nothing.
static class	ResultManager.PrintingManager prints the results to System.err.

Method Summary

Modifier and Type	Method and Description
void	acceptError(Throwable error, int instanceID, String name, boolean doExport, boolean isGlobal) If an error occurred during the computation of the variable with the given name, this is called.
void	acceptResult(Object result, int instanceID, String name, boolean doExport, boolean isGlobal, boolean isNumeric) Accpets a result for the variable with the given name, for the given instance.
void	acceptTime(long time, int instanceID, String name, boolean isGlobal) Accepts a runtime for the watch with the given name, for the given instance.
void	finish() Marks the experiment as finished.
void	flush() Send data to the persistent storage.
int	getExperimentID() Returns the experiment ID in this result manager.

Method Detail

acceptResult

void acceptResult(Object result,
                  int instanceID,
                  String name,
                  boolean doExport,
                  boolean isGlobal,
                  boolean isNumeric)

Accpets a result for the variable with the given name, for the given instance.

Parameters:

result -

instanceID -

name -

doExport -

isGlobal -

isNumeric - whether the result is of numeric value (double, int,... or the wrapper class). Relevant mostly if result is null.

acceptTime

void acceptTime(long time,
                int instanceID,
                String name,
                boolean isGlobal)

Accepts a runtime for the watch with the given name, for the given instance. Time is in ms.

Parameters:

time -

instanceID -

name -

isGlobal -

acceptError

void acceptError(Throwable error,
                 int instanceID,
                 String name,
                 boolean doExport,
                 boolean isGlobal)

If an error occurred during the computation of the variable with the given name, this is called. AcceptResult is still called with result null.

Parameters:

error -

instanceID -

name -

doExport -

isGlobal -

flush

void flush()
    throws IOException

Send data to the persistent storage. For efficiency reasons, a ResultManager may cache results as they are presented to it. It will then only send the cached results to the persistent storage (database, file, etc.) when the flush() method is called. Notice the risk-efficiency tradeoff: flushing rarely will increase efficiency, but runs the risk of losing unflushed data.

Throws:

IOException

getExperimentID

int getExperimentID()

Returns the experiment ID in this result manager.

Returns:

finish

void finish()
     throws Exception

Marks the experiment as finished.

Throws:

Exception