Package gw.lang.parser.exceptions

Class ParseIssue

java.lang.Object

java.lang.Throwable

java.lang.Exception

gw.lang.parser.exceptions.ParseIssue

All Implemented Interfaces:

IParseIssue, Serializable

Direct Known Subclasses:

ParseException, ParseWarning

public abstract class ParseIssue
extends Exception
implements IParseIssue

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private Integer	_lineNumber
private Integer	_lineOffset
private Object[]	_messageArgs
private ResourceKey	_messageKey
private IGosuClass	_parentClass
private IParsedElement	_parentElement
private String	_stateSource
private ISymbolTable	_symbolTable
private Integer	_tokenColumn
private Integer	_tokenEnd
private Integer	_tokenStart
private static final int	CONTEXT_LINES
private static final String	SOURCE_DELIMITER

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ParseIssue(IParserState parserState, ResourceKey key, Object... msgArgs)
protected	ParseIssue(IParserState state, Throwable t)
protected	ParseIssue(Integer lineNumber, Integer lineOffset, Integer tokenColumn, Integer tokenStart, Integer tokenEnd, ISymbolTable symbolTable, ResourceKey key, Object... msgArgs)

Method Summary

Modifier and Type	Method	Description
void	addLineOffset(int offset)
void	adjustOffset(int offset, int lineNumOffset, int columnOffset)
boolean	appliesToPosition(int iPos)	Returns true if this issue is relevant to the given position
private void	debug()
Throwable	fillInStackTrace()	Don't fill in stack trace since parse issues are not really "exceptional" in terms of the parser's Java implementation; we don't care much about the Java stack trace when these are thrown.
protected static String	formatError(ResourceKey key, Object... msgArgs)
int	getColumn()
String	getConsoleMessage()
String	getContextString()
String	getContextStringNoLineNumbers()
IType	getExpectedType()
int	getLine()
Integer	getLineNumber()
Integer	getLineOffset()
int	getLineReportingOffset()
Object[]	getMessageArgs()
ResourceKey	getMessageKey()
private String	getMyMessage()
String	getPlainMessage()
IParsedElement	getSource()	Warning: Only valid if called from the parser thread.
String	getStateSource()
ISymbolTable	getSymbolTable()	Warning: Only valid if called from the parser thread.
Integer	getTokenColumn()
Integer	getTokenEnd()
Integer	getTokenStart()
String	getUIMessage()
private void	initFieldsFromParserState(IParserState parserState)
static String	makeContextString(int lineOfError, String source, int lineReportingOffset)
private static String	makeContextString(int lineOfError, String source, int lineReportingOffset, boolean showLineNumbers)
private Object[]	normalizeMessageArgs(Object[] args)	Normalize all non string & non number args to string types to prevent race conditions wrt/ the TypeSystem lock when the message is formatted.
void	resetPositions()
void	resolve(IParserPart parserBase)
void	setMessage(ResourceKey key, Object... args)
void	setSource(IParsedElement sourceOfError)
void	setStateSource(String parserSource)

Methods inherited from class java.lang.Throwable

addSuppressed, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface gw.lang.parser.IParseIssue

printStackTrace, setExpectedType

Field Details

SOURCE_DELIMITER

private static final String SOURCE_DELIMITER

See Also:

• Constant Field Values

CONTEXT_LINES

private static final int CONTEXT_LINES

See Also:

• Constant Field Values

_lineNumber

private Integer _lineNumber

_lineOffset

private Integer _lineOffset

_tokenColumn

private Integer _tokenColumn

_tokenStart

private Integer _tokenStart

_tokenEnd

private Integer _tokenEnd

_messageKey

private ResourceKey _messageKey

_messageArgs

private Object[] _messageArgs

_symbolTable

private ISymbolTable _symbolTable

_parentElement

private IParsedElement _parentElement

_stateSource

private String _stateSource

_parentClass

private IGosuClass _parentClass

Constructor Details

ParseIssue

protected ParseIssue(IParserState parserState,
 ResourceKey key,
 Object... msgArgs)

ParseIssue

protected ParseIssue(Integer lineNumber,
 Integer lineOffset,
 Integer tokenColumn,
 Integer tokenStart,
 Integer tokenEnd,
 ISymbolTable symbolTable,
 ResourceKey key,
 Object... msgArgs)

ParseIssue

protected ParseIssue(IParserState state,
 Throwable t)

Method Details

debug

private void debug()

fillInStackTrace

public Throwable fillInStackTrace()

Don't fill in stack trace since parse issues are not really "exceptional" in terms of the parser's Java implementation; we don't care much about the Java stack trace when these are thrown. Rather parse issues provide a means to tag parsed elements with issues discovered during parsing, such as syntax warnings and errors. Hence, the ParseIssue interface.

Note this method is otherwise very costly from a performance standpoint.

Overrides:

fillInStackTrace in class Throwable

initFieldsFromParserState

private void initFieldsFromParserState(IParserState parserState)

normalizeMessageArgs

private Object[] normalizeMessageArgs(Object[] args)

Normalize all non string & non number args to string types to prevent race conditions wrt/ the TypeSystem lock when the message is formatted.

formatError

protected static String formatError(ResourceKey key,
 Object... msgArgs)

getLineNumber

public Integer getLineNumber()

getLineOffset

public Integer getLineOffset()

addLineOffset

public void addLineOffset(int offset)

getTokenColumn

public Integer getTokenColumn()

getTokenEnd

public Integer getTokenEnd()

Specified by:

getTokenEnd in interface IParseIssue

getTokenStart

public Integer getTokenStart()

Specified by:

getTokenStart in interface IParseIssue

getContextString

public String getContextString()

getContextStringNoLineNumbers

public String getContextStringNoLineNumbers()

getStateSource

public String getStateSource()

setStateSource

public void setStateSource(String parserSource)

getMyMessage

private String getMyMessage()

getPlainMessage

public String getPlainMessage()

Specified by:

getPlainMessage in interface IParseIssue

Returns:

the raw message for this parse issue, with no formatting

getConsoleMessage

public String getConsoleMessage()

Specified by:

getConsoleMessage in interface IParseIssue

Returns:

the message for this parse issue formatted for printing out to a console

makeContextString

public static String makeContextString(int lineOfError,
 String source,
 int lineReportingOffset)

makeContextString

private static String makeContextString(int lineOfError,
 String source,
 int lineReportingOffset,
 boolean showLineNumbers)

getUIMessage

public String getUIMessage()

Specified by:

getUIMessage in interface IParseIssue

Returns:

the message formatted for use by an IDE

getLine

public int getLine()

Specified by:

getLine in interface IParseIssue

Returns:

the line that this issue is on

getColumn

public int getColumn()

Specified by:

getColumn in interface IParseIssue

getSource

public IParsedElement getSource()

Warning: Only valid if called from the parser thread. Otherwise we null it out.

Specified by:

getSource in interface IParseIssue

Returns:

the parsed element that this issue is associated with

setSource

public void setSource(IParsedElement sourceOfError)

getSymbolTable

public ISymbolTable getSymbolTable()

Warning: Only valid if called from the parser thread. Otherwise we null it out.

Specified by:

getSymbolTable in interface IParseIssue

Returns:

the symbol table state at the creation of this issue. Can return null if no symbol table is present.

appliesToPosition

public boolean appliesToPosition(int iPos)

Description copied from interface: IParseIssue

Returns true if this issue is relevant to the given position

Specified by:

appliesToPosition in interface IParseIssue

getMessageKey

public ResourceKey getMessageKey()

Specified by:

getMessageKey in interface IParseIssue

Returns:

the resource key for this ParseIssue, which can be used as a kind of identifier for the type of issue.

resolve

public void resolve(IParserPart parserBase)

Specified by:

resolve in interface IParseIssue

resetPositions

public void resetPositions()

Specified by:

resetPositions in interface IParseIssue

adjustOffset

public void adjustOffset(int offset,
 int lineNumOffset,
 int columnOffset)

setMessage

public void setMessage(ResourceKey key,
 Object... args)

getMessageArgs

public Object[] getMessageArgs()

Specified by:

getMessageArgs in interface IParseIssue

getLineReportingOffset

public int getLineReportingOffset()

getExpectedType

public IType getExpectedType()

Specified by:

getExpectedType in interface IParseIssue