toxgene.interfaces
Interface ToXgeneReporter


public interface ToXgeneReporter

Interface for coupling ToXgene with a reporting tool that provides feedback during a data generation session. Three kinds of messages are sent:

Note that fatal exceptional conditions are always reporter via ToXgeneErrorException exceptions.

Version:
0.1
Author:
Denilson Barbosa

Method Summary
 void explain(java.lang.String message)
          Receives an explanatory message that helps understand how ToXgene processes the template.
 void progress(java.lang.String message)
          Receives a message indacting the progress of the processing of the template, such as notifications of the start/end of parsing.
 void warning(java.lang.String message)
          Receives a warning message about a non-fatal exceptional situation during the processing of the template.
 

Method Detail

warning

public void warning(java.lang.String message)
Receives a warning message about a non-fatal exceptional situation during the processing of the template. This message should be sever enough that the user may be interested in seeing it.

Parameters:
message - a warning message

explain

public void explain(java.lang.String message)
Receives an explanatory message that helps understand how ToXgene processes the template. Most of these messages are produced during the parsing of the template and serve as "debugging" information. All these messages can be safely ignored.

Parameters:
message - an explanatory message

progress

public void progress(java.lang.String message)
Receives a message indacting the progress of the processing of the template, such as notifications of the start/end of parsing. All these messages can be safely ignored.

Some of the progress report messages are used to provide feedback on the completion of a task. This is done by printing "bakcspace" characters (i.e, '\b' followed by the percentage of the completion of the task. A more elaborate progress indicator could be implemented by decoding these messages.

Parameters:
message - a progress report message