net.rim.device.api.util
Class EmptyEnumeration

java.lang.Object
  |
  +--net.rim.device.api.util.EmptyEnumeration

All Implemented Interfaces:

Enumeration

public final class EmptyEnumeration

extends Object

implements Enumeration

Permits handling of empty enumerations.

This wrapper around the Enumeration interface handles returning of empty enumerations when no elements exist to be retrieved. This ensures that the invoker does not have to check for null but can rather rely on simply using the enumeration interface.

Constructor Summary

EmptyEnumeration()
Constructs a new EmptyEnumeration object.

Method Summary

boolean	hasMoreElements() Determines if this enumeration has more objects.
Object	nextElement() Retrieves the next element in this enumeration.

Methods inherited from class java.lang.Object

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

Constructor Detail

EmptyEnumeration

public EmptyEnumeration()

Constructs a new EmptyEnumeration object.

By default, this constructor does nothing.

Method Detail

hasMoreElements

public boolean hasMoreElements()

Determines if this enumeration has more objects.

Specified by:

hasMoreElements in interface Enumeration

Returns:

Returns false by default (this is an empty enumeration, so it always returns false).

nextElement

public Object nextElement()
                   throws NoSuchElementException

Retrieves the next element in this enumeration.

Specified by:

nextElement in interface Enumeration

Returns:

Nothing by default (this is an empty enumeration, so there's no next object to return).

Throws:

NoSuchElementException - Always by default, since this is an empty enumeration.