Package org.codehaus.groovy.control

Class ErrorCollector

java.lang.Object
org.codehaus.groovy.control.ErrorCollector
All Implemented Interfaces:
Serializable
public class ErrorCollector
extends Object
implements Serializable
A base class for collecting messages and errors during processing. Each CompilationUnit should have an ErrorCollector, and the SourceUnits should share their ErrorCollector with the CompilationUnit.
See Also:
Serialized Form

  • Field Details

    • errors

      protected LinkedList<Message> errors
      ErrorMessages collected during processing

    • warnings

      protected LinkedList<WarningMessage> warnings
      WarningMessages collected during processing

    • configuration

      protected final CompilerConfiguration configuration
      Configuration and other settings that control processing

  • Constructor Details

    • ErrorCollector

      public ErrorCollector​(CompilerConfiguration configuration)
      Initialize the ErrorReporter.

  • Method Details

    • addCollectorContents

      public void addCollectorContents​(ErrorCollector that)

    • addErrorAndContinue

      public void addErrorAndContinue​(String error, ASTNode node, SourceUnit source)

    • addErrorAndContinue

      public void addErrorAndContinue​(SyntaxException error, SourceUnit source)

    • addErrorAndContinue

      public void addErrorAndContinue​(Message message)
      Adds an error to the message set, but does not cause a failure. The message is not required to have a source line and column specified, but it is best practice to try and include that information.

    • addError

      public void addError​(Message message) throws CompilationFailedException
      Adds a non-fatal error to the message set, which may cause a failure if the error threshold is exceeded. The message is not required to have a source line and column specified, but it is best practice to try and include that information.
      Throws:
      CompilationFailedException

    • addError

      public void addError​(Message message, boolean fatal) throws CompilationFailedException
      Adds an optionally-fatal error to the message set. The message is not required to have a source line and column specified, but it is best practice to try and include that information.
      Parameters:
      fatal - if true then then processing will stop
      Throws:
      CompilationFailedException

    • addError

      public void addError​(SyntaxException error, SourceUnit source) throws CompilationFailedException
      Throws:
      CompilationFailedException

    • addError

      public void addError​(String error, CSTNode context, SourceUnit source) throws CompilationFailedException
      Throws:
      CompilationFailedException

    • addException

      public void addException​(Exception exception, SourceUnit source) throws CompilationFailedException
      Throws:
      CompilationFailedException

    • addFatalError

      public void addFatalError​(Message message) throws CompilationFailedException
      Adds an error to the message set and throws CompilationFailedException.
      Throws:
      CompilationFailedException

    • addWarning

      public void addWarning​(WarningMessage message)
      Adds a warning to the message set.

    • addWarning

      public void addWarning​(int importance, String text, CSTNode context, SourceUnit source)
      Adds a warning to the message set if it is relevant.

    • addWarning

      public void addWarning​(int importance, String text, Object data, CSTNode context, SourceUnit source)
      Adds a warning to the message set if it is relevant.

    • getConfiguration

      public CompilerConfiguration getConfiguration()
      Returns:
      the compiler configuration used to create this error collector

    • getErrorCount

      public int getErrorCount()
      Returns the number of errors.

    • getError

      public Message getError​(int index)
      Returns the specified error message, or null.

    • getErrors

      public List<? extends Message> getErrors()
      Returns the list of errors, or null if there are none.

    • hasErrors

      public boolean hasErrors()
      Returns true if there are any errors pending.

    • getWarningCount

      public int getWarningCount()
      Returns the number of warnings.

    • getWarning

      public WarningMessage getWarning​(int index)
      Returns the specified warning message, or null.

    • getWarnings

      public List<WarningMessage> getWarnings()
      Returns the list of warnings, or null if there are none.

    • hasWarnings

      public boolean hasWarnings()
      Returns true if there are any warnings pending.

    • getLastError

      public Message getLastError()
      Returns the last error reported.

    • getException

      public Exception getException​(int index)
      Returns the specified error's underlying Exception, or null if it isn't one.

    • getSyntaxError

      public SyntaxException getSyntaxError​(int index)
      Returns the specified error's underlying SyntaxException, or null if it isn't one.

    • failIfErrors

      protected void failIfErrors() throws CompilationFailedException
      Causes the current phase to fail by throwing a CompilationFailedException.
      Throws:
      CompilationFailedException

    • write

      public void write​(PrintWriter writer, Janitor janitor)
      Writes error messages to the specified PrintWriter.