gnu.xml.dom
Class DomIterator
java.lang.Object
|
+--gnu.xml.dom.DomIterator
All Implemented Interfaces:
NodeIterator, EventListener
public final class
DomIteratorextends
Objectimplements NodeIterator, EventListener
"NodeIterator" implementation, usable with any L2 DOM which
supports MutationEvents.
Author:DomIterator
protected DomIterator(org.w3c.dom.Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)
Constructs and initializes an iterator.
Parameters:
detach
public void detach()
DOM L2
Flags the iterator as done, unregistering its event listener so
that the iterator can be garbage collected without relying on weak
references (a "Java 2" feature) in the event subsystem.
getExpandEntityReferences
public boolean getExpandEntityReferences()
DOM L2
Returns the flag controlling whether iteration descends
through entity references.
getFilter
public NodeFilter getFilter()
DOM L2
Returns the filter provided during construction.
getRoot
public Node getRoot()
DOM L2
Returns the root of the tree this is iterating through.
getWhatToShow
public int getWhatToShow()
DOM L2
Returns the mask of flags provided during construction.
handleEvent
public void handleEvent(org.w3c.dom.events.Event e)
Not for public use. This lets the iterator know when its
reference node will be removed from the tree, so that a new
one may be selected.
This version works by watching removal events as they
bubble up. So, don't prevent them from bubbling.
Parameters:
nextNode
public Node nextNode()
DOM L2
Returns the next node in a forward iteration, masked and filtered.
Note that the node may be read-only due to entity expansions.
A null return indicates the iteration is complete, but may still
be processed backwards.
previousNode
public Node previousNode()
DOM L2
Returns the next node in a backward iteration, masked and filtered.
Note that the node may be read-only due to entity expansions.
A null return indicates the iteration is complete, but may still
be processed forwards.
"NodeIterator" implementation, usable with any L2 DOM which supports MutationEvents.