com.gargoylesoftware.htmlunit.html.parser

Interface HTMLParser

All Known Implementing Classes:

HtmlUnitNekoHtmlParser

public interface HTMLParser

Interface for the parser used to parse HTML into a HtmlUnit-specific DOM (HU-DOM) tree.

Author:

Christian Sell, David K. Taylor, Chris Erskine, Ahmed Ashour, Marc Guillemot, Ethan Glasser-Camp, Sudhan Moghe, Ronald Brill, Frank Danek, Carsten Steul

Method Summary

Modifier and Type	Method and Description
ElementFactory	getElementFactory(SgmlPage page, String namespaceURI, String qualifiedName, boolean insideSvg, boolean svgSupport) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
ElementFactory	getFactory(String tagName) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
ElementFactory	getSvgFactory() INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
void	parseFragment(DomNode parent, DomNode context, String source) Parses the HTML content from the given string into an object tree representation.
void	parseFragment(DomNode parent, String source) Parses the HTML content from the given string into an object tree representation.
HtmlPage	parseHtml(WebResponse webResponse, WebWindow webWindow) Parses the HTML content from the specified WebResponse into an object tree representation.
XHtmlPage	parseXHtml(WebResponse webResponse, WebWindow webWindow) Parses the XHTML content from the specified WebResponse into an object tree representation.

Method Detail

getFactory

ElementFactory getFactory(String tagName)

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.

Parameters:

tagName - an HTML element tag name

Returns:

a factory for creating HtmlElements representing the given tag

getSvgFactory

ElementFactory getSvgFactory()

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.

Returns:

a factory for creating SvgElements representing the given tag

getElementFactory

ElementFactory getElementFactory(SgmlPage page,
                                 String namespaceURI,
                                 String qualifiedName,
                                 boolean insideSvg,
                                 boolean svgSupport)

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Returns the pre-registered element factory corresponding to the specified tag, or an UnknownElementFactory.

Parameters:

page - the page

namespaceURI - the namespace URI

qualifiedName - the qualified name

insideSvg - is the node inside an SVG node or not

svgSupport - true if called from javascript createElementNS

Returns:

the pre-registered element factory corresponding to the specified tag, or an UnknownElementFactory

parseFragment

void parseFragment(DomNode parent,
                   String source)
            throws SAXException,
                   IOException

Parses the HTML content from the given string into an object tree representation.

Parameters:

parent - the parent for the new nodes

source - the (X)HTML to be parsed

Throws:

SAXException - if a SAX error occurs

IOException - if an IO error occurs

parseFragment

void parseFragment(DomNode parent,
                   DomNode context,
                   String source)
            throws SAXException,
                   IOException

Parses the HTML content from the given string into an object tree representation.

Parameters:

parent - where the new parsed nodes will be added to

context - the context to build the fragment context stack

source - the (X)HTML to be parsed

Throws:

SAXException - if a SAX error occurs

IOException - if an IO error occurs

parseHtml

HtmlPage parseHtml(WebResponse webResponse,
                   WebWindow webWindow)
            throws IOException

Parses the HTML content from the specified WebResponse into an object tree representation.

Parameters:

webResponse - the response data

webWindow - the web window into which the page is to be loaded

Returns:

the page object which is the root of the DOM tree

Throws:

IOException - if there is an IO error

parseXHtml

XHtmlPage parseXHtml(WebResponse webResponse,
                     WebWindow webWindow)
              throws IOException

Parses the XHTML content from the specified WebResponse into an object tree representation.

Parameters:

webResponse - the response data

webWindow - the web window into which the page is to be loaded

Returns:

the page object which is the root of the DOM tree

Throws:

IOException - if there is an IO error