Module org.htmlunit.cyberneko
Package org.htmlunit.cyberneko.xerces.dom

Class NodeImpl

java.lang.Object
org.htmlunit.cyberneko.xerces.dom.NodeImpl
All Implemented Interfaces:
Cloneable, EventTarget, Node, NodeList
Direct Known Subclasses:
AttrImpl, ChildNode
public abstract class NodeImpl extends Object implements Node, NodeList, EventTarget, Cloneable
NodeImpl provides the basic structure of a DOM tree. It is never used directly, but instead is subclassed to add type and data information, and additional methods, appropriate to each node of the tree. Only its subclasses should be instantiated -- and those, with the exception of Document itself, only through a specific Document's factory methods.

The Node interface provides shared behaviors such as siblings and children, both for consistency and so that the most common tree operations may be performed without constantly having to downcast to specific node types. When there is no obvious mapping for one of these queries, it will respond with null. Note that the default behavior is that children are forbidden. To permit them, the subclass ParentNode overrides several methods.

NodeImpl also implements NodeList, so it can return itself in response to the getChildNodes() query. This eliminates the need for a separate ChildNodeList object. Note that this is an IMPLEMENTATION DETAIL; applications should never assume that this identity exists.

All nodes in a single document must originate in that document. (Note that this is much tighter than "must be same implementation") Nodes are all aware of their ownerDocument, and attempts to mismatch will throw WRONG_DOCUMENT_ERR.

However, to save memory not all nodes always have a direct reference to their ownerDocument. When a node is owned by another node it relies on its owner to store its ownerDocument. Parent nodes always store it though, so there is never more than one level of indirection. And when a node doesn't have an owner, ownerNode refers to its ownerDocument.

This class doesn't directly support mutation events; however, it still implements the EventTarget interface and forwards all related calls to the document so that the document class can do so.

Author:
Arnaud Le Hors, IBM, Joe Kesselman, IBM, Ronald Brill