org.apache.clerezza.templating.seedsnipe.simpleparser

Class DefaultParser

java.lang.Object

org.apache.clerezza.templating.seedsnipe.simpleparser.DefaultParser

public class DefaultParser
extends Object

Default parser for parsing text with FreeMarker (http://freemarker.sourceforge.net/) style tags.

This parser takes text input from a java.io.Reader and writes text output to a java.io.Writer.

Author:

reto, daniel

Constructor Summary

Constructors

Constructor and Description
DefaultParser(Reader in, Writer out) Creates and initializes a new Parser.

Method Summary

Methods

Modifier and Type	Method and Description
void	perform(DataFieldResolver dataFieldResolver) Starts the parsing procedure.
String	perform(Writer out, String[] endMarkers, int[] arrayPositioner, DataFieldResolver dataFieldResolver) Parses the input string.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultParser

public DefaultParser(Reader in,
             Writer out)

Creates and initializes a new Parser.

Parameters:

in - Reader from which the parser takes its input.

out - Writer to which the parser writes its output.

dataFieldResolver - data model of the input.

Method Detail

perform

public void perform(DataFieldResolver dataFieldResolver)
             throws IOException

Starts the parsing procedure.

Throws:

IOException

See Also:

DefaultParser#perform(Writer, String[], int[])

perform

public String perform(Writer out,
             String[] endMarkers,
             int[] arrayPositioner,
             DataFieldResolver dataFieldResolver)
               throws IOException

Parses the input string.

DataFields are resolved using this parser's dataFieldResolver, keyword resolution is delegated to a KeywordResolver. The input that is not withing a tag (keyword or datafield) is written directly to out unless it is consumed by a KeywordResolver.

NOTE: For the initial start of the parsing use perform()

The arrayPositioner holds the postions to be used for resolving multi-dimensional fields. E.g. in a loop construct arrayPositioner[0] will hold the iteration (starting from 0) of the outer most loop, arrayPositioner[1] holds the iteration of the first inner loop.

Parameters:

out - the current output reader.

endMarkers - the currently expected endMarkers.

arrayPositioner - the current arrayPositioner.

Returns:

the reached end-marker if one has been reached, null otherwise (i.e. when the end of in has been reached)

Throws:

IOException

See Also:

resolve(String, Reader, Writer, DataFieldResolver, String[], int[])