TolerantSaxDocumentBuilder (XMLUnit for Java 2.0.0 API)

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 and Description

TolerantSaxDocumentBuilder(DocumentBuilder documentBuilder)
Constructor for specific JAXP parser

Constructors
Constructor and Description
`TolerantSaxDocumentBuilder(DocumentBuilder documentBuilder)` Constructor for specific JAXP parser

Method Summary

Methods
Modifier and Type	Method and 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

- Constructor Detail
  - 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
- Method Detail
  - 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

Class TolerantSaxDocumentBuilder

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

Constructor Detail

TolerantSaxDocumentBuilder

Method Detail

getDocument

getTrace

startDocument

endDocument

characters

startElement

endElement

endPrefixMapping

ignorableWhitespace

processingInstruction

setDocumentLocator

skippedEntity

startPrefixMapping

startDTD

endDTD

startEntity

endEntity

startCDATA

endCDATA

comment