org.eigenbase.xom.wrappers

Class XercesDOMParser

java.lang.Object

org.eigenbase.xom.wrappers.XercesDOMParser

All Implemented Interfaces:

Locator, Parser, ErrorHandler

public class XercesDOMParser
extends Object

This private helper class presents a GenericDOMParser using Xerces, with simple error handling appropriate for a testing environment.

Field Summary

Fields

Modifier and Type	Field and Description
protected Document	document The document which spawns elements.

Constructor Summary

Constructors

Constructor and Description
XercesDOMParser() Constructs a non-validating Xerces DOM Parser.
XercesDOMParser(boolean validate) Constructs a Xerces DOM Parser.

Method Summary

Modifier and Type	Method and Description
DOMWrapper	create(String tagName) Creates a wrapper representing an XML element.
void	error(SAXParseException ex) Error.
void	fatalError(SAXParseException ex) Fatal error.
Location	getLocation(DOMWrapper wrapper)
protected void	handleErrors()
boolean	isKeepPositions() Returns whether the parser is retaining position information.
DOMWrapper	parse(InputStream is) Parses an input stream and returns a wrapped element.
DOMWrapper	parse(Reader reader) Parses the contents of a reader and returns a wrapped element.
DOMWrapper	parse(String xmlString) Parses a string and returns a wrapped element.
DOMWrapper	parse(URL url) Parses the contents of a URL and returns a wrapped element.
protected Document	parseInputSource(InputSource in) Parses the specified URI and returns the document.
protected void	prepareParse()
void	setKeepPositions(boolean keepPositions) Sets whether to retain position information.
void	warning(SAXParseException ex) Warning.

Methods inherited from class java.lang.Object

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

Field Detail

document

protected Document document

The document which spawns elements. The constructor of the derived class must set this.

Constructor Detail

XercesDOMParser

public XercesDOMParser()
                throws XOMException

Constructs a non-validating Xerces DOM Parser.

Throws:

XOMException

XercesDOMParser

public XercesDOMParser(boolean validate)
                throws XOMException

Constructs a Xerces DOM Parser.

Parameters:

validate - whether to enable validation

Throws:

XOMException

Method Detail

parseInputSource

protected Document parseInputSource(InputSource in)
                             throws XOMException

Parses the specified URI and returns the document.

Parameters:

in - Input source

Returns:

Document

Throws:

XOMException - on error

create

public DOMWrapper create(String tagName)

Description copied from interface: Parser

Creates a wrapper representing an XML element.

Specified by:

create in interface Parser

Parameters:

tagName - Name of element

Returns:

Wrapper element

parse

public DOMWrapper parse(InputStream is)
                 throws XOMException

Description copied from interface: Parser

Parses an input stream and returns a wrapped element.

Specified by:

parse in interface Parser

Parameters:

is - Input stream

Returns:

Wrapped element

Throws:

XOMException - on error

setKeepPositions

public void setKeepPositions(boolean keepPositions)

Description copied from interface: Parser

Sets whether to retain position information.

Specified by:

setKeepPositions in interface Parser

Parameters:

keepPositions - Whether to keep position information.

isKeepPositions

public boolean isKeepPositions()

Description copied from interface: Parser

Returns whether the parser is retaining position information.

Specified by:

isKeepPositions in interface Parser

Returns:

Whether to keep position information.

parse

public DOMWrapper parse(String xmlString)
                 throws XOMException

Description copied from interface: Parser

Parses a string and returns a wrapped element.

Specified by:

parse in interface Parser

Parameters:

xmlString - XML string

Returns:

Wrapped element

Throws:

XOMException - on error

parse

public DOMWrapper parse(Reader reader)
                 throws XOMException

Description copied from interface: Parser

Parses the contents of a reader and returns a wrapped element.

Specified by:

parse in interface Parser

Parameters:

reader - Reader

Returns:

Wrapped element

Throws:

XOMException - on error

warning

public void warning(SAXParseException ex)

Warning.

Specified by:

warning in interface ErrorHandler

error

public void error(SAXParseException ex)

Error.

Specified by:

error in interface ErrorHandler

fatalError

public void fatalError(SAXParseException ex)
                throws SAXException

Fatal error.

Specified by:

fatalError in interface ErrorHandler

Throws:

SAXException

parse

public DOMWrapper parse(URL url)
                 throws XOMException

Description copied from interface: Parser

Parses the contents of a URL and returns a wrapped element.

Specified by:

parse in interface Parser

Parameters:

url - URL

Returns:

Wrapped element

Throws:

XOMException - on error

prepareParse

protected void prepareParse()

handleErrors

protected void handleErrors()
                     throws XOMException

Throws:

XOMException

getLocation

public Location getLocation(DOMWrapper wrapper)

Specified by:

getLocation in interface Locator