org.apache.xml.dtm.ref
Class EmptyIterator

java.lang.Object
  org.apache.xml.dtm.ref.EmptyIterator

All Implemented Interfaces:

java.lang.Cloneable, DTMAxisIterator

public final class EmptyIterator
extends java.lang.Object
implements DTMAxisIterator

DTM Empty Axis Iterator. The class is immutable

Field Summary

private static EmptyIterator

INSTANCE

Fields inherited from interface org.apache.xml.dtm.DTMAxisIterator

END

Constructor Summary

private

EmptyIterator()

Method Summary

DTMAxisIterator	cloneIterator()
static DTMAxisIterator	getInstance()
int	getLast()
int	getNodeByPosition(int position) Return the node at the given position.
int	getPosition()
int	getStartNode() Get start to END should 'close' the iterator, i.e.
void	gotoMark() Restores the current node remembered by setMark().
boolean	isReverse()
int	next() Get the next node in the iteration.
DTMAxisIterator	reset() Resets the iterator to the last start node.
void	setMark() Remembers the current node for the next call to gotoMark().
void	setRestartable(boolean isRestartable) Set if restartable.
DTMAxisIterator	setStartNode(int node) Set start to END should 'close' the iterator, i.e.

Methods inherited from class java.lang.Object

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

Field Detail

INSTANCE

private static final EmptyIterator INSTANCE

Constructor Detail

EmptyIterator

private EmptyIterator()

Method Detail

getInstance

public static DTMAxisIterator getInstance()

next

public final int next()

Description copied from interface: DTMAxisIterator

Get the next node in the iteration.

Specified by:

next in interface DTMAxisIterator

Returns:

The next node handle in the iteration, or END.

reset

public final DTMAxisIterator reset()

Description copied from interface: DTMAxisIterator

Resets the iterator to the last start node.

Specified by:

reset in interface DTMAxisIterator

Returns:

A DTMAxisIterator, which may or may not be the same as this iterator.

getLast

public final int getLast()

Specified by:

getLast in interface DTMAxisIterator

Returns:

the number of nodes in this iterator. This may be an expensive operation when called the first time.

getPosition

public final int getPosition()

Specified by:

getPosition in interface DTMAxisIterator

Returns:

The position of the current node in the set, as defined by XPath.

setMark

public final void setMark()

Description copied from interface: DTMAxisIterator

Remembers the current node for the next call to gotoMark().

Specified by:

setMark in interface DTMAxisIterator

gotoMark

public final void gotoMark()

Description copied from interface: DTMAxisIterator

Restores the current node remembered by setMark().

Specified by:

gotoMark in interface DTMAxisIterator

setStartNode

public final DTMAxisIterator setStartNode(int node)

Description copied from interface: DTMAxisIterator

Set start to END should 'close' the iterator, i.e. subsequent call to next() should return END.

Specified by:

setStartNode in interface DTMAxisIterator

Parameters:

node - Sets the root of the iteration.

Returns:

A DTMAxisIterator set to the start of the iteration.

getStartNode

public final int getStartNode()

Description copied from interface: DTMAxisIterator

Get start to END should 'close' the iterator, i.e. subsequent call to next() should return END.

Specified by:

getStartNode in interface DTMAxisIterator

Returns:

The root node of the iteration.

isReverse

public final boolean isReverse()

Specified by:

isReverse in interface DTMAxisIterator

Returns:

true if this iterator has a reversed axis, else false.

cloneIterator

public final DTMAxisIterator cloneIterator()

Specified by:

cloneIterator in interface DTMAxisIterator

Returns:

a deep copy of this iterator. The clone should not be reset from its current position.

setRestartable

public final void setRestartable(boolean isRestartable)

Description copied from interface: DTMAxisIterator

Set if restartable.

Specified by:

setRestartable in interface DTMAxisIterator

getNodeByPosition

public final int getNodeByPosition(int position)

Description copied from interface: DTMAxisIterator

Return the node at the given position.

Specified by:

getNodeByPosition in interface DTMAxisIterator

Parameters:

position - The position

Returns:

The node at the given position.