com.github.fge.grappa

Class Grappa

java.lang.Object

com.github.fge.grappa.Grappa

public final class Grappa
extends Object

Main class providing the high-level entry point into the parboiled library.

Method Summary

Methods

Modifier and Type	Method and Description
static <P extends BaseParser<V>,V> P	createParser(Class<P> parserClass, Object... constructorArgs) Creates a parser object whose rule creation methods can then be used with one of the ParseRunner implementations.
static <P extends BaseParser<V>,V> byte[]	getByteCode(Class<P> parserClass) Generate the byte code of a transformed parser class

Methods inherited from class java.lang.Object

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

Method Detail

createParser

public static <P extends BaseParser<V>,V> P createParser(@Nonnull
                                         Class<P> parserClass,
                                         Object... constructorArgs)

Creates a parser object whose rule creation methods can then be used with one of the ParseRunner implementations.

Since parboiled needs to extend your parser with certain extra logic (e.g. to prevent infinite recursions in recursive rule definitions) you cannot create your parser object yourself, but have to go through this method. Also your parser class has to be derived from BaseParser. If you want to use a non-default constructor you can provide its arguments to this method. Make sure your non-default constructor does not use primitive type parameters (like "int") but rather their boxed counterparts (like "Integer"), otherwise the constructor will not be found.

Performing the rule analysis and extending the parser class is an expensive process (time-wise) and can take up to several hundred milliseconds for large grammars. However, this cost is only incurred once per parser class and class loader. Subsequent calls to this method are therefore fast once the initial extension has been performed.

Parameters:

parserClass - the type of the parser to create

constructorArgs - optional arguments to the parser class constructor

Returns:

the ready to use parser instance

getByteCode

public static <P extends BaseParser<V>,V> byte[] getByteCode(Class<P> parserClass)

Generate the byte code of a transformed parser class

When you create a parser using createParser(Class, Object...), Parboiled generates a new class which is the one you actually use for parsing. This method allows to get the byte code of such a generated class in a byte array.

Type Parameters:

P - class of the parser

V - see BaseParser

Parameters:

parserClass - the parser class

Returns:

the byte code

Throws:

RuntimeException - byte code generation failure

See Also:

ParserTransformer.getByteCode(Class)