gw.internal.gosu.parser

Class ParsedElement

java.lang.Object

gw.internal.gosu.parser.ParsedElement

All Implemented Interfaces:

IParsedElement

Direct Known Subclasses:

Expression, Statement

public abstract class ParsedElement
extends Object
implements IParsedElement

ParsedElement is the root class for all non-terminal elements represented in a parse tree i.e., all non-terminal expressions and statements derive either directly or indirectly from this class.

Field Summary

Fields

Modifier and Type	Field and Description
protected List<IToken>	_tokens
static String	UNDEF_FILE
static String	UNDEF_FUNCTION
static String	UNDEF_MODULE

Method Summary

Modifier and Type	Method and Description
void	addExceptionsFrom(IParsedElement elem)
void	addParseException(IFullParserState parserState, ResourceKey msgKey, Object... args)
void	addParseException(IParseIssue pe)
void	addParseException(ResourceKey msgKey, Object... args)
void	addParseExceptions(List<IParseIssue> parseExceptions)
void	addParseIssues(List<IParseIssue> parseIssues)
void	addParseWarning(IParseIssue warning)
void	addParseWarning(ResourceKey msgKey, Object... args)
void	addParseWarnings(List<IParseIssue> parseWarnings)
protected void	addToken(IToken token, IParseTree after)
void	adjustColumn(int offset)
void	adjustLineNum(int offset)
void	assignTokens(List<Token> tokens)
void	clearParseExceptions()
void	clearParseTreeInformation()
void	clearParseWarnings()
void	compactParseTree()
IParsedElement	findAncestorParsedElementByType(Class... parsedElementClasses)
IParsedElementWithAtLeastOneDeclaration	findDeclaringStatement(IParsedElement element, String identifierName)
int	findLineNumberOfDeclaration(String identifierName)
IParsedElement	findRootParsedElement()
List<IGosuAnnotation>	getAnnotations()
int	getColumn()
<E extends IParsedElement> boolean	getContainedParsedElementsByType(Class<E> parsedElementType, List<E> listResults) Find all the parsed elements of a given type contained within this parsed element.
boolean	getContainedParsedElementsByTypes(List<IParsedElement> listResults, Class<? extends IParsedElement>... parsedElementTypes)
boolean	getContainedParsedElementsByTypesWithIgnoreSet(List<IParsedElement> listResults, Set<Class<? extends IParsedElement>> ignoreSet, Class<? extends IParsedElement>... parsedElementTypes)
static IFeatureInfo	getEnclosingFeatureInfo(Stack<IFeatureInfo> enclosingFeatureInfos)
String	getFunctionName()
IGosuClass	getGosuClass()
IGosuProgramInternal	getGosuProgram()
IParseIssue	getImmediateParseIssue(ResourceKey errKey)
List<IParseIssue>	getImmediateParseIssues()
int	getLineNum()
ParseTree	getLocation()
IModule	getModule()
IParsedElement	getParent()
List<IParseIssue>	getParseExceptions()
List<IParseIssue>	getParseIssues()
List<IParseIssue>	getParseWarnings()
static ITypeInfo	getQualifyingEnclosingTypeInfo(Stack<IFeatureInfo> enclosingFeatureInfos)
List<IToken>	getTokens()
boolean	hasImmediateParseIssue(ResourceKey errKey)
boolean	hasImmediateParseWarning(ResourceKey errKey)
boolean	hasImmediateParseWarnings()
boolean	hasParseException(ResourceKey errKey)
boolean	hasParseExceptions()
boolean	hasParseIssue(IParseIssue pi)
boolean	hasParseIssues()
boolean	hasParseWarning(ResourceKey errKey)
boolean	hasParseWarnings()
void	initEmptyParseTree()
ParseTree	initLocation(int offset, int length, int lineNumber, int iColumn, IScriptPartId scriptPart)
boolean	isCompileTimeConstant()
boolean	isSuppressed(IParseIssue issue)
boolean	isSuppressed(IWarningSuppressor suppressor)
boolean	isSynthetic()
static double	makeDoubleValue(Object obj) Just like makeDouble(), but creates a double primitive value instead of a Double object.
static float	makeFloatValue(Object obj) Just like makeFloat(), but creates a float primitive value instead of a Float object.
Integer	makeInteger(Object obj)
static Long	makeLong(Object obj)
ParseException	removeParseException(ResourceKey keyToRemove) Removes the specified parse exception or removes them all if the specified exception is null.
ParseWarning	removeParseWarning(ResourceKey keyToRemove)
void	removeParseWarningRecursively(ResourceKey keyToRemove)
void	setGosuProgram(IGosuProgramInternal gosuProgram)
void	setLineNum(int iLineNum)
void	setLocation(IParseTree location) Specifiy the location of this parsed element within the source.
void	setParent(IParsedElement parent)
void	setSynthetic(boolean bSynthetic)
boolean	shouldClearParseInfo()

Methods inherited from class java.lang.Object

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

Methods inherited from interface gw.lang.parser.IParsedElement

getReturnType

Field Detail

UNDEF_MODULE

public static final String UNDEF_MODULE

See Also:

Constant Field Values

UNDEF_FUNCTION

public static final String UNDEF_FUNCTION

See Also:

Constant Field Values

UNDEF_FILE

public static final String UNDEF_FILE

See Also:

Constant Field Values

_tokens

protected List<IToken> _tokens

Method Detail

getGosuProgram

public IGosuProgramInternal getGosuProgram()

Specified by:

getGosuProgram in interface IParsedElement

setGosuProgram

public void setGosuProgram(IGosuProgramInternal gosuProgram)

addExceptionsFrom

public void addExceptionsFrom(IParsedElement elem)

Specified by:

addExceptionsFrom in interface IParsedElement

getLocation

public ParseTree getLocation()

Specified by:

getLocation in interface IParsedElement

Returns:

The location of this parsed element within the source.

setLocation

public void setLocation(IParseTree location)

Specifiy the location of this parsed element within the source.

Specified by:

setLocation in interface IParsedElement

Parameters:

location - The location of this parsed element within the source.

initLocation

public ParseTree initLocation(int offset,
                              int length,
                              int lineNumber,
                              int iColumn,
                              IScriptPartId scriptPart)

initEmptyParseTree

public void initEmptyParseTree()

hasParseIssues

public boolean hasParseIssues()

Specified by:

hasParseIssues in interface IParsedElement

getParseIssues

public List<IParseIssue> getParseIssues()

Specified by:

getParseIssues in interface IParsedElement

getImmediateParseIssues

public List<IParseIssue> getImmediateParseIssues()

Specified by:

getImmediateParseIssues in interface IParsedElement

hasParseExceptions

public boolean hasParseExceptions()

Specified by:

hasParseExceptions in interface IParsedElement

hasParseException

public boolean hasParseException(ResourceKey errKey)

Specified by:

hasParseException in interface IParsedElement

getImmediateParseIssue

public IParseIssue getImmediateParseIssue(ResourceKey errKey)

Specified by:

getImmediateParseIssue in interface IParsedElement

hasImmediateParseIssue

public boolean hasImmediateParseIssue(ResourceKey errKey)

Specified by:

hasImmediateParseIssue in interface IParsedElement

hasParseWarning

public boolean hasParseWarning(ResourceKey errKey)

Specified by:

hasParseWarning in interface IParsedElement

addParseWarnings

public void addParseWarnings(List<IParseIssue> parseWarnings)

addParseExceptions

public void addParseExceptions(List<IParseIssue> parseExceptions)

addParseIssues

public void addParseIssues(List<IParseIssue> parseIssues)

getParseExceptions

public List<IParseIssue> getParseExceptions()

Specified by:

getParseExceptions in interface IParsedElement

addParseException

public void addParseException(ResourceKey msgKey,
                              Object... args)

Specified by:

addParseException in interface IParsedElement

addParseException

public void addParseException(IFullParserState parserState,
                              ResourceKey msgKey,
                              Object... args)

removeParseException

public ParseException removeParseException(ResourceKey keyToRemove)

Removes the specified parse exception or removes them all if the specified exception is null.

removeParseWarning

public ParseWarning removeParseWarning(ResourceKey keyToRemove)

removeParseWarningRecursively

public void removeParseWarningRecursively(ResourceKey keyToRemove)

getGosuClass

public IGosuClass getGosuClass()

Specified by:

getGosuClass in interface IParsedElement

addParseWarning

public void addParseWarning(ResourceKey msgKey,
                            Object... args)

Specified by:

addParseWarning in interface IParsedElement

addParseException

public void addParseException(IParseIssue pe)

Specified by:

addParseException in interface IParsedElement

clearParseExceptions

public void clearParseExceptions()

Specified by:

clearParseExceptions in interface IParsedElement

clearParseWarnings

public void clearParseWarnings()

Specified by:

clearParseWarnings in interface IParsedElement

hasImmediateParseWarnings

public boolean hasImmediateParseWarnings()

Specified by:

hasImmediateParseWarnings in interface IParsedElement

hasImmediateParseWarning

public boolean hasImmediateParseWarning(ResourceKey errKey)

hasParseWarnings

public boolean hasParseWarnings()

Specified by:

hasParseWarnings in interface IParsedElement

getParseWarnings

public List<IParseIssue> getParseWarnings()

Specified by:

getParseWarnings in interface IParsedElement

addParseWarning

public void addParseWarning(IParseIssue warning)

Specified by:

addParseWarning in interface IParsedElement

hasParseIssue

public boolean hasParseIssue(IParseIssue pi)

Specified by:

hasParseIssue in interface IParsedElement

isSuppressed

public boolean isSuppressed(IParseIssue issue)

isSuppressed

public boolean isSuppressed(IWarningSuppressor suppressor)

Specified by:

isSuppressed in interface IParsedElement

getAnnotations

public List<IGosuAnnotation> getAnnotations()

isCompileTimeConstant

public boolean isCompileTimeConstant()

Specified by:

isCompileTimeConstant in interface IParsedElement

getContainedParsedElementsByType

public <E extends IParsedElement> boolean getContainedParsedElementsByType(Class<E> parsedElementType,
                                                                           List<E> listResults)

Find all the parsed elements of a given type contained within this parsed element.

Specified by:

getContainedParsedElementsByType in interface IParsedElement

Parameters:

parsedElementType - The type of parsed element to find.

listResults - A list of all the contained parsed elements matching the specified type. Can be null if you are only interested in whether or not parsedElementType exists in this element.

Returns:

True iff one or more parseElementType are found.

getContainedParsedElementsByTypes

public boolean getContainedParsedElementsByTypes(List<IParsedElement> listResults,
                                                 Class<? extends IParsedElement>... parsedElementTypes)

Specified by:

getContainedParsedElementsByTypes in interface IParsedElement

getContainedParsedElementsByTypesWithIgnoreSet

public boolean getContainedParsedElementsByTypesWithIgnoreSet(List<IParsedElement> listResults,
                                                              Set<Class<? extends IParsedElement>> ignoreSet,
                                                              Class<? extends IParsedElement>... parsedElementTypes)

Specified by:

getContainedParsedElementsByTypesWithIgnoreSet in interface IParsedElement

makeInteger

public final Integer makeInteger(Object obj)

makeLong

public static Long makeLong(Object obj)

makeDoubleValue

public static double makeDoubleValue(Object obj)

Just like makeDouble(), but creates a double primitive value instead of a Double object. Much more efficient if you don't need the object.

Parameters:

obj - Any double convertible object

Returns:

The double primitive value.

makeFloatValue

public static float makeFloatValue(Object obj)

Just like makeFloat(), but creates a float primitive value instead of a Float object. Much more efficient if you don't need the object.

Parameters:

obj - Any float convertible object

Returns:

The float primitive value.

compactParseTree

public void compactParseTree()

clearParseTreeInformation

public void clearParseTreeInformation()

Specified by:

clearParseTreeInformation in interface IParsedElement

getParent

public IParsedElement getParent()

Specified by:

getParent in interface IParsedElement

setParent

public void setParent(IParsedElement parent)

Specified by:

setParent in interface IParsedElement

getLineNum

public int getLineNum()

Specified by:

getLineNum in interface IParsedElement

adjustLineNum

public void adjustLineNum(int offset)

setLineNum

public void setLineNum(int iLineNum)

getColumn

public int getColumn()

Specified by:

getColumn in interface IParsedElement

adjustColumn

public void adjustColumn(int offset)

getFunctionName

public String getFunctionName()

Specified by:

getFunctionName in interface IParsedElement

isSynthetic

public boolean isSynthetic()

Specified by:

isSynthetic in interface IParsedElement

setSynthetic

public void setSynthetic(boolean bSynthetic)

getModule

public IModule getModule()

Specified by:

getModule in interface IParsedElement

getEnclosingFeatureInfo

public static IFeatureInfo getEnclosingFeatureInfo(Stack<IFeatureInfo> enclosingFeatureInfos)

getQualifyingEnclosingTypeInfo

public static ITypeInfo getQualifyingEnclosingTypeInfo(Stack<IFeatureInfo> enclosingFeatureInfos)

findLineNumberOfDeclaration

public int findLineNumberOfDeclaration(String identifierName)

findDeclaringStatement

public IParsedElementWithAtLeastOneDeclaration findDeclaringStatement(IParsedElement element,
                                                                      String identifierName)

Specified by:

findDeclaringStatement in interface IParsedElement

findRootParsedElement

public IParsedElement findRootParsedElement()

Specified by:

findRootParsedElement in interface IParsedElement

findAncestorParsedElementByType

public IParsedElement findAncestorParsedElementByType(Class... parsedElementClasses)

Specified by:

findAncestorParsedElementByType in interface IParsedElement

Parameters:

parsedElementClasses - List of statement types to find

Returns:

The nearest ancestor statement that is any one of the given types. null if this element does not have an ancestor of any of the given types

shouldClearParseInfo

public boolean shouldClearParseInfo()

assignTokens

public void assignTokens(List<Token> tokens)

addToken

protected void addToken(IToken token,
                        IParseTree after)

getTokens

public List<IToken> getTokens()

Specified by:

getTokens in interface IParsedElement