com.massa.dsl.grammar

Class ParsingContext

java.lang.Object

com.massa.dsl.grammar.ParsingContext

public class ParsingContext
extends Object

Object holding all common information during a matching process.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ParsingContext.AutoCompleteResult Describes one autoComplete possibility.

Constructor Summary

Constructors

Constructor and Description
ParsingContext(Grammar grammar, AdvancedReader source)

Method Summary

Modifier and Type	Method and Description
Set<ParsingContext.AutoCompleteResult>	getAutoCompleteResults()
<L extends LexerParser> L	getEquivalentParseResult(L parser) Allows to retrieve a result pushed by a previous equivalent parser on the same source part.
Grammar	getGrammar()
Matcher	getLastCompletedMatch()
<M extends Matcher> M	getMatchResult(M matcher) The context allows to keep trace of match result and to retrieve what has already been parsed.
<T> T	getProperty(String key) Retrieves a property from the context
AdvancedReader	getSource()
boolean	isAlreadyInHierarchy(Matcher matcher) Tells if this very matcher is already in matching process.
boolean	isAutoComplete()
boolean	isExcluded(Matcher matcher) Tells if this very matcher is has been specified as excluded by a member of the matching hierarchy.
boolean	isSyntaxValidation()
Matcher	popLastCompletedMatch()
ParsingContext	popMatcher() Removes the matcher at the top of the stack of the matching process
void	pushCompletedMatch(Matcher lastCompletedMatch)
ParsingContext	pushMatcher(Matcher matcher) Pushes a matcher at the top of the stack of the matching process
<M extends Matcher> void	pushMatchResult(M matcher) Pushes a match result in this context's buffer.
<L extends LexerParser> void	pushParseResult(L parser) Pushes a parsed result in this context's buffer.
void	setAutoComplete(boolean b)
<T> T	setProperty(String key, Object value) Sets a property in the context
void	setSyntaxValidation(boolean syntaxValidation)

Methods inherited from class java.lang.Object

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

Constructor Detail

ParsingContext

public ParsingContext(Grammar grammar,
                      AdvancedReader source)

Method Detail

getEquivalentParseResult

public <L extends LexerParser> L getEquivalentParseResult(L parser)

Allows to retrieve a result pushed by a previous equivalent parser on the same source part.

pushParseResult

public <L extends LexerParser> void pushParseResult(L parser)

Pushes a parsed result in this context's buffer.

isAlreadyInHierarchy

public boolean isAlreadyInHierarchy(Matcher matcher)

Tells if this very matcher is already in matching process. This allows avoiding infinite matching loops.

isExcluded

public boolean isExcluded(Matcher matcher)
                   throws DslException

Tells if this very matcher is has been specified as excluded by a member of the matching hierarchy.

Throws:

DslException

getMatchResult

public <M extends Matcher> M getMatchResult(M matcher)

The context allows to keep trace of match result and to retrieve what has already been parsed. This method allows to retrieve a result pushed by a previous matcher on the same source part.

pushMatchResult

public <M extends Matcher> void pushMatchResult(M matcher)

Pushes a match result in this context's buffer. This method must be called by matchers using a LexerBlock.

pushMatcher

public ParsingContext pushMatcher(Matcher matcher)

Pushes a matcher at the top of the stack of the matching process

Returns:

Self for chaining.

popMatcher

public ParsingContext popMatcher()

Removes the matcher at the top of the stack of the matching process

Returns:

Self for chaining.

getLastCompletedMatch

public Matcher getLastCompletedMatch()

popLastCompletedMatch

public Matcher popLastCompletedMatch()

pushCompletedMatch

public void pushCompletedMatch(Matcher lastCompletedMatch)

isAutoComplete

public boolean isAutoComplete()

setAutoComplete

public void setAutoComplete(boolean b)

isSyntaxValidation

public boolean isSyntaxValidation()

setSyntaxValidation

public void setSyntaxValidation(boolean syntaxValidation)

getAutoCompleteResults

public Set<ParsingContext.AutoCompleteResult> getAutoCompleteResults()

getGrammar

public Grammar getGrammar()

getSource

public AdvancedReader getSource()

setProperty

public <T> T setProperty(String key,
                         Object value)

Sets a property in the context

Parameters:

key -

value -

Returns:

Former property value

getProperty

public <T> T getProperty(String key)

Retrieves a property from the context

Parameters:

key -