Interface InterfaceReport

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static int FORMAT_DEFAULT
      Indicates default formatting.
      static int FORMAT_ERROR
      Indicates error formatting.
      static int FORMAT_HEADLINE
      Indicates headline formatting.
      static int FORMAT_NOTE
      Indicates note formatting.
      static int FORMAT_OK
      Indicates OK formatting.
      static int FORMAT_WARNING
      Indicates warning formatting.
      static java.lang.String REPORT_TYPE_EXTENDED
      Request parameter value that this report should create an "extended" output.
      static java.lang.String REPORT_TYPE_SIMPLE
      Request parameter value that this report should create a "simple" output.
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void addError​(java.lang.Object obj)
      Adds an error object to the list of errors that occured during the report.
      void addLogFile​(java.lang.String logFileName)
      Add a log file to the report.
      void addWarning​(java.lang.Object obj)
      Adds a warning object to the list of warnings that occured during the report.
      java.lang.String closeLogFile()
      Close log file if necessary.
      java.lang.String formatRuntime()
      Formats the runtime formatted as "hh:mm:ss".
      java.util.List<java.lang.Object> getErrors()
      Returns a list of all errors that occured during the report.
      java.util.Locale getLocale()
      Returns the locale this report was initialized with.
      java.lang.String getReportUpdate()
      Updates this report, this processes all new output added since the last call to this method.
      long getRuntime()
      Returns the time this report has been running.
      long getSequenceNum()  
      java.util.List<java.lang.Object> getWarnings()
      Returns a list of all warnings that occured during the report.
      boolean hasError()
      Returns if the report generated an error output.
      boolean hasWarning()
      Returns if the report generated a warning output.
      void print​(java.lang.String uiLabel)
      Prints a localized message to the report.
      void print​(java.lang.String uiLabel, int format)
      Prints a localized message to the report, using the indicated formatting.
      void println()
      Adds a line break to the report.
      void println​(java.lang.String uiLabel)
      Prints a localized message to the report.
      void println​(java.lang.String uiLabel, int format)
      Prints a localized message to the report, using the indicated formatting.
      void println​(java.lang.Throwable t)
      Adds an Exception to the report, ensuring that the Exception content is processed to generate a valid output esp.
      void printMessageWithParam​(int m, int n, java.lang.String uiLabel, java.lang.Object param)
      Convenience method to print a localized message, followed by a parameter and dots to the report.
      void printMessageWithParam​(java.lang.String uiLabel, java.lang.Object param)
      Prints a localized message followed by a parameter and dots to the report.
      void resetRuntime()
      Resets the runtime to 0 milliseconds.
      void setSequenceNum​(long sequenceNum)
      Set log's sequence number.
    • Field Detail

      • FORMAT_DEFAULT

        static final int FORMAT_DEFAULT
        Indicates default formatting.
        See Also:
        Constant Field Values
      • FORMAT_ERROR

        static final int FORMAT_ERROR
        Indicates error formatting.
        See Also:
        Constant Field Values
      • FORMAT_HEADLINE

        static final int FORMAT_HEADLINE
        Indicates headline formatting.
        See Also:
        Constant Field Values
      • FORMAT_WARNING

        static final int FORMAT_WARNING
        Indicates warning formatting.
        See Also:
        Constant Field Values
      • REPORT_TYPE_EXTENDED

        static final java.lang.String REPORT_TYPE_EXTENDED
        Request parameter value that this report should create an "extended" output.
        See Also:
        Constant Field Values
      • REPORT_TYPE_SIMPLE

        static final java.lang.String REPORT_TYPE_SIMPLE
        Request parameter value that this report should create a "simple" output.
        See Also:
        Constant Field Values
    • Method Detail

      • addError

        void addError​(java.lang.Object obj)
        Adds an error object to the list of errors that occured during the report.

        Parameters:
        obj - the error object
      • addWarning

        void addWarning​(java.lang.Object obj)
        Adds a warning object to the list of warnings that occured during the report.

        Parameters:
        obj - the error object
      • formatRuntime

        java.lang.String formatRuntime()
        Formats the runtime formatted as "hh:mm:ss".

        Returns:
        the runtime formatted as "hh:mm:ss"
      • getErrors

        java.util.List<java.lang.Object> getErrors()
        Returns a list of all errors that occured during the report.

        Returns:
        an error list that occured during the report
      • getLocale

        java.util.Locale getLocale()
        Returns the locale this report was initialized with.

        Returns:
        the locale this report was initialized with
      • getReportUpdate

        java.lang.String getReportUpdate()
        Updates this report, this processes all new output added since the last call to this method.

        This is only required in case the output is written to a HTML page, if the shell output is used, this will just return an empty String.

        Returns:
        new elements that have been added to the report and not yet processed.
      • getRuntime

        long getRuntime()
        Returns the time this report has been running.

        Returns:
        the time this report has been running
      • getWarnings

        java.util.List<java.lang.Object> getWarnings()
        Returns a list of all warnings that occured during the report.

        Returns:
        a warning list that occured during the report
      • hasError

        boolean hasError()
        Returns if the report generated an error output.

        Returns:
        true if the report generated an error, otherwise false
      • hasWarning

        boolean hasWarning()
        Returns if the report generated a warning output.

        Returns:
        true if the report generated a warning, otherwise false
      • print

        void print​(java.lang.String uiLabel)
        Prints a localized message to the report.

        Parameters:
        uiLabel - the String to add
      • print

        void print​(java.lang.String uiLabel,
                   int format)
        Prints a localized message to the report, using the indicated formatting.

        Use the contants starting with FORMAT from this interface to indicate which formatting to use.

        Parameters:
        uiLabel - the String to add
        format - the formatting to use for the output
      • println

        void println()
        Adds a line break to the report.

      • println

        void println​(java.lang.String uiLabel)
        Prints a localized message to the report.

        Parameters:
        uiLabel - the message to add
      • println

        void println​(java.lang.String uiLabel,
                     int format)
        Prints a localized message to the report, using the indicated formatting.

        Use the contents starting with FORMAT from this interface to indicate which formatting to use.

        Parameters:
        uiLabel - the message container to add
        format - the formatting to use for the output
      • println

        void println​(java.lang.Throwable t)
        Adds an Exception to the report, ensuring that the Exception content is processed to generate a valid output esp. for HTML pages.

        The exception will be stored and the output will later be processed in a special way.

        Parameters:
        t - the exception to add
      • printMessageWithParam

        void printMessageWithParam​(java.lang.String uiLabel,
                                   java.lang.Object param)
        Prints a localized message followed by a parameter and dots to the report.

        Parameters:
        uiLabel - the Message to add
        param - the Parameter to add
      • printMessageWithParam

        void printMessageWithParam​(int m,
                                   int n,
                                   java.lang.String uiLabel,
                                   java.lang.Object param)
        Convenience method to print a localized message, followed by a parameter and dots to the report.

        The output follows the pattern: ( 3 / 8 ) Deleting filename.txt ...

        Parameters:
        m - the number of the report output
        n - the total number of report outputs
        uiLabel - the Message to add
        param - the Parameter to add
      • resetRuntime

        void resetRuntime()
        Resets the runtime to 0 milliseconds.

      • addLogFile

        void addLogFile​(java.lang.String logFileName)
        Add a log file to the report.
        Parameters:
        logFileName -
      • closeLogFile

        java.lang.String closeLogFile()
        Close log file if necessary.
      • setSequenceNum

        void setSequenceNum​(long sequenceNum)
        Set log's sequence number.
        Parameters:
        sequenceNum -
      • getSequenceNum

        long getSequenceNum()