|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Iterators
are used to step through a set of nodes.
It is modeled largely after the DOM NodeIterator.
A DTMIterator is a somewhat unusual type of iterator, in that it can serve both single node iteration and random access.
The DTMIterator's traversal semantics, i.e. how it walks the tree, are specified when it is created, possibly and probably by an XPath UnionExpr.
A DTMIterator is meant to be created once as a master static object, and then cloned many times for runtime use. Or the master object itself may be used for simpler use cases.
State: In progress!!
Field Summary | |
static short |
FILTER_ACCEPT
Accept the node. |
static short |
FILTER_REJECT
Reject the node. |
static short |
FILTER_SKIP
Skip this single node. |
Method Summary | |
java.lang.Object |
clone()
Get a clone of this iterator, but don't reset the iteration in the process, so that it may be used from the current position. |
DTMIterator |
cloneWithReset()
Get a cloned Iterator that is reset to the start of the iteration. |
void |
detach()
Detaches the DTMIterator from the set which it iterated
over, releasing any computational resources and placing the iterator
in the INVALID state. |
int |
getCurrentNode()
Get the current node in the iterator.. |
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. |
int |
getLength()
The number of nodes in the list. |
int |
getRoot()
The root node of the DTMIterator , as specified when it
was created. |
int |
getWhatToShow()
This attribute determines which node types are presented via the iterator. |
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. |
int |
item(int index)
Returns the node handle of an item in the collection. |
int |
nextNode()
Returns the next node in the set and advances the position of the iterator in the set. |
int |
previousNode()
Returns the previous node in the set and moves the position of the DTMIterator backwards in the set. |
void |
reset()
Reset the iterator to the start. |
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 |
setEnvironment(java.lang.Object environment)
Set the environment in which this iterator operates, which should provide: a node (the context node... |
void |
setRoot(int nodeHandle)
The root node of the DTMIterator , as specified when it
was created. |
void |
setShouldCacheNodes(boolean b)
If setShouldCacheNodes(true) is called, then nodes will be cached, enabling random access, and giving the ability to do sorts and the like. |
Field Detail |
public static final short FILTER_ACCEPT
public static final short FILTER_REJECT
public static final short FILTER_SKIP
Method Detail |
public void setEnvironment(java.lang.Object environment)
At this time the exact implementation of this environment is application dependent. Probably a proper interface will be created fairly soon.
environment
- The environment object.public int getRoot()
DTMIterator
, as 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 itteration
begins.public void setRoot(int nodeHandle)
DTMIterator
, as 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 itteration
begins.nodeHandle
- int Handle of the context node.public void reset()
public int getWhatToShow()
whatToShow
will be skipped, but their children may still
be considered.public boolean getExpandEntityReferences()
whatToShow
and the filter.
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.public int nextNode()
DTMIterator
has setRoot called,
the first call to nextNode()
returns the first node in
the set.public int previousNode()
DTMIterator
backwards in the set.null
if there are no more members in that set.public void detach()
DTMIterator
from the set which it iterated
over, releasing any computational resources and placing the iterator
in the INVALID state. After detach
has been invoked,
calls to nextNode
or previousNode
will
raise a runtime exception.public int getCurrentNode()
public boolean isFresh()
public void setShouldCacheNodes(boolean b)
b
- true if the nodes should be cached.public int getCurrentPos()
public void runTo(int index)
index
- The index to run to, or -1 if the iterator should be run
to the end.public void setCurrentPos(int i)
i
- Must be a valid index.public int item(int index)
node handle
of an item in the collection. If
index
is greater than or equal to the number of nodes in
the list, this returns null
.index
- of the item.index
th position in the
DTMIterator
, or -1
if that is not a valid
index.public int getLength()
length-1
inclusive.public DTMIterator cloneWithReset() throws java.lang.CloneNotSupportedException
public java.lang.Object clone() throws java.lang.CloneNotSupportedException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |