http://www.jpicedt.org

jpicedt.format.input
Class DefaultParser

java.lang.Object
  extended by jpicedt.format.input.util.AbstractRegularExpression
      extended by jpicedt.format.input.util.SequenceExpression
          extended by jpicedt.format.input.DefaultParser
All Implemented Interfaces:
ExpressionConstants, Parser

public class DefaultParser
extends SequenceExpression
implements ExpressionConstants, Parser

Default implementation of the Parser interface.

This expression doesn't contains rules in itself. On the contrary, it simply lumps sub-trees together, each sub-tree containing grammar rules for a particular format, e.g. PsTricks, eepic,...

Basically, this parser hold data using three objects :

[Developpers] for those willing to add their own parser to the tree, simply write a new parser-tree whose root expression inherits from RootExpression, then add it to this parser by using the addGrammar method.

Since:
jpicedt 1.2
Version:
$Id: DefaultParser.java,v 1.8.2.1 2007/09/02 11:56:00 reynal Exp $
Author:
Sylvain Reynal

Field Summary
protected  Context context
          holds information about the current parser state
protected  AlternateExpression headExp
          holds a reference to each supported grammar
protected  Pool pool
          a pool of primitive types and objects that may be shared by sub-expressions
 
Fields inherited from interface jpicedt.format.input.util.ExpressionConstants
ANY_CHAR, ANY_CHAR_EOL, ANY_SIGN, AT_LEAST, AT_MOST, DEBUG, DOUBLE, EOL, EXACTLY, INTEGER, NEGATIVE, NON_NULL, POSITIVE, STRICTLY_NEGATIVE, STRICTLY_POSITIVE, WHITE_SPACES, WHITE_SPACES_OR_EOL
 
Constructor Summary
DefaultParser()
          Creates a new DefaultParser, and attach some grammar rules to it.
Tree structure = (WhiteSpaceOrEOL & (headExp | notParsable))*
where : headExp = Root1 | Root2 | Root3 ...
 
Method Summary
 void addGrammar(RootExpression root)
          Add a new sub-tree to this parser
 Pool getPool()
          Return the pool containing variables shared across the grammar tree
static void main(String[] arg)
          parser standalone test
 Drawing parse(Reader reader)
          kicks off the parsing process
 String toString()
           
 
Methods inherited from class jpicedt.format.input.util.SequenceExpression
add, interpret
 
Methods inherited from class jpicedt.format.input.util.AbstractRegularExpression
action
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

pool

protected Pool pool
a pool of primitive types and objects that may be shared by sub-expressions


context

protected Context context
holds information about the current parser state


headExp

protected AlternateExpression headExp
holds a reference to each supported grammar

Constructor Detail

DefaultParser

public DefaultParser()
Creates a new DefaultParser, and attach some grammar rules to it.
Tree structure = (WhiteSpaceOrEOL & (headExp | notParsable))*
where : headExp = Root1 | Root2 | Root3 ... (each RootX sub-tree representing a particular format).

Note that with this current structure, sub-trees must NOT be mutually exclusive, ie it's ok with eepic and pstricks for instance (it wouldn't work with PDF and LaTeX, since once we've started with PDF, it wouldn't make sense trying to parse LaTeX commands...) ->

Method Detail

addGrammar

public void addGrammar(RootExpression root)
Add a new sub-tree to this parser


getPool

public Pool getPool()
Return the pool containing variables shared across the grammar tree


parse

public Drawing parse(Reader reader)
              throws REParserException
kicks off the parsing process

Specified by:
parse in interface Parser
Returns:
a new instance of a Drawing populated from the content of the given reader
Throws:
REParserException

toString

public String toString()
Overrides:
toString in class SequenceExpression
Returns:
a String representation of this Parser, i.e. global variables contents

main

public static void main(String[] arg)
parser standalone test

Parameters:
arg[0] - name of file to parse.

http://www.jpicedt.org

Submit a bug : syd@jpicedt.org