org.glassfish.grizzly.http.server.util
Class Enumerator<E>

java.lang.Object
  org.glassfish.grizzly.http.server.util.Enumerator<E>

All Implemented Interfaces:

java.util.Enumeration<E>

public final class Enumerator<E>
extends java.lang.Object
implements java.util.Enumeration<E>

HttpHandler class that wraps an Enumeration around a Java2 collection classes object Iterator so that existing APIs returning Enumerations can easily run on top of the new collections. Constructors are provided to easily create such wrappers.

Version:

$Revision: 1.3 $ $Date: 2007/06/18 14:17:08 $

Author:

Craig R. McClanahan

Constructor Summary

Enumerator(java.util.Collection<E> collection)
Return an Enumeration over the values of the specified Collection.

Enumerator(java.util.Collection<E> collection, boolean clone)
Return an Enumeration over the values of the specified Collection.

Enumerator(java.util.Iterator<E> iterator)
Return an Enumeration over the values returned by the specified Iterator.

Enumerator(java.util.Iterator<E> iterator, boolean clone)
Return an Enumeration over the values returned by the specified Iterator.

Enumerator(java.util.Map<?,E> map)
Return an Enumeration over the values of the specified Map.

Enumerator(java.util.Map<?,E> map, boolean clone)
Return an Enumeration over the values of the specified Map.

Method Summary

boolean	hasMoreElements() Tests if this enumeration contains more elements.
E	nextElement() Returns the next element of this enumeration if this enumeration has at least one more element to provide.

Methods inherited from class java.lang.Object

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

Constructor Detail

Enumerator

public Enumerator(java.util.Collection<E> collection)

Return an Enumeration over the values of the specified Collection.

Parameters:

collection - Collection whose values should be enumerated

Enumerator

public Enumerator(java.util.Collection<E> collection,
                  boolean clone)

Return an Enumeration over the values of the specified Collection.

Parameters:

collection - Collection whose values should be enumerated

clone - true to clone iterator

Enumerator

public Enumerator(java.util.Iterator<E> iterator)

Return an Enumeration over the values returned by the specified Iterator.

Parameters:

iterator - Iterator to be wrapped

Enumerator

public Enumerator(java.util.Iterator<E> iterator,
                  boolean clone)

Return an Enumeration over the values returned by the specified Iterator.

Parameters:

iterator - Iterator to be wrapped

clone - true to clone iterator

Enumerator

public Enumerator(java.util.Map<?,E> map)

Return an Enumeration over the values of the specified Map.

Parameters:

map - Map whose values should be enumerated

Enumerator

public Enumerator(java.util.Map<?,E> map,
                  boolean clone)

Return an Enumeration over the values of the specified Map.

Parameters:

map - Map whose values should be enumerated

clone - true to clone iterator

Method Detail

hasMoreElements

public boolean hasMoreElements()

Tests if this enumeration contains more elements.

Specified by:

hasMoreElements in interface java.util.Enumeration<E>

Returns:

true if and only if this enumeration object contains at least one more element to provide, false otherwise

nextElement

public E nextElement()
              throws java.util.NoSuchElementException

Returns the next element of this enumeration if this enumeration has at least one more element to provide.

Specified by:

nextElement in interface java.util.Enumeration<E>

Returns:

the next element of this enumeration

Throws:

java.util.NoSuchElementException - if no more elements exist