Module org.htmlunit

Package org.htmlunit.util

Class XmlUtils

java.lang.Object

org.htmlunit.util.XmlUtils

public final class XmlUtils
extends Object

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Provides utility methods for working with XML responses.

Author:

Marc Guillemot, Ahmed Ashour, Sudhan Moghe, Ronald Brill, Chuck Dumont, Frank Danek

Method Summary

Modifier and Type	Method	Description
static void	appendChild(SgmlPage page, DomNode parent, Node child, boolean handleXHTMLAsHTML)	Recursively appends a Node child to a DomNode parent.
static Document	buildDocument(WebResponse webResponse)	Builds a document from the content of the web response.
static String	lookupNamespaceURI(DomElement element, String prefix)	Searches for the namespace URI bound to the given prefix, starting from the specified element.
static String	lookupPrefix(DomElement element, String namespace)	Searches for the prefix associated with the specified namespace URI, starting from the given element.

Methods inherited from class java.lang.Object

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

Method Details

buildDocument

public static Document buildDocument(WebResponse webResponse)
                              throws IOException,
SAXException,
ParserConfigurationException

Builds a document from the content of the web response. A warning is logged if an exception is thrown while parsing the XML content (for instance when the content is not valid XML and cannot be parsed).

Parameters:

webResponse - the response from the server

Returns:

the parse result

Throws:

IOException - if the page could not be created

SAXException - if parsing fails

ParserConfigurationException - if a DocumentBuilder cannot be created

appendChild

public static void appendChild(SgmlPage page,
 DomNode parent,
 Node child,
 boolean handleXHTMLAsHTML)

Recursively appends a Node child to a DomNode parent.

Parameters:

page - the owner page of DomElements to be created

parent - the parent DomNode

child - the child Node to append

handleXHTMLAsHTML - if true, elements from the XHTML namespace are handled as HTML elements instead of DOM elements

lookupNamespaceURI

public static String lookupNamespaceURI(DomElement element,
 String prefix)

Searches for the namespace URI bound to the given prefix, starting from the specified element. The default namespace can be searched for by passing an empty string as the prefix.

Parameters:

element - the element to start searching from

prefix - the namespace prefix to look up; use "" for the default namespace

Returns:

the namespace URI bound to the prefix, or null if none is found

lookupPrefix

public static String lookupPrefix(DomElement element,
 String namespace)

Searches for the prefix associated with the specified namespace URI, starting from the given element.

Parameters:

element - the element to start searching from

namespace - the namespace URI to look up

Returns:

the prefix bound to the namespace URI, or null if none is found