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.

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.

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