Package org.htmlunit.xpath.axes
Class WalkingIterator
- java.lang.Object
-
- org.htmlunit.xpath.Expression
-
- org.htmlunit.xpath.patterns.NodeTest
-
- org.htmlunit.xpath.axes.PredicatedNodeTest
-
- org.htmlunit.xpath.axes.LocPathIterator
-
- org.htmlunit.xpath.axes.WalkingIterator
-
- All Implemented Interfaces:
java.lang.Cloneable,javax.xml.transform.SourceLocator,PathComponent,SubContextList,ExpressionNode,DTMIterator,XPathVisitable
- Direct Known Subclasses:
WalkingIteratorSorted
public class WalkingIterator extends LocPathIterator
Location path iterator that uses Walkers.
-
-
Field Summary
Fields Modifier and Type Field Description protected AxesWalkerm_firstWalkerThe head of the step walker list.protected AxesWalkerm_lastUsedWalkerThe last used step walker in the walker list.-
Fields inherited from class org.htmlunit.xpath.axes.LocPathIterator
m_cdtm, m_clones, m_context, m_currentContextNode, m_execContext, m_lastFetched, m_length, m_pos, m_stackFrame
-
Fields inherited from class org.htmlunit.xpath.axes.PredicatedNodeTest
DEBUG_PREDICATECOUNTING, m_foundLast, m_lpi, m_predCount, m_predicateIndex, m_proximityPositions
-
Fields inherited from class org.htmlunit.xpath.patterns.NodeTest
m_name, m_whatToShow, SCORE_NODETEST, SCORE_NONE, SCORE_NSWILD, SCORE_OTHER, SCORE_QNAME, SHOW_BYFUNCTION, WILD
-
Fields inherited from interface org.htmlunit.xpath.xml.dtm.DTMIterator
FILTER_ACCEPT, FILTER_SKIP
-
-
Constructor Summary
Constructors Constructor Description WalkingIterator(Compiler compiler, int opPos, int analysis, boolean shouldLoadWalkers)Create a WalkingIterator iterator, including creation of step walkers from the opcode list, and call back into the Compiler to create predicate expressions.WalkingIterator(PrefixResolver nscontext)Create a WalkingIterator object.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidcallVisitors(XPathVisitor visitor)This will traverse the hierarchy, calling the visitor for each member.java.lang.Objectclone()booleandeepEquals(Expression expr)Compare this object with another object and see if they are equal, include the sub heararchy.voiddetach()Detaches theDTMIteratorfrom the set which it iterated over, releasing any computational resources and placing the iterator in the INVALID state.intgetAnalysisBits()Get the analysis bits for this path component, as defined in the WalkerFactory.AxesWalkergetLastUsedWalker()Get the last used walker.intnextNode()Returns the next node in the set and advances the position of the iterator in the set.voidreset()Reset the iterator to the start.voidsetLastUsedWalker(AxesWalker walker)Set the last used walker.voidsetRoot(int context, java.lang.Object environment)Reset the root node of theDTMIterator, overriding the value specified when it was created.-
Methods inherited from class org.htmlunit.xpath.axes.LocPathIterator
asIterator, asNode, bool, cloneWithReset, execute, getAxis, getCurrentNode, getCurrentPos, getDTM, getDTMManager, getExpandEntityReferences, getIsTopLevel, getLastPos, getLength, getPrefixResolver, getRoot, getWhatToShow, getXPathContext, incrementCurrentPos, isDocOrdered, isFresh, item, previousNode, returnNextNode, runTo, setCurrentPos, setIsTopLevel, setShouldCacheNodes
-
Methods inherited from class org.htmlunit.xpath.axes.PredicatedNodeTest
acceptNode, callPredicateVisitors, canTraverseOutsideSubtree, countProximityPosition, executePredicates, getPredicate, getPredicateCount, getProximityPosition, getProximityPosition, getProximityPosition, initPredicateInfo, initProximityPosition, isReverseAxes, nodeToString, resetProximityPositions, setLocPathIterator, setPredicateCount
-
Methods inherited from class org.htmlunit.xpath.patterns.NodeTest
calcScore, execute, execute, getLocalName, getNamespace, getNodeTypeTest, getStaticScore, initNodeTest, initNodeTest, setLocalName, setNamespace, setStaticScore, setWhatToShow
-
Methods inherited from class org.htmlunit.xpath.Expression
assertion, error, execute, exprGetParent, exprSetParent, getColumnNumber, getExpressionOwner, getLineNumber, getPublicId, getSystemId, isSameClass, isStableNumber, num
-
-
-
-
Field Detail
-
m_lastUsedWalker
protected AxesWalker m_lastUsedWalker
The last used step walker in the walker list.
-
m_firstWalker
protected AxesWalker m_firstWalker
The head of the step walker list.
-
-
Constructor Detail
-
WalkingIterator
WalkingIterator(Compiler compiler, int opPos, int analysis, boolean shouldLoadWalkers) throws javax.xml.transform.TransformerException
Create a WalkingIterator iterator, including creation of step walkers from the opcode list, and call back into the Compiler to create predicate expressions.- Parameters:
compiler- The Compiler which is creating this expression.opPos- The position of this iterator in the opcode list from the compiler.shouldLoadWalkers- True if walkers should be loaded, or false if this is a derived iterator and it doesn't wish to load child walkers.- Throws:
javax.xml.transform.TransformerException- if any
-
WalkingIterator
public WalkingIterator(PrefixResolver nscontext)
Create a WalkingIterator object.- Parameters:
nscontext- The namespace context for this iterator, should be OK if null.
-
-
Method Detail
-
getAnalysisBits
public int getAnalysisBits()
Get the analysis bits for this path component, as defined in the WalkerFactory.- Specified by:
getAnalysisBitsin interfacePathComponent- Overrides:
getAnalysisBitsin classLocPathIterator- Returns:
- One of WalkerFactory#BIT_DESCENDANT, etc.
-
clone
public java.lang.Object clone() throws java.lang.CloneNotSupportedException- Specified by:
clonein interfaceDTMIterator- Overrides:
clonein classPredicatedNodeTest- Returns:
- A clone of this object.
- Throws:
java.lang.CloneNotSupportedException- if any
-
reset
public void reset()
Reset the iterator to the start. After resetting, the next node returned will be the root node -- or, if that's filtered out, the first node within the root's subtree which is _not_ skipped by the filters.- Specified by:
resetin interfaceDTMIterator- Overrides:
resetin classLocPathIterator
-
setRoot
public void setRoot(int context, java.lang.Object environment)Reset the root node of theDTMIterator, overriding the value specified when it was created. Note the root node is not the root node of the document tree, but the context node from where the iteration begins.- Specified by:
setRootin interfaceDTMIterator- Overrides:
setRootin classLocPathIterator- Parameters:
context- int Handle of the context node.environment- The environment object. The environment in which this iterator operates, which should provide:- a node (the context node... same value as "root" defined below)
- a pair of non-zero positive integers (the context position and the context size)
- a set of variable bindings
- a function library
- the set of namespace declarations in scope for the expression.
At this time the exact implementation of this environment is application dependent. Probably a proper interface will be created fairly soon.
-
nextNode
public int nextNode()
Returns the next node in the set and advances the position of the iterator in the set. After aDTMIteratorhas setRoot called, the first call tonextNode()returns that root or (if it is rejected by the filters) the first node within its subtree which is not filtered out.- Specified by:
nextNodein interfaceDTMIterator- Specified by:
nextNodein classLocPathIterator- Returns:
- The next node handle in the set being iterated over, or
DTM.NULLif there are no more members in that set.
-
setLastUsedWalker
public final void setLastUsedWalker(AxesWalker walker)
Set the last used walker.- Parameters:
walker- The last used walker, or null.
-
getLastUsedWalker
public final AxesWalker getLastUsedWalker()
Get the last used walker.- Returns:
- The last used walker, or null.
-
detach
public void detach()
Detaches theDTMIteratorfrom the set which it iterated over, releasing any computational resources and placing the iterator in the INVALID state. Afterdetachhas been invoked, calls tonextNodeorpreviousNodewill raise a runtime exception.- Specified by:
detachin interfaceDTMIterator- Overrides:
detachin classLocPathIterator
-
callVisitors
public void callVisitors(XPathVisitor visitor)
This will traverse the hierarchy, calling the visitor for each member. If the called visitor method returns false, the subtree should not be called.- Specified by:
callVisitorsin interfaceXPathVisitable- Overrides:
callVisitorsin classLocPathIterator- Parameters:
visitor- The visitor whose appropriate method will be called.
-
deepEquals
public boolean deepEquals(Expression expr)
Compare this object with another object and see if they are equal, include the sub heararchy.- Overrides:
deepEqualsin classPredicatedNodeTest- Parameters:
expr- Another expression object.- Returns:
- true if this objects class and the expr object's class are the same, and the data contained within both objects are considered equal.
-
-