net.rim.device.api.util
Class EmptyEnumeration

java.lang.Object
  extended by 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.





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.