Package snap.parse

Class Parser

java.lang.Object

snap.parse.Parser

Direct Known Subclasses:

GrammarParser, JSParser, KeyChainParser, XMLParser

public class Parser
extends Object

A class to parse a given input (string) using given rule(s).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Parser.HandlerRef	A class to pass Handler by reference, allowing it to be created lazily, but used higher up in stack.

Constructor Summary

Constructors

Constructor	Description
Parser()	Constructor.

Method Summary

Modifier and Type	Method	Description
protected void	clearTokens()	Clears any currently set tokens.
protected Grammar	createGrammar()	Creates the grammar.
protected ParseNode	createNode(ParseRule aRule, ParseToken aStartToken, ParseToken anEndToken)	Creates a node for given rule and start/end tokens (returns a shared node by default).
protected Tokenizer	createTokenizer()	Creates the tokenizer instance.
int	getCharIndex()	Returns the current parse char location.
Grammar	getGrammar()	Returns the grammar.
CharSequence	getInput()	Returns the current parse character input.
ParseToken	getLastProcessedToken()	Returns the last token that was parsed or attempted to parse.
ParseToken	getLastValidToken()	Returns the last successfully parsed token.
protected ParseToken	getLookAheadToken(int anIndex)	Returns the look ahead token at given index.
protected ParseToken	getNextToken()	Fetches and returns the next token.
ParseRule	getPrimaryRule()	Returns the primary rule.
ParseRule	getRuleForName(String aName)	Returns a named rule.
ParseToken	getToken()	Returns the current token.
Tokenizer	getTokenizer()	Returns the tokenizer.
protected void	initGrammar()	Initializes grammar.
protected int	lookAhead(ParseRule aRule, int aTokenCount, int aTokenIndex)	Looks ahead given number of tokens and returns the remainder or -1 if it fails.
ParseNode	parse()	Parses input and returns ParseNode.
ParseNode	parse(CharSequence anInput)	Parses a given input and returns ParseNode (convenience).
ParseNode	parse(ParseRule aRule)	Parses input and returns ParseNode.
protected ParseNode	parse(ParseRule aRule, Parser.HandlerRef aHRef)	Returns a parse node if this rule matches string.
<T> T	parseCustom(Class<T> aClass)	Parses input and returns custom parse tree node.
<T> T	parseCustom(ParseRule aRule, Class<T> aClass)	Parses input and returns custom parse tree node.
protected void	parseFailed(ParseRule aRule, ParseHandler<?> aHandler)	Called when parse fails.
void	setCharIndex(int aLoc)	Sets the current parse location.
void	setInput(CharSequence aSequence)	Sets the current parse string.
protected void	setTokenizer(Tokenizer aTokenizer)	Sets the tokenizer.

Methods inherited from class java.lang.Object

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

Constructor Details

Parser

public Parser()

Constructor.

Method Details

getGrammar

public Grammar getGrammar()

Returns the grammar.

createGrammar

protected Grammar createGrammar()

Creates the grammar.

initGrammar

protected void initGrammar()

Initializes grammar.

getPrimaryRule

public ParseRule getPrimaryRule()

Returns the primary rule.

getRuleForName

public ParseRule getRuleForName(String aName)

Returns a named rule.

getInput

public CharSequence getInput()

Returns the current parse character input.

setInput

public void setInput(CharSequence aSequence)

Sets the current parse string.

getCharIndex

public int getCharIndex()

Returns the current parse char location.

setCharIndex

public void setCharIndex(int aLoc)

Sets the current parse location.

getTokenizer

public Tokenizer getTokenizer()

Returns the tokenizer.

createTokenizer

protected Tokenizer createTokenizer()

Creates the tokenizer instance.

setTokenizer

protected void setTokenizer(Tokenizer aTokenizer)

Sets the tokenizer.

getToken

public ParseToken getToken()

Returns the current token.

getNextToken

protected ParseToken getNextToken()

Fetches and returns the next token.

getLookAheadToken

protected ParseToken getLookAheadToken(int anIndex)

Returns the look ahead token at given index.

getLastValidToken

public ParseToken getLastValidToken()

Returns the last successfully parsed token.

getLastProcessedToken

public ParseToken getLastProcessedToken()

Returns the last token that was parsed or attempted to parse.

clearTokens

protected void clearTokens()

Clears any currently set tokens.

parse

public ParseNode parse(CharSequence anInput)

Parses a given input and returns ParseNode (convenience).

parse

public ParseNode parse()

Parses input and returns ParseNode.

parse

public ParseNode parse(ParseRule aRule)

Parses input and returns ParseNode.

parseCustom

public <T> T parseCustom(Class<T> aClass)

Parses input and returns custom parse tree node.

parseCustom

public <T> T parseCustom(ParseRule aRule,
 Class<T> aClass)

Parses input and returns custom parse tree node.

parse

protected ParseNode parse(ParseRule aRule,
 Parser.HandlerRef aHRef)

Returns a parse node if this rule matches string.

lookAhead

protected int lookAhead(ParseRule aRule,
 int aTokenCount,
 int aTokenIndex)

Looks ahead given number of tokens and returns the remainder or -1 if it fails.

createNode

protected ParseNode createNode(ParseRule aRule,
 ParseToken aStartToken,
 ParseToken anEndToken)

Creates a node for given rule and start/end tokens (returns a shared node by default).

parseFailed

protected void parseFailed(ParseRule aRule,
 ParseHandler<?> aHandler)

Called when parse fails.