Package org.custommonkey.xmlunit

Class TolerantSaxDocumentBuilder

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.custommonkey.xmlunit.TolerantSaxDocumentBuilder

All Implemented Interfaces:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler, LexicalHandler

public class TolerantSaxDocumentBuilder
extends DefaultHandler
implements LexicalHandler

Uses Sax events from the ContentHandler and LexicalHandler interfaces to build a DOM document in a tolerant fashion -- it can cope with start tags without end tags, and end tags without start tags for example. Although this subverts the idea of XML being well-formed, it is intended for use with HTML pages so that they can be transformed into DOM trees, without being XHTML to start with. Note that this class currently does not handle entity, DTD or CDATA tags.

See Also:

• HTMLDocumentBuilder.parse(java.io.Reader)

Constructor Summary

Constructors

Constructor	Description
TolerantSaxDocumentBuilder(DocumentBuilder documentBuilder)	Constructor for specific JAXP parser

Method Summary

Modifier and Type	Method	Description
void	characters(char[] data, int start, int length)	ContentHandler method.
void	comment(char[] ch, int start, int length)	LexicalHandler method
void	endCDATA()	Unhandled LexicalHandler method
void	endDocument()	ContentHandler method
void	endDTD()	Unhandled LexicalHandler method
void	endElement(String namespaceURI, String localName, String qName)	ContentHandler method
void	endEntity(String name)	Unhandled LexicalHandler method
void	endPrefixMapping(String prefix)	Unhandled ContentHandler method
Document	getDocument()
String	getTrace()
void	ignorableWhitespace(char[] ch, int start, int length)	Unhandled ContentHandler method
void	processingInstruction(String target, String data)	ContentHandler method
void	setDocumentLocator(Locator locator)	Unhandled ContentHandler method
void	skippedEntity(String name)	Unhandled ContentHandler method
void	startCDATA()	Unhandled LexicalHandler method
void	startDocument()	ContentHandler method
void	startDTD(String name, String publicId, String systemId)	Unhandled LexicalHandler method.
void	startElement(String namespaceURI, String localName, String qName, Attributes atts)	ContentHandler method
void	startEntity(String name)	Unhandled LexicalHandler method
void	startPrefixMapping(String prefix, String uri)	Unhandled ContentHandler method

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

error, fatalError, notationDecl, resolveEntity, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xml.sax.ContentHandler

declaration

Constructor Details

TolerantSaxDocumentBuilder

public TolerantSaxDocumentBuilder(DocumentBuilder documentBuilder)
                           throws ParserConfigurationException

Constructor for specific JAXP parser

Parameters:

documentBuilder - the JAXP parser to use to construct an empty DOM document that will be built up with SAX calls

Throws:

ParserConfigurationException - if JAXP feels like it

Method Details

getDocument

public Document getDocument()

Returns:

the Document built up through the Sax calls

getTrace

public String getTrace()

Returns:

the trace of Sax calls that were used to build up the Document

startDocument

public void startDocument()
                   throws SAXException

ContentHandler method

Specified by:

startDocument in interface ContentHandler

Overrides:

startDocument in class DefaultHandler

Throws:

SAXException

endDocument

public void endDocument()
                 throws SAXException

ContentHandler method

Specified by:

endDocument in interface ContentHandler

Overrides:

endDocument in class DefaultHandler

Throws:

SAXException

characters

public void characters(char[] data,
 int start,
 int length)

ContentHandler method.

Specified by:

characters in interface ContentHandler

Overrides:

characters in class DefaultHandler

startElement

public void startElement(String namespaceURI,
 String localName,
 String qName,
 Attributes atts)
                  throws SAXException

ContentHandler method

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class DefaultHandler

Throws:

SAXException

endElement

public void endElement(String namespaceURI,
 String localName,
 String qName)
                throws SAXException

ContentHandler method

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class DefaultHandler

Throws:

SAXException

endPrefixMapping

public void endPrefixMapping(String prefix)
                      throws SAXException

Unhandled ContentHandler method

Specified by:

endPrefixMapping in interface ContentHandler

Overrides:

endPrefixMapping in class DefaultHandler

Throws:

SAXException

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
 int start,
 int length)
                         throws SAXException

Unhandled ContentHandler method

Specified by:

ignorableWhitespace in interface ContentHandler

Overrides:

ignorableWhitespace in class DefaultHandler

Throws:

SAXException

processingInstruction

public void processingInstruction(String target,
 String data)
                           throws SAXException

ContentHandler method

Specified by:

processingInstruction in interface ContentHandler

Overrides:

processingInstruction in class DefaultHandler

Throws:

SAXException

setDocumentLocator

public void setDocumentLocator(Locator locator)

Unhandled ContentHandler method

Specified by:

setDocumentLocator in interface ContentHandler

Overrides:

setDocumentLocator in class DefaultHandler

skippedEntity

public void skippedEntity(String name)
                   throws SAXException

Unhandled ContentHandler method

Specified by:

skippedEntity in interface ContentHandler

Overrides:

skippedEntity in class DefaultHandler

Throws:

SAXException

startPrefixMapping

public void startPrefixMapping(String prefix,
 String uri)
                        throws SAXException

Unhandled ContentHandler method

Specified by:

startPrefixMapping in interface ContentHandler

Overrides:

startPrefixMapping in class DefaultHandler

Throws:

SAXException

startDTD

public void startDTD(String name,
 String publicId,
 String systemId)
              throws SAXException

Unhandled LexicalHandler method. DOM currently doesn't allow DTD to be retrofitted onto a Document.

Specified by:

startDTD in interface LexicalHandler

Throws:

SAXException

endDTD

public void endDTD()
            throws SAXException

Unhandled LexicalHandler method

Specified by:

endDTD in interface LexicalHandler

Throws:

SAXException

startEntity

public void startEntity(String name)
                 throws SAXException

Unhandled LexicalHandler method

Specified by:

startEntity in interface LexicalHandler

Throws:

SAXException

endEntity

public void endEntity(String name)
               throws SAXException

Unhandled LexicalHandler method

Specified by:

endEntity in interface LexicalHandler

Throws:

SAXException

startCDATA

public void startCDATA()
                throws SAXException

Unhandled LexicalHandler method

Specified by:

startCDATA in interface LexicalHandler

Throws:

SAXException

endCDATA

public void endCDATA()
              throws SAXException

Unhandled LexicalHandler method

Specified by:

endCDATA in interface LexicalHandler

Throws:

SAXException

comment

public void comment(char[] ch,
 int start,
 int length)
             throws SAXException

LexicalHandler method

Specified by:

comment in interface LexicalHandler

Throws:

SAXException