OpenJDK 27 · com.sun.org.apache.xml.internal.dtm.ref.DTMAxisIterNodeList

DTMAxisNodeList gives us an implementation of the DOM's NodeList interface wrapped around a DTM Iterator. The author considers this something of an abominations, since NodeList was not intended to be a general purpose "list of nodes" API and is generally considered by the DOM WG to have be a mistake... but I'm told that some of the XPath/XSLT folks say they must have this solution. Please note that this is not necessarily equivlaent to a DOM NodeList operating over the same document. In particular:

If there are several Text nodes in logical succession (ie, across CDATASection and EntityReference boundaries), we will return only the first; the caller is responsible for stepping through them. (%REVIEW% Provide a convenience routine here to assist, pending proposed DOM Level 3 getAdjacentText() operation?)
Since the whole XPath/XSLT architecture assumes that the source document is not altered while we're working with it, we do not promise to implement the DOM NodeList's "live view" response to document mutation.

State: In progress!!

Modifier and Type	Field and Description
private IntVector	m_cachedNodes
private DTM	m_dtm
private DTMAxisIterator	m_iter
private int	m_last

Constructor Summary

Access	Constructor and Description
private	DTMAxisIterNodeList()
public	DTMAxisIterNodeList(DTM dtm, DTMAxisIterator dtmAxisIterator) Public constructor: Wrap a DTMNodeList around an existing and preconfigured DTMAxisIterator

Method Summary

Modifier and Type	Method and Description
public DTMAxisIterator	getDTMAxisIterator() Access the wrapped DTMIterator.
public int	getLength() Overrides com.sun.org.apache.xml.internal.dtm.ref.DTMNodeListBase.getLength. Implements org.w3c.dom.NodeList.getLength. The number of nodes in the list.
public Node	Returns: The node at the `index`th position in the `NodeList`, or `null` if that is not a valid index. item(int Index into the collection. index) Overrides com.sun.org.apache.xml.internal.dtm.ref.DTMNodeListBase.item. Implements org.w3c.dom.NodeList.item. Returns the `index`th item in the collection.

Field Detail

m_cachedNodes	back to summary
private IntVector m_cachedNodes

m_dtm	back to summary
private DTM m_dtm

m_iter	back to summary
private DTMAxisIterator m_iter

m_last	back to summary
private int m_last

Constructor Detail

DTMAxisIterNodeList	back to summary
private DTMAxisIterNodeList()

DTMAxisIterNodeList	back to summary
public DTMAxisIterNodeList(DTM dtm, DTMAxisIterator dtmAxisIterator) Public constructor: Wrap a DTMNodeList around an existing and preconfigured DTMAxisIterator

Method Detail

getDTMAxisIterator	back to summary
public DTMAxisIterator getDTMAxisIterator() Access the wrapped DTMIterator. I'm not sure whether anyone will need this or not, but let's write it and think about it.

getLength back to summary

getLength	back to summary
public int getLength() Overrides com.sun.org.apache.xml.internal.dtm.ref.DTMNodeListBase.getLength. Implements org.w3c.dom.NodeList.getLength. The number of nodes in the list. The range of valid child node indices is 0 to `length-1` inclusive.

public int getLength()

Overrides com.sun.org.apache.xml.internal.dtm.ref.DTMNodeListBase.getLength.

Implements org.w3c.dom.NodeList.getLength.

The number of nodes in the list. The range of valid child node indices is 0 to length-1 inclusive.

item back to summary

item	back to summary
public Node item(int index) Overrides com.sun.org.apache.xml.internal.dtm.ref.DTMNodeListBase.item. Implements org.w3c.dom.NodeList.item. Returns the `index`th item in the collection. If `index` is greater than or equal to the number of nodes in the list, this returns `null`. Parameters index:int Index into the collection. Returns:Node The node at the `index`th position in the `NodeList`, or `null` if that is not a valid index.

public Node item(int index)

Overrides com.sun.org.apache.xml.internal.dtm.ref.DTMNodeListBase.item.

Implements org.w3c.dom.NodeList.item.

Returns the indexth item in the collection. If index is greater than or equal to the number of nodes in the list, this returns null.

Parameters

index:int: Index into the collection.

Returns:Node

The node at the indexth position in the NodeList, or null if that is not a valid index.

public Class DTMAxisIterNodeList

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail