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 Summary
Fields Modifier and Type Field Description protected CompilerConfiguration
configuration
Configuration and other settings that control processingprotected LinkedList
errors
ErrorMessages collected during processingprotected LinkedList
warnings
WarningMessages collected during processing
-
Constructor Summary
Constructors Constructor Description ErrorCollector(CompilerConfiguration configuration)
Initialize the ErrorReporter.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
addCollectorContents(ErrorCollector er)
void
addError(String text, CSTNode context, SourceUnit source)
Convenience wrapper for addError().void
addError(Message message)
Adds a non-fatal error to the message set, which may cause a failure if the error threshold is exceeded.void
addError(Message message, boolean fatal)
Adds an optionally-fatal error to the message set.void
addError(SyntaxException error, SourceUnit source)
Convenience wrapper for addError().void
addErrorAndContinue(Message message)
Adds an error to the message set, but does not cause a failure.void
addErrorAndContinue(SyntaxException error, SourceUnit source)
void
addException(Exception cause, SourceUnit source)
void
addFatalError(Message message)
Adds a fatal exception to the message set and throws the unit as a PhaseFailedException.void
addWarning(int importance, String text, Object data, CSTNode context, SourceUnit source)
Convenience wrapper for addWarning() that won't create an object unless it is relevant.void
addWarning(int importance, String text, CSTNode context, SourceUnit source)
Convenience wrapper for addWarning() that won't create an object unless it is relevant.void
addWarning(WarningMessage message)
Adds a WarningMessage to the message set.protected void
failIfErrors()
Causes the current phase to fail by throwing a CompilationFailedException.CompilerConfiguration
getConfiguration()
Message
getError(int index)
Returns the specified error message, or null.int
getErrorCount()
Returns the number of errors.List
getErrors()
Returns the list of errors, or null if there are none.Exception
getException(int index)
Convenience routine to return the specified error's underlying Exception, or null if it isn't one.Message
getLastError()
Returns the last error reportedSyntaxException
getSyntaxError(int index)
Convenience routine to return the specified error's underlying SyntaxException, or null if it isn't one.WarningMessage
getWarning(int index)
Returns the specified warning message, or null.int
getWarningCount()
Returns the number of warnings.List
getWarnings()
Returns the list of warnings, or null if there are none.boolean
hasErrors()
Returns true if there are any errors pending.boolean
hasWarnings()
Returns true if there are any warnings pending.void
write(PrintWriter writer, Janitor janitor)
Writes error messages to the specified PrintWriter.
-
-
-
Field Detail
-
warnings
protected LinkedList warnings
WarningMessages collected during processing
-
errors
protected LinkedList errors
ErrorMessages collected during processing
-
configuration
protected CompilerConfiguration configuration
Configuration and other settings that control processing
-
-
Constructor Detail
-
ErrorCollector
public ErrorCollector(CompilerConfiguration configuration)
Initialize the ErrorReporter.
-
-
Method Detail
-
addCollectorContents
public void addCollectorContents(ErrorCollector er)
-
addErrorAndContinue
public void addErrorAndContinue(SyntaxException error, SourceUnit source) throws CompilationFailedException
- Throws:
CompilationFailedException
-
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
Convenience wrapper for addError().- Throws:
CompilationFailedException
-
addError
public void addError(String text, CSTNode context, SourceUnit source) throws CompilationFailedException
Convenience wrapper for addError().- Throws:
CompilationFailedException
-
addFatalError
public void addFatalError(Message message) throws CompilationFailedException
Adds a fatal exception to the message set and throws the unit as a PhaseFailedException.- Throws:
CompilationFailedException
-
addException
public void addException(Exception cause, SourceUnit source) throws CompilationFailedException
- Throws:
CompilationFailedException
-
hasErrors
public boolean hasErrors()
Returns true if there are any errors pending.
-
getConfiguration
public CompilerConfiguration getConfiguration()
- Returns:
- the compiler configuration used to create this error collector
-
hasWarnings
public boolean hasWarnings()
Returns true if there are any warnings pending.
-
getWarnings
public List getWarnings()
Returns the list of warnings, or null if there are none.
-
getErrors
public List getErrors()
Returns the list of errors, or null if there are none.
-
getWarningCount
public int getWarningCount()
Returns the number of warnings.
-
getErrorCount
public int getErrorCount()
Returns the number of errors.
-
getWarning
public WarningMessage getWarning(int index)
Returns the specified warning message, or null.
-
getError
public Message getError(int index)
Returns the specified error message, or null.
-
getLastError
public Message getLastError()
Returns the last error reported
-
getSyntaxError
public SyntaxException getSyntaxError(int index)
Convenience routine to return the specified error's underlying SyntaxException, or null if it isn't one.
-
getException
public Exception getException(int index)
Convenience routine to return the specified error's underlying Exception, or null if it isn't one.
-
addWarning
public void addWarning(WarningMessage message)
Adds a WarningMessage to the message set.
-
addWarning
public void addWarning(int importance, String text, CSTNode context, SourceUnit source)
Convenience wrapper for addWarning() that won't create an object unless it is relevant.
-
addWarning
public void addWarning(int importance, String text, Object data, CSTNode context, SourceUnit source)
Convenience wrapper for addWarning() that won't create an object unless it is relevant.
-
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.
-
-