WebLogic Server 6.1 API Reference

weblogic.apache.xpath.axes
Class PrecedingWalker

java.lang.Object
  |
  +--weblogic.apache.xpath.Expression
        |
        +--weblogic.apache.xpath.patterns.NodeTest
              |
              +--weblogic.apache.xpath.axes.PredicatedNodeTest
                    |
                    +--weblogic.apache.xpath.axes.AxesWalker
                          |
                          +--weblogic.apache.xpath.axes.ReverseAxesWalker
                                |
                                +--weblogic.apache.xpath.axes.PrecedingWalker

public class PrecedingWalker

extends ReverseAxesWalker

Walker for the 'preceding' axes.

The walk is done from the root node, in depth-first order, testing to see if a given vertice is an ancestor of the step context, in which case that vertice, and all following vertices, are skipped.

This class is based on an implementation from the Apache XML Project. In future releases the XML parser, XSLT processor, and associated classes will likely be updated to be based on a later version of the Apache implementations. Since Apache does not guarantee backwards compatibility between versions of their software, we cannot guarantee backwards compatibility of any of the classes contained in the weblogic.apache package or sub-packages.

See Also:

XPath axes descriptions, Serialized Form

Fields inherited from class weblogic.apache.xpath.axes.AxesWalker

FEATURE_NODETESTFILTER, m_nextLevelAmount, m_nextWalker

Fields inherited from class weblogic.apache.xpath.axes.PredicatedNodeTest

m_lpi, m_proximityPositions

Fields inherited from class weblogic.apache.xpath.patterns.NodeTest

m_whatToShow, SCORE_NODETEST, SCORE_NONE, SCORE_NSWILD, SCORE_OTHER, SCORE_QNAME, SHOW_BYFUNCTION, SHOW_NAMESPACE, SUPPORTS_PRE_STRIPPING, WILD

Fields inherited from class weblogic.apache.xpath.Expression

m_slocator

Constructor Summary

PrecedingWalker(LocPathIterator locPathIterator)
Construct a PrecedingWalker using a LocPathIterator.

Method Summary

org.w3c.dom.Node	firstChild() Moves the TreeWalker to the first visible child of the current node, and returns the new node.
protected int	getLevelMax() Tell what's the maximum level this axes can descend to.
org.w3c.dom.Node	nextSibling() Moves the TreeWalker to the next sibling of the current node, and returns the new node.
org.w3c.dom.Node	parentNode() Moves to and returns the closest visible ancestor node of the current node.
void	resetProximityPositions() Reset the proximity positions counts.
void	setRoot(org.w3c.dom.Node root) Set the root node of the TreeWalker.

Methods inherited from class weblogic.apache.xpath.axes.ReverseAxesWalker

countProximityPosition, getLastPos, getProximityPosition, isReverseAxes

Methods inherited from class weblogic.apache.xpath.axes.AxesWalker

canTraverseOutsideSubtree, checkOKToTraverse, clone, getArgLen, getCurrentNode, getExpandEntityReferences, getFilter, getNextLevelAmount, getNextNode, getNextWalker, getPrevWalker, getRoot, getStepType, init, isFastWalker, lastChild, nextNode, previousNode, previousSibling, setCurrentIfNotNull, setCurrentNode, setNextWalker, setPrevWalker, toString

Methods inherited from class weblogic.apache.xpath.axes.PredicatedNodeTest

acceptNode, getLocPathIterator, getPredicateCount, getPredicateIndex, getProximityPosition, getProximityPosition, initPredicateInfo, initProximityPosition, nodeToString, setLocPathIterator, setPredicateCount

Methods inherited from class weblogic.apache.xpath.patterns.NodeTest

calcScore, debugWhatToShow, execute, execute, getDefaultScore, getLocalName, getNamespace, getWhatToShow, initNodeTest, initNodeTest

Methods inherited from class weblogic.apache.xpath.Expression

assert, error, setSourceLocator, warn

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PrecedingWalker

public PrecedingWalker(LocPathIterator locPathIterator)

Construct a PrecedingWalker using a LocPathIterator.

Parameters:

locPathIterator - The location path iterator that 'owns' this walker.

Method Detail

setRoot

public void setRoot(org.w3c.dom.Node root)

Set the root node of the TreeWalker. If we follow an attribute:: or namespace:: axis, we operate relative to the parent node.

Parameters:

root - The context node of this step.

Overrides:

setRoot in class ReverseAxesWalker

resetProximityPositions

public void resetProximityPositions()

Reset the proximity positions counts.

Overrides:

resetProximityPositions in class PredicatedNodeTest

parentNode

public org.w3c.dom.Node parentNode()

Moves to and returns the closest visible ancestor node of the current node. If the search for parentNode attempts to step upward from the TreeWalker's root node, or if it fails to find a visible ancestor node, this method retains the current position and returns null.

Returns:

The new parent node, or null if the current node has no parent in the TreeWalker's logical view.

Overrides:

parentNode in class AxesWalker

firstChild

public org.w3c.dom.Node firstChild()

Moves the TreeWalker to the first visible child of the current node, and returns the new node. If the current node has no visible children, returns null , and retains the current node.

Returns:

The new node, or null if the current node has no visible children in the TreeWalker's logical view.

Overrides:

firstChild in class AxesWalker

nextSibling

public org.w3c.dom.Node nextSibling()

Moves the TreeWalker to the next sibling of the current node, and returns the new node. If the current node has no visible next sibling, returns null , and retains the current node.

Returns:

The new node, or null if the current node has no next sibling in the TreeWalker's logical view.

Overrides:

nextSibling in class AxesWalker

getLevelMax

protected int getLevelMax()

Tell what's the maximum level this axes can descend to.

Returns:

Short.MAX_VALUE.

Overrides:

getLevelMax in class AxesWalker