Interface DomDocument
- All Known Implementing Classes:
DomDocumentImpl
public interface DomDocument
Encapsulates a
Document. Implementations of this interface must be thread-safe.- Author:
- Sebastian Menski
-
Method Summary
Modifier and TypeMethodDescriptionclone()Clones the DOM document.createElement(String namespaceUri, String localName) Creates a new element in the dom document.Returns a newDOMSourceof the document.getElementById(String id) Gets an element by its id.getElementsByNameNs(String namespaceUri, String localName) Gets all elements with the namespace and name.Returns the root element of the document.registerNamespace(String namespaceUri) Registers a new namespace with a generic prefix.voidregisterNamespace(String prefix, String namespaceUri) Registers a new namespace for the prefix.voidsetRootElement(DomElement rootElement) Sets the root element of the DOM document.
-
Method Details
-
getRootElement
DomElement getRootElement()Returns the root element of the document.- Returns:
- the root element or null if non exists
-
setRootElement
Sets the root element of the DOM document. Replace an existing if necessary.- Parameters:
rootElement- the new root element
-
createElement
Creates a new element in the dom document.- Parameters:
namespaceUri- the namespaceUri of the new elementlocalName- the localName of the new element- Returns:
- the new DOM element
-
getElementById
Gets an element by its id.- Parameters:
id- the id to search for- Returns:
- the element or null if no such element exists
-
getElementsByNameNs
Gets all elements with the namespace and name.- Parameters:
namespaceUri- the element namespaceURI to search forlocalName- the element name to search for- Returns:
- the list of matching elements
-
getDomSource
DOMSource getDomSource()Returns a newDOMSourceof the document. Note that aDOMSourcewraps the underlyingDocumentwhich is not thread-safe. Multiple DOMSources of the same document should be synchronized by the calling application.- Returns:
- the new
DOMSource
-
registerNamespace
Registers a new namespace with a generic prefix.- Parameters:
namespaceUri- the namespaceUri of the new namespace- Returns:
- the used prefix
-
registerNamespace
Registers a new namespace for the prefix.- Parameters:
prefix- the prefix of the new namespacenamespaceUri- the namespaceUri of the new namespace
-
clone
DomDocument clone()Clones the DOM document.- Returns:
- the cloned DOM document
-