WebLogic Server 6.1 API Reference

weblogic.apache.xpath.axes
Class UnionPathIterator

java.lang.Object
  |
  +--weblogic.apache.xpath.Expression
        |
        +--weblogic.apache.xpath.axes.UnionPathIterator

public class UnionPathIterator

extends Expression

implements java.lang.Cloneable, org.w3c.dom.traversal.NodeIterator, ContextNodeList

This class extends NodeSet, which implements NodeIterator, and fetches nodes one at a time in document order based on a XPath UnionExpr. As each node is iterated via nextNode(), the node is also stored in the NodeVector, so that previousNode() can easily be done.

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:

Serialized Form

Field Summary

protected org.w3c.dom.Node	m_context The node context for the expression.
protected org.w3c.dom.Node	m_currentContextNode The node context from where the Location Path is being executed from (i.e.
protected XPathContext	m_execContext The execution context for the expression.
protected boolean	m_foundLast Tells if we've found the last node yet.
protected LocPathIterator[]	m_iterators The location path iterators, one for each location path contained in the union expression.
protected int	m_next The index of the next node to be fetched.

Fields inherited from class weblogic.apache.xpath.Expression

m_slocator

Constructor Summary

UnionPathIterator()
Constructor to create an instance which you can add location paths to.

UnionPathIterator(Compiler compiler, int opPos)
Create a UnionPathIterator object, including creation of location path iterators from the opcode list, and call back into the Compiler to create predicate expressions.

Method Summary

void	addIterator(LocPathIterator iter) Add an iterator to the union list.
java.lang.Object	clone() Get a cloned LocPathIterator that holds the same position as this iterator.
org.w3c.dom.traversal.NodeIterator	cloneWithReset() Get a cloned Iterator that is reset to the beginning of the query.
protected LocPathIterator	createLocPathIterator(Compiler compiler, int opPos) Create a new location path iterator.
void	detach() Detaches the iterator from the set which it iterated over, releasing any computational resources and placing the iterator in the INVALID state.
XObject	execute(XPathContext xctxt) Execute this iterator, meaning create a clone that can store state, and initialize it for fast execution from the current runtime state.
org.w3c.dom.Node	getCurrentContextNode() The node context from where the expression is being executed from (i.e.
org.w3c.dom.Node	getCurrentNode() Return the last fetched node.
int	getCurrentPos() Get the current position, which is one less than the next nextNode() call will retrieve.
boolean	getExpandEntityReferences() The value of this flag determines whether the children of entity reference nodes are visible to the iterator.
org.w3c.dom.traversal.NodeFilter	getFilter() The filter used to screen nodes.
int	getLast() Get the index of the last node in the itteration.
org.w3c.dom.Node	getRoot() The root node of the Iterator, as specified when it was created.
int	getWhatToShow() This attribute determines which node types are presented via the iterator.
void	initContext(XPathContext execContext) Initialize the context values for this expression after it is cloned.
boolean	isFresh() Tells if this NodeSet is "fresh", in other words, if the first nextNode() that is called will return the first node in the set.
protected void	loadLocationPaths(Compiler compiler, int opPos, int count) Initialize the location path iterators.
org.w3c.dom.Node	nextNode() Returns the next node in the set and advances the position of the iterator in the set.
org.w3c.dom.Node	previousNode() Returns the previous node in the set and moves the position of the iterator backwards in the set.
void	reset() Reset the iterator.
void	runTo(int index) If an index is requested, NodeSet will call this method to run the iterator to the index.
void	setCurrentPos(int i) Set the current position in the node set.
void	setLast(int last) Set the index of the last node in the itteration.
void	setShouldCacheNodes(boolean b) If setShouldCacheNodes(true) is called, then nodes will be cached.
int	size() Get the length of the list.

Methods inherited from class weblogic.apache.xpath.Expression

assert, canTraverseOutsideSubtree, error, setSourceLocator, warn

Methods inherited from class java.lang.Object

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

Field Detail

m_next

protected transient int m_next

The index of the next node to be fetched. Useful if this is a cached iterator, and is being used as random access NodeList.

m_foundLast

protected transient boolean m_foundLast

Tells if we've found the last node yet.

m_execContext

protected transient XPathContext m_execContext

The execution context for the expression.

m_context

protected transient org.w3c.dom.Node m_context

The node context for the expression.

m_currentContextNode

protected transient org.w3c.dom.Node m_currentContextNode

The node context from where the Location Path is being executed from (i.e. for current() support).

m_iterators

protected LocPathIterator[] m_iterators

The location path iterators, one for each location path contained in the union expression.

Constructor Detail

UnionPathIterator

public UnionPathIterator()

Constructor to create an instance which you can add location paths to.

UnionPathIterator

public UnionPathIterator(Compiler compiler,
                         int opPos)
                  throws javax.xml.transform.TransformerException

Create a UnionPathIterator object, including creation of location path iterators 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.

Throws:

javax.xml.transform.TransformerException -

Method Detail

initContext

public void initContext(XPathContext execContext)

Initialize the context values for this expression after it is cloned.

Parameters:

execContext - The XPath runtime context for this transformation.

detach

public void detach()

Detaches the iterator from the set which it iterated over, releasing any computational resources and placing the iterator in the INVALID state. Afterdetach has been invoked, calls to nextNode orpreviousNode will raise the exception INVALID_STATE_ERR.

Specified by:

detach in interface org.w3c.dom.traversal.NodeIterator

execute

public XObject execute(XPathContext xctxt)
                throws javax.xml.transform.TransformerException

Execute this iterator, meaning create a clone that can store state, and initialize it for fast execution from the current runtime state. When this is called, no actual query from the current context node is performed.

Parameters:

xctxt - The XPath execution context.

Returns:

An XNodeSet reference that holds this iterator.

Throws:

javax.xml.transform.TransformerException -

Overrides:

execute in class Expression

setShouldCacheNodes

public void setShouldCacheNodes(boolean b)

If setShouldCacheNodes(true) is called, then nodes will be cached. They are not cached by default.

Specified by:

setShouldCacheNodes in interface ContextNodeList

Parameters:

b - True if this iterator should cache nodes.

setCurrentPos

public void setCurrentPos(int i)

Set the current position in the node set.

Specified by:

setCurrentPos in interface ContextNodeList

Parameters:

i - Must be a valid index.

size

public int size()

Get the length of the list.

Specified by:

size in interface ContextNodeList

Returns:

The length of this list, or zero is this is not a cached list.

isFresh

public boolean isFresh()

Tells if this NodeSet is "fresh", in other words, if the first nextNode() that is called will return the first node in the set.

Specified by:

isFresh in interface ContextNodeList

Returns:

True if the iteration has not yet begun.

previousNode

public org.w3c.dom.Node previousNode()
                              throws org.w3c.dom.DOMException

Returns the previous node in the set and moves the position of the iterator backwards in the set.

Specified by:

previousNode in interface org.w3c.dom.traversal.NodeIterator

Returns:

The previous Node in the set being iterated over, ornull if there are no more members in that set.

Throws:

org.w3c.dom.DOMException - INVALID_STATE_ERR: Raised if this method is called after the detach method was invoked.

getWhatToShow

public int getWhatToShow()

This attribute determines which node types are presented via the iterator. The available set of constants is defined in the NodeFilter interface.

Specified by:

getWhatToShow in interface org.w3c.dom.traversal.NodeIterator

Returns:

A bit set that tells what node types to show (NodeFilter.SHOW_ALL at the iterator level).

getFilter

public org.w3c.dom.traversal.NodeFilter getFilter()

The filter used to screen nodes.

Specified by:

getFilter in interface org.w3c.dom.traversal.NodeIterator

Returns:

null.

getRoot

public org.w3c.dom.Node getRoot()

The root node of the Iterator, as specified when it was created.

Specified by:

getRoot in interface org.w3c.dom.traversal.NodeIterator

Returns:

The context node of this iterator.

getExpandEntityReferences

public boolean getExpandEntityReferences()

The value of this flag determines whether the children of entity reference nodes are visible to the iterator. If false, they will be skipped over.
To produce a view of the document that has entity references expanded and does not expose the entity reference node itself, use the whatToShow flags to hide the entity reference node and set expandEntityReferences to true when creating the iterator. To produce a view of the document that has entity reference nodes but no entity expansion, use the whatToShow flags to show the entity reference node and set expandEntityReferences to false.

Specified by:

getExpandEntityReferences in interface org.w3c.dom.traversal.NodeIterator

Returns:

true.

addIterator

public void addIterator(LocPathIterator iter)

Add an iterator to the union list.

Parameters:

iter - non-null reference to a location path iterator.

cloneWithReset

public org.w3c.dom.traversal.NodeIterator cloneWithReset()
                                                  throws java.lang.CloneNotSupportedException

Get a cloned Iterator that is reset to the beginning of the query.

Specified by:

cloneWithReset in interface ContextNodeList

Returns:

A cloned NodeIterator set of the start of the query.

Throws:

java.lang.CloneNotSupportedException -

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Get a cloned LocPathIterator that holds the same position as this iterator.

Specified by:

clone in interface ContextNodeList

Returns:

A clone of this iterator that holds the same node position.

Throws:

java.lang.CloneNotSupportedException -

Overrides:

clone in class java.lang.Object

reset

public void reset()

Reset the iterator.

Specified by:

reset in interface ContextNodeList

loadLocationPaths

protected void loadLocationPaths(Compiler compiler,
                                 int opPos,
                                 int count)
                          throws javax.xml.transform.TransformerException

Initialize the location path iterators. Recursive.

Parameters:

compiler - The Compiler which is creating this expression.

opPos - The position of this iterator in the opcode list from the compiler.

count - The insert position of the iterator.

Throws:

javax.xml.transform.TransformerException -

createLocPathIterator

protected LocPathIterator createLocPathIterator(Compiler compiler,
                                                int opPos)
                                         throws javax.xml.transform.TransformerException

Create a new location path iterator.

Parameters:

compiler - The Compiler which is creating this expression.

opPos - The position of this iterator in the

Returns:

New location path iterator.

Throws:

javax.xml.transform.TransformerException -

nextNode

public org.w3c.dom.Node nextNode()
                          throws org.w3c.dom.DOMException

Returns the next node in the set and advances the position of the iterator in the set. After a NodeIterator is created, the first call to nextNode() returns the first node in the set.

Specified by:

nextNode in interface org.w3c.dom.traversal.NodeIterator

Returns:

The next Node in the set being iterated over, or null if there are no more members in that set.

Throws:

org.w3c.dom.DOMException - INVALID_STATE_ERR: Raised if this method is called after the detach method was invoked.

runTo

public void runTo(int index)

If an index is requested, NodeSet will call this method to run the iterator to the index. By default this sets m_next to the index. If the index argument is -1, this signals that the iterator should be run to the end.

Specified by:

runTo in interface ContextNodeList

Parameters:

index - The index to run to, or -1 if the iterator should run to the end.

getCurrentPos

public int getCurrentPos()

Get the current position, which is one less than the next nextNode() call will retrieve. i.e. if you call getCurrentPos() and the return is 0, the next fetch will take place at index 1.

Specified by:

getCurrentPos in interface ContextNodeList

Returns:

A value greater than or equal to zero that indicates the next node position to fetch.

getCurrentNode

public org.w3c.dom.Node getCurrentNode()

Return the last fetched node.

Specified by:

getCurrentNode in interface ContextNodeList

Returns:

The last fetched node, or null if the last fetch was null.

getCurrentContextNode

public org.w3c.dom.Node getCurrentContextNode()

The node context from where the expression is being executed from (i.e. for current() support).

Returns:

The top-level node context of the entire expression.

getLast

public int getLast()

Get the index of the last node in the itteration.

Specified by:

getLast in interface ContextNodeList

setLast

public void setLast(int last)

Set the index of the last node in the itteration.

Specified by:

setLast in interface ContextNodeList