proper.xml
Class Parser

java.lang.Object
  org.xml.sax.helpers.DefaultHandler
      proper.xml.Parser

All Implemented Interfaces:

org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

public class Parser
extends org.xml.sax.helpers.DefaultHandler

This class parses XML files.
based on Echo02.java from Sun.

Version:

$Revision: 1.2 $

Author:

FracPete

Constructor Summary

Parser()
initializes the object

Method Summary

void	characters(char[] buf, int offset, int len) characters were read
void	endDocument() when the parsing ends
void	endElement(java.lang.String namespaceURI, java.lang.String sName, java.lang.String qName) when an element ends
void	error(org.xml.sax.SAXParseException e) an error happens and is stored
java.util.Vector	getErrors() returns the errors that happened during parsing (of type SAXParseException)
java.lang.String	getPI() returns the processing instructions
Element	getRoot() returns the root element
boolean	getValidate() returns whether the parsing is validated or not
java.util.Vector	getWarnings() returns the warnings accumulated during parsing (of type SAXParseException)
boolean	hasErrors() returns whether any errors happened during parsing
boolean	hasWarnings() returns whether there were any warnings during the parsing
static void	main(java.lang.String[] args) for testing only
void	parse(java.io.Reader reader) parses the given reader
void	parse(java.lang.String filename) parses the given file
void	setValidate(boolean validate) whether to validate the parsing or not
void	startDocument() when the parsing starts
void	startElement(java.lang.String namespaceURI, java.lang.String lName, java.lang.String qName, org.xml.sax.Attributes attrs) when an element starts
void	warning(org.xml.sax.SAXParseException e) a warning is raised and stored

Methods inherited from class org.xml.sax.helpers.DefaultHandler

endPrefixMapping, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startPrefixMapping, unparsedEntityDecl

Methods inherited from class java.lang.Object

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

Constructor Detail

Parser

public Parser()

initializes the object

Method Detail

getPI

public java.lang.String getPI()

returns the processing instructions

setValidate

public void setValidate(boolean validate)

whether to validate the parsing or not

getValidate

public boolean getValidate()

returns whether the parsing is validated or not

getRoot

public Element getRoot()

returns the root element

startDocument

public void startDocument()
                   throws org.xml.sax.SAXException

when the parsing starts

Specified by:

startDocument in interface org.xml.sax.ContentHandler

Overrides:

startDocument in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

endDocument

public void endDocument()
                 throws org.xml.sax.SAXException

when the parsing ends

Specified by:

endDocument in interface org.xml.sax.ContentHandler

Overrides:

endDocument in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

startElement

public void startElement(java.lang.String namespaceURI,
                         java.lang.String lName,
                         java.lang.String qName,
                         org.xml.sax.Attributes attrs)
                  throws org.xml.sax.SAXException

when an element starts

Specified by:

startElement in interface org.xml.sax.ContentHandler

Overrides:

startElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

endElement

public void endElement(java.lang.String namespaceURI,
                       java.lang.String sName,
                       java.lang.String qName)
                throws org.xml.sax.SAXException

when an element ends

Specified by:

endElement in interface org.xml.sax.ContentHandler

Overrides:

endElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

characters

public void characters(char[] buf,
                       int offset,
                       int len)
                throws org.xml.sax.SAXException

characters were read

Specified by:

characters in interface org.xml.sax.ContentHandler

Overrides:

characters in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

warning

public void warning(org.xml.sax.SAXParseException e)
             throws org.xml.sax.SAXException

a warning is raised and stored

Specified by:

warning in interface org.xml.sax.ErrorHandler

Overrides:

warning in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

getWarnings

public java.util.Vector getWarnings()

returns the warnings accumulated during parsing (of type SAXParseException)

hasWarnings

public boolean hasWarnings()

returns whether there were any warnings during the parsing

error

public void error(org.xml.sax.SAXParseException e)
           throws org.xml.sax.SAXException

an error happens and is stored

Specified by:

error in interface org.xml.sax.ErrorHandler

Overrides:

error in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

getErrors

public java.util.Vector getErrors()

returns the errors that happened during parsing (of type SAXParseException)

hasErrors

public boolean hasErrors()

returns whether any errors happened during parsing

parse

public void parse(java.lang.String filename)

parses the given file

parse

public void parse(java.io.Reader reader)

parses the given reader

main

public static void main(java.lang.String[] args)

for testing only