com.jcorporate.expresso.core.misc
Class StringDOMParser

java.lang.Object
  com.jcorporate.expresso.core.misc.StringDOMParser

All Implemented Interfaces:

org.xml.sax.ErrorHandler

public class StringDOMParser

extends Object

implements org.xml.sax.ErrorHandler

Helper class to parse an xml formatted string and return a document

For high performance parsing, roll your own SAX-based parser instead.

Author:

Michael Rimov

Constructor Summary

StringDOMParser()

Method Summary

void	dumpDOM(org.w3c.dom.Node n) Dumps the DOM tree to the log.
void	error(org.xml.sax.SAXParseException ex) Issue an error
void	fatalError(org.xml.sax.SAXParseException ex) Fatal error.
org.w3c.dom.Document	parseString(char[] data) Given an XML formatted character array, return a DOM DOCUMENT based upon the data.
org.w3c.dom.Document	parseString(String data) Given an XML formatted string, return a DOM DOCUMENT based upon the data.
void	warning(org.xml.sax.SAXParseException ex) Issue a warning on parsing errors

Methods inherited from class java.lang.Object

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

Constructor Detail

StringDOMParser

public StringDOMParser()

Method Detail

parseString

public org.w3c.dom.Document parseString(String data)

Given an XML formatted string, return a DOM DOCUMENT based upon the data.

Parameters:

data - The string to parse

Returns:

The parsed Document or null if there was an error parsing the document. (Errors are logged)

parseString

public org.w3c.dom.Document parseString(char[] data)

Given an XML formatted character array, return a DOM DOCUMENT based upon the data.

Parameters:

data - The character array to parse

Returns:

The parsed Document or null if there was an error parsing the document. (Errors are logged)

warning

public void warning(org.xml.sax.SAXParseException ex)

Issue a warning on parsing errors

Specified by:

warning in interface org.xml.sax.ErrorHandler

Parameters:

ex - A Sax Parse Exception event

error

public void error(org.xml.sax.SAXParseException ex)

Issue an error

Specified by:

error in interface org.xml.sax.ErrorHandler

Parameters:

ex - A Sax Parse Exception event

fatalError

public void fatalError(org.xml.sax.SAXParseException ex)
                throws org.xml.sax.SAXException

Fatal error. Used Internally for parsing only

Specified by:

fatalError in interface org.xml.sax.ErrorHandler

Parameters:

ex - A Sax Parse Exception event

Throws:

org.xml.sax.SAXException - after logging the Parsing Exception

dumpDOM

public void dumpDOM(org.w3c.dom.Node n)

Dumps the DOM tree to the log. Info logging must be enabled for any output to appear.

Parameters:

n - The document node to dump.