jpicedt.graphic.io.parser
Class JPICParser

java.lang.Object
  jpicedt.graphic.io.parser.JPICParser

All Implemented Interfaces:

ExtractionParsing, Parser

public class JPICParser
extends Object
implements ExtractionParsing

An implementation of the Parser interface dedicated to parsing JPIC-XML files.

How it works : We first try to know if we're parsing a JPIC-XML formatted file, i.e. starting with a "%%Begin JPIC-XML" marker. If this is the case :

• look up matching "%%End JPIC-XML" marker
• save text between both markers, and drop leading "%"
• pass corresponding text to our JPIC-XML parser (implementation based on a Java-SAX parser).
• return parsed Drawing (parsing process then stops here)

Otherwise, go ahead using the fallback Parser, if any.

Since:

jpicedt 1.3.3

Version:

$Id: JPICParser.java,v 1.12 2013/03/27 07:21:19 vincentb1 Exp $

Author:

Sylvain Reynal

Constructor Summary

JPICParser()

Method Summary

static ParsedDrawing	extractAndParse(CodedContentExtraction extractor, Parser parser, Reader reader)
ParsedDrawing	extractAndParse(Reader reader) kicks off the parsing process
static void	main(String[] args) for quick debugging purpose
Drawing	parse(Reader reader) Fourni pour compatibilité ascendante.
void	parse(Reader reader, ParsedDrawing parsedDrawing) Analyse du dessin codé seulement, l'extraction a déjà été faite par l'appelant.

Methods inherited from class java.lang.Object

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

Constructor Detail

JPICParser

public JPICParser()

Method Detail

extractAndParse

public ParsedDrawing extractAndParse(Reader reader)
                              throws ParserException

kicks off the parsing process

Specified by:

extractAndParse in interface ExtractionParsing

Returns:

a new instance of a Drawing populated from the content of the given reader, along with extra-drawing information obtained by the extractor.

Throws:

ParserException - when a parsing error was encountered, e.g. syntax error, block mismatch,...

parse

public void parse(Reader reader,
                  ParsedDrawing parsedDrawing)
           throws ParserException

Analyse du dessin codé seulement, l'extraction a déjà été faite par l'appelant.

Specified by:

parse in interface Parser

Parameters:

parsedDrawing - valeur retournée d'une nouvelle instance de dessin (Drawing) peuplée des éléments instanciée lors de l'analyse du dessin codé lu à partir du reader.

Throws:

ParserException - en cas d'erreur lors de l'analyse syntaxique.

Since:

JpicEdt 1.6

parse

public Drawing parse(Reader reader)
              throws ParserException

Fourni pour compatibilité ascendante. Utiliser parse(Reader reader,ParsedDrawing parsedDrawing).

Specified by:

parse in interface Parser

Returns:

Un nouvel expample d'un Drawing peuplé des objets graphiques résultant des l'analyse des données lues par le reader passé en argument.

Throws:

ParserException

Since:

JpicEdt 1.6

main

public static void main(String[] args)

for quick debugging purpose

extractAndParse

public static ParsedDrawing extractAndParse(CodedContentExtraction extractor,
                                            Parser parser,
                                            Reader reader)
                                     throws ParserException

Throws:

ParserException