com.github.fge.grappa.run

Class ListeningParseRunner<V>

java.lang.Object

com.github.fge.grappa.run.AbstractParseRunner<V>

com.github.fge.grappa.run.ListeningParseRunner<V>

All Implemented Interfaces:

MatchHandler, ParseRunner<V>

@ParametersAreNonnullByDefault
public class ListeningParseRunner<V>
extends AbstractParseRunner<V>
implements MatchHandler

The most basic of all ParseRunner implementations. It runs a rule against a given input text and builds a corresponding ParsingResult instance. However, it does not report any parse errors nor recover from them. Instead it simply marks the ParsingResult as "unmatched" if the input is not valid with regard to the rule grammar.It never causes the parser to perform more than one parsing run and is the fastest way to determine whether a given input conforms to the rule grammar.

Field Summary

Fields inherited from class com.github.fge.grappa.run.AbstractParseRunner

rootMatcher, stackSnapshot, valueStack

Constructor Summary

Constructors

Constructor and Description
ListeningParseRunner(Rule rule) Creates a new BasicParseRunner instance for the given rule.

Method Summary

Methods

Modifier and Type	Method and Description
<T> boolean	match(MatcherContext<T> context) Runs the given MatcherContext.
void	registerListener(ParseRunnerListener<V> listener)
ParsingResult<V>	run(InputBuffer inputBuffer) Performs the actual parse and creates a corresponding ParsingResult instance.

Methods inherited from class com.github.fge.grappa.run.AbstractParseRunner

createParsingResult, createRootContext, getValueStack, resetValueStack, run

Methods inherited from class java.lang.Object

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

Constructor Detail

ListeningParseRunner

public ListeningParseRunner(Rule rule)

Creates a new BasicParseRunner instance for the given rule.

Parameters:

rule - the parser rule

Method Detail

registerListener

public final void registerListener(ParseRunnerListener<V> listener)

run

public ParsingResult<V> run(InputBuffer inputBuffer)

Description copied from interface: ParseRunner

Performs the actual parse and creates a corresponding ParsingResult instance.

Specified by:

run in interface ParseRunner<V>

Parameters:

inputBuffer - the inputBuffer to use

Returns:

the ParsingResult for the run

match

public <T> boolean match(MatcherContext<T> context)

Description copied from interface: MatchHandler

Runs the given MatcherContext.

Specified by:

match in interface MatchHandler

Parameters:

context - the MatcherContext

Returns:

true if matched