[Java] Class ErrorCollector

org.codehaus.groovy.control.ErrorCollector

All Implemented Interfaces and Traits:: Serializable

public class ErrorCollector
extends Object

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.

Field Summary

Fields
Modifiers	Name	Description
`protected CompilerConfiguration`	`configuration`	Configuration and other settings that control processing
`protected LinkedList`	`errors`	ErrorMessages collected during processing
`protected LinkedList`	`warnings`	WarningMessages collected during processing

Constructor Summary

Constructors
Constructor and description
`ErrorCollector (CompilerConfiguration configuration)` Initialize the ErrorReporter.

Methods Summary

Methods
Type Params	Return Type	Name and description
	`void`	`addCollectorContents(ErrorCollector er)`
	`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`	`addError(String text, CSTNode context, SourceUnit source)` Convenience wrapper for addError().
	`void`	`addErrorAndContinue(Message message)` Adds an error to the message set, but does not cause a failure.
	`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(WarningMessage message)` Adds a WarningMessage to the message set.
	`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(int importance, String text, Object data, CSTNode context, SourceUnit source)` Convenience wrapper for addWarning() that won't create an object unless it is relevant.
	`protected void`	`failIfErrors()` Causes the current phase to fail by throwing a CompilationFailedException.
	`CompilerConfiguration`	`getConfiguration()` @return the compiler configuration used to create this error collector
	`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 reported
	`SyntaxException`	`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.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class Object`	`wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll`

Field Detail

protected CompilerConfiguration configuration

Configuration and other settings that control processing

protected LinkedList errors

ErrorMessages collected during processing

protected LinkedList warnings

WarningMessages collected during processing

Constructor Detail

public ErrorCollector(CompilerConfiguration configuration)

Initialize the ErrorReporter.

Method Detail

public void addCollectorContents(ErrorCollector er)

public void addError(Message message)

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.

public void addError(Message message, boolean fatal)

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

public void addError(SyntaxException error, SourceUnit source)

Convenience wrapper for addError().

public void addError(String text, CSTNode context, SourceUnit source)

Convenience wrapper for addError().

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.

public void addException(Exception cause, SourceUnit source)

public void addFatalError(Message message)

Adds a fatal exception to the message set and throws the unit as a PhaseFailedException.

public void addWarning(WarningMessage message)

Adds a WarningMessage to the message set.

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.

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.

protected void failIfErrors()

Causes the current phase to fail by throwing a CompilationFailedException.

public CompilerConfiguration getConfiguration()

Returns:: the compiler configuration used to create this error collector

public Message getError(int index)

Returns the specified error message, or null.

public int getErrorCount()

Returns the number of errors.

public List getErrors()

Returns the list of errors, or null if there are none.

public Exception getException(int index)

Convenience routine to return the specified error's underlying Exception, or null if it isn't one.

public Message getLastError()

Returns the last error reported

public SyntaxException getSyntaxError(int index)

Convenience routine to return the specified error's underlying SyntaxException, or null if it isn't one.

public WarningMessage getWarning(int index)

Returns the specified warning message, or null.

public int getWarningCount()

Returns the number of warnings.

public List getWarnings()

Returns the list of warnings, or null if there are none.

public boolean hasErrors()

Returns true if there are any errors pending.

public boolean hasWarnings()

Returns true if there are any warnings pending.

public void write(PrintWriter writer, Janitor janitor)

Writes error messages to the specified PrintWriter.

© 2003-2020 The Apache Software Foundation
Licensed under the Apache license.
https://docs.groovy-lang.org/2.4.21/html/gapi/org/codehaus/groovy/control/ErrorCollector.html