org.w3c.dom.traversal
Interface DocumentTraversal

All Known Implementing Classes:

DocumentImpl

public interface DocumentTraversal

DocumentTraversal contains methods that create iterators and tree-walkers to traverse a node and its children in document order (depth first, pre-order traversal, which is equivalent to the order in which the start tags occur in the text representation of the document).

Since:

DOM Level 2

Method Summary

NodeIterator	createNodeIterator(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion) Create a new NodeIterator over the subtree rooted at the specified node.
TreeWalker	createTreeWalker(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion) Create a new TreeWalker over the subtree rooted at the specified node.

Method Detail

createNodeIterator

public NodeIterator createNodeIterator(Node root,
                                       int whatToShow,
                                       NodeFilter filter,
                                       boolean entityReferenceExpansion)

Create a new NodeIterator over the subtree rooted at the specified node.

Parameters:

root - The node which will be iterated together with its children. The iterator is initially positioned just before this node. The whatToShow flags and the filter, if any, are not considered when setting this position.

whatToShow - This flag specifies which node types may appear in the logical view of the tree presented by the iterator. See the description of iterator for the set of possible values. These flags can be combined using OR .

filter - The Filter to be used with this TreeWalker, or null to indicate no filter.

entityReferenceExpansion - The value of this flag determines whether entity reference nodes are expanded.

Returns:

The newly created NodeIterator .

createTreeWalker

public TreeWalker createTreeWalker(Node root,
                                   int whatToShow,
                                   NodeFilter filter,
                                   boolean entityReferenceExpansion)
                            throws DOMException

Create a new TreeWalker over the subtree rooted at the specified node.

Parameters:

root - The node which will serve as the root for the TreeWalker . The whatToShow flags and the NodeFilter are not considered when setting this value; any node type will be accepted as the root. The currentNode of the TreeWalker is initialized to this node, whether or not it is visible. The root functions as a stopping point for traversal methods that look upward in the document structure, such as parentNode and nextNode. The root must not be null.

whatToShow - This flag specifies which node types may appear in the logical view of the tree presented by the iterator. See the description of TreeWalker for the set of possible values. These flags can be combined using OR .

filter - The Filter to be used with this TreeWalker, or null to indicate no filter.

entityReferenceExpansion - The value of this flag determines whether entity reference nodes are expanded.

Returns:

The newly created TreeWalker .

Throws:

DOMException - Raises the exception NOT_SUPPORTED_ERR if the specified root node is null.