Class EmptyEnumeration

All Implemented Interfaces:

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
          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


public EmptyEnumeration()
Constructs a new EmptyEnumeration object.

By default, this constructor does nothing.

Method Detail


public boolean hasMoreElements()
Determines if this enumeration has more objects.

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


public Object nextElement()
                   throws NoSuchElementException
Retrieves the next element in this enumeration.

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

Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.