org.custommonkey.xmlunit

Class HTMLDocumentBuilder

java.lang.Object

org.custommonkey.xmlunit.HTMLDocumentBuilder

public class HTMLDocumentBuilder
extends Object

Build a DOM document from HTML content converting from 'plain' HTML into 'XHTML' along the way with the help of a TolerantSaxDocumentBuilder and the Swing html parser classes. This allows XML assertions to be made against badly formed HTML.

See Also:

TolerantSaxDocumentBuilder

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	HTMLDocumentBuilder.SwingEvent2SaxAdapter Adapts Swing HTML callback messages to Sax equivalents, passing them to a Sax-aware ContentHandler.

Field Summary

Fields

Modifier and Type	Field and Description
protected HTMLDocumentBuilder.SwingEvent2SaxAdapter	swingEvent2SaxAdapter The adapter between Swing and SAX.
protected TolerantSaxDocumentBuilder	tolerantSaxDocumentBuilder The document builder.

Constructor Summary

Constructors

Constructor and Description
HTMLDocumentBuilder(TolerantSaxDocumentBuilder tolerantSaxDocumentBuilder) Constructor

Method Summary

Modifier and Type	Method and Description
String	getTrace()
Document	parse(Reader reader) Parses the document.
Document	parse(String htmlString) Parses the document.

Methods inherited from class java.lang.Object

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

Field Detail

tolerantSaxDocumentBuilder

protected final TolerantSaxDocumentBuilder tolerantSaxDocumentBuilder

The document builder.

swingEvent2SaxAdapter

protected final HTMLDocumentBuilder.SwingEvent2SaxAdapter swingEvent2SaxAdapter

The adapter between Swing and SAX.

Constructor Detail

HTMLDocumentBuilder

public HTMLDocumentBuilder(TolerantSaxDocumentBuilder tolerantSaxDocumentBuilder)

Constructor

Parameters:

tolerantSaxDocumentBuilder - the instance that will receive SAX calls generated as the HTML is parsed and build up a DOM Document

Method Detail

parse

public Document parse(Reader reader)
               throws SAXException,
                      IOException

Parses the document.

Not thread-safe!

Parameters:

reader - reader to read the document from

Returns:

a DOM document parsed from the Reader via an SwingEvent2SaxAdapter and TolerantSaxBuilder.

Throws:

SAXException - if the parser feels like it

IOException - on I/O errors

See Also:

TolerantSaxDocumentBuilder

parse

public Document parse(String htmlString)
               throws SAXException,
                      IOException

Parses the document.

Not thread-safe!

Parameters:

htmlString - string to read the document from

Returns:

a DOM document parsed from the String via an SwingEvent2SaxAdapter and TolerantSaxBuilder.

Throws:

SAXException - if the parser feels like it

IOException - on I/O errors

See Also:

TolerantSaxDocumentBuilder

getTrace

public String getTrace()

Returns:

the trace of events and / or warnings encountered during parsing