org.apache.wicket.util.iterator

Class AbstractHierarchyIterator<N,I extends N>

java.lang.Object

org.apache.wicket.util.iterator.AbstractHierarchyIterator<N,I>

Type Parameters:

I - The type relevant for the iterator. What you expect to get back from next(), e.g. Form.

N - The base type of all nodes, e.g. Component

All Implemented Interfaces:

Iterable<I>, Iterator<I>

Direct Known Subclasses:

AbstractHierarchyIteratorWithFilter

Deprecated.

Hierarchy iterators are deprecated because they have problems with pages with deep component tree. Use IVisitor instead.

@Deprecated
public abstract class AbstractHierarchyIterator<N,I extends N>
extends Object
implements Iterator<I>, Iterable<I>

This is a basic iterator for hierarchical structures such as Component hierarchies or HTML markup. It supports child first and parent first traversal and intercepts while moving down or up the hierarchy.

It assumes the container class implements Iterable. The leaf nodes don't need to.

Consecutive calls to hasNext() without next() in between, don't move the cursor, but return the same value until next() is called.

Every call to next(), with or without hasNext(), will move the cursor to the next element.

Author:

Juergen Donnerstag

See Also:

MarkupContainer.visitChildren(org.apache.wicket.util.visit.IVisitor), MarkupContainer.visitChildren(Class, org.apache.wicket.util.visit.IVisitor)

Constructor Summary

Constructors

Constructor and Description
AbstractHierarchyIterator(N root) Deprecated. Construct.

Method Summary

Methods

Modifier and Type	Method and Description
void	dontGoDeeper() Deprecated. Assuming we are currently at a container, than ignore all its children and grand-children and continue with the next sibling.
protected abstract boolean	hasChildren(N node) Deprecated.
boolean	hasNext() Deprecated.
Iterator<I>	iterator() Deprecated.
protected abstract Iterator<N>	newIterator(N node) Deprecated. If node is a container than return an iterator for its children.
I	next() Deprecated. Traverse the hierarchy and get the next element
protected boolean	onFilter(N node) Deprecated. Gets called for each element within the hierarchy (nodes and leafs)
protected boolean	onTraversalFilter(N node) Deprecated. Gets called for each element where hasChildren(Object) return true.
void	remove() Deprecated.
void	setChildFirst(boolean childFirst) Deprecated.
void	skipRemainingSiblings() Deprecated. Skip all remaining siblings and return to the parent node.
String	toString() Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractHierarchyIterator

public AbstractHierarchyIterator(N root)

Deprecated.

Construct.

Parameters:

root -

Method Detail

setChildFirst

public final void setChildFirst(boolean childFirst)

Deprecated.

Parameters:

childFirst - If true, than children are visited before their parent is.

hasChildren

protected abstract boolean hasChildren(N node)

Deprecated.

Parameters:

node -

Returns:

True, if node is a container and has at least one child.

newIterator

protected abstract Iterator<N> newIterator(N node)

Deprecated.

If node is a container than return an iterator for its children.

Gets only called if hasChildren(Object) return true.

Parameters:

node -

Returns:

container iterator

hasNext

public boolean hasNext()

Deprecated.

Specified by:

hasNext in interface Iterator<I extends N>

onFilter

protected boolean onFilter(N node)

Deprecated.

Gets called for each element within the hierarchy (nodes and leafs)

Parameters:

node -

Returns:

if false, than skip (filter) the element. It'll not stop the iterator from traversing into children though.

onTraversalFilter

protected boolean onTraversalFilter(N node)

Deprecated.

Gets called for each element where hasChildren(Object) return true.

Parameters:

node -

Returns:

if false, than do not traverse into the children and grand-children.

next

public I next()

Deprecated.

Traverse the hierarchy and get the next element

Specified by:

next in interface Iterator<I extends N>

remove

public void remove()

Deprecated.

Specified by:

remove in interface Iterator<I extends N>

skipRemainingSiblings

public void skipRemainingSiblings()

Deprecated.

Skip all remaining siblings and return to the parent node.

Can as well be called within IteratorFilter.onFilter(Object).

dontGoDeeper

public void dontGoDeeper()

Deprecated.

Assuming we are currently at a container, than ignore all its children and grand-children and continue with the next sibling.

Can as well be called within IteratorFilter.onFilter(Object).

iterator

public final Iterator<I> iterator()

Deprecated.

Specified by:

iterator in interface Iterable<I extends N>

toString

public String toString()

Deprecated.

Overrides:

toString in class Object