com.whitestein.lsps.lang.parser

Class AbstractParser

java.lang.Object

com.whitestein.lsps.lang.parser.ParserBase

com.whitestein.lsps.lang.parser.AbstractParser

Direct Known Subclasses:

Parser

public abstract class AbstractParser
extends ParserBase

Abstract class for LSPS expression language parsers.

Author:

pna

Constructor Summary

Constructors

Constructor and Description
AbstractParser(NamespaceModel namespace) Creates new parser.

Method Summary

Modifier and Type	Method and Description
protected org.antlr.runtime.tree.Tree	checkTreeType(org.antlr.runtime.tree.Tree tree, int type) Check whether the given tree node has any of the given types.
protected Expression	createConstant(org.antlr.runtime.tree.Tree tree, Object constant) Creates constant with the given value
protected ParsedExpression	createConstant(org.antlr.runtime.tree.Tree tree, Object constant, Type type) Creates constant of the given type, with the given value
protected int	debugLine(org.antlr.runtime.tree.Tree tree)
protected ASTInfo	getAstInfo(org.antlr.runtime.tree.Tree tree)
protected NamespaceModel	getNamespace()
protected ParsedExpression	parse(org.antlr.runtime.tree.Tree tree, Type expectedType) Parse an expression from a tree for the given expectedType.
static String	parseIdentifier(String text) Deprecated. Use ParserUtil.parseIdentifier(String)
protected String	parseIdentifier(org.antlr.runtime.tree.Tree tree) Deprecated. Use ParserUtil.parseIdentifier(Tree)
protected ParsedExpression	parseInNamespace(org.antlr.runtime.tree.Tree tree, Type expectedType, NamespaceModel namespace)
protected ParsedExpression	parseInNewNamespace(org.antlr.runtime.tree.Tree tree, Type expectedType) Parses a given tree in a new namespace to provide a correct separation of local variables.
protected ParsedExpression	parseInNewNamespace(org.antlr.runtime.tree.Tree tree, Type expectedType, com.whitestein.lsps.lang.parser.ParserWorker worker)
protected abstract ParsedExpression	parseNoCheck(org.antlr.runtime.tree.Tree tree, Type expectedType) Parse expression.
QID	parseQID(org.antlr.runtime.tree.Tree tree) Deprecated. Use QID.parse(Tree)
static void	transform(org.antlr.runtime.tree.CommonTree tree) Deprecated. Use ParserUtil.transform(CommonTree)
protected ParsedExpression	validateOrConvert(ParsedExpression expr, Type expectedType) Provides some validation and conversion

Methods inherited from class com.whitestein.lsps.lang.parser.ParserBase

begin, end, getASTNode, getFullText, getText, line, parseQIDAst, setFullText

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractParser

public AbstractParser(NamespaceModel namespace)

Creates new parser.

Parameters:

namespace -

Method Detail

getNamespace

protected NamespaceModel getNamespace()

Returns:

the current namespace

transform

@Deprecated
public static void transform(org.antlr.runtime.tree.CommonTree tree)

Deprecated. Use ParserUtil.transform(CommonTree)

Prepares an expression tree to be parsed.

Parameters:

tree -

getAstInfo

protected ASTInfo getAstInfo(org.antlr.runtime.tree.Tree tree)

debugLine

protected int debugLine(org.antlr.runtime.tree.Tree tree)

createConstant

protected Expression createConstant(org.antlr.runtime.tree.Tree tree,
                                    Object constant)

Creates constant with the given value

Parameters:

tree -

constant -

Returns:

new constant expression

createConstant

protected ParsedExpression createConstant(org.antlr.runtime.tree.Tree tree,
                                          Object constant,
                                          Type type)

Creates constant of the given type, with the given value

Parameters:

tree -

constant -

type -

Returns:

new constant expression

parse

protected ParsedExpression parse(org.antlr.runtime.tree.Tree tree,
                                 Type expectedType)

Parse an expression from a tree for the given expectedType. Before a tree is parsed it must be transformed using ParserUtil.transform(CommonTree).

Parameters:

tree -

expectedType -

Returns:

parsed expression

Throws:

NullPointerException - if the tree or the expectedType is null

IllegalArgumentException - if the tree is not a valid expression tree

parseInNamespace

protected ParsedExpression parseInNamespace(org.antlr.runtime.tree.Tree tree,
                                            Type expectedType,
                                            NamespaceModel namespace)

Parameters:

tree -

expectedType -

namespace -

Returns:

parsed expression

parseInNewNamespace

protected ParsedExpression parseInNewNamespace(org.antlr.runtime.tree.Tree tree,
                                               Type expectedType)

Parses a given tree in a new namespace to provide a correct separation of local variables.

Parameters:

tree -

expectedType -

Returns:

parsed expression

parseInNewNamespace

protected ParsedExpression parseInNewNamespace(org.antlr.runtime.tree.Tree tree,
                                               Type expectedType,
                                               com.whitestein.lsps.lang.parser.ParserWorker worker)

validateOrConvert

protected ParsedExpression validateOrConvert(ParsedExpression expr,
                                             Type expectedType)

Provides some validation and conversion

Parameters:

expr -

expectedType -

Returns:

converted expression

parseNoCheck

protected abstract ParsedExpression parseNoCheck(org.antlr.runtime.tree.Tree tree,
                                                 Type expectedType)

Parse expression. This should be the main method performing parsing

Parameters:

tree -

expectedType -

Returns:

parsed expression

checkTreeType

protected org.antlr.runtime.tree.Tree checkTreeType(org.antlr.runtime.tree.Tree tree,
                                                    int type)

Check whether the given tree node has any of the given types. If not, an exception is thrown.

Parameters:

tree -

type -

Returns:

the given tree

Throws:

IllegalArgumentException - if the tree node type does not match any of the given types

parseQID

@Deprecated
public QID parseQID(org.antlr.runtime.tree.Tree tree)

Deprecated. Use QID.parse(Tree)

Parses a qualified identifier from an ANTLR tree.

Parameters:

tree -

Returns:

the parsed qualified identifier

Throws:

NullPointerException - if the tree is null

IllegalArgumentException - if the tree is not a valid qualified identifier tree

parseIdentifier

@Deprecated
protected String parseIdentifier(org.antlr.runtime.tree.Tree tree)

Deprecated. Use ParserUtil.parseIdentifier(Tree)

Parameters:

tree -

Returns:

a parsed identifier string

parseIdentifier

@Deprecated
public static String parseIdentifier(String text)

Deprecated. Use ParserUtil.parseIdentifier(String)

Parses the given text, assuming it is an identifier.

Parameters:

text -

Returns:

the identifier