EmptyIterator (de.enflexit.jade 4.6.0 API)

java.lang.Object
- jade.util.leap.EmptyIterator

All Implemented Interfaces:

Iterator, Iterator
```
public class EmptyIterator
extends Object
implements Iterator
```
Singleton Iterator for an empty collection. The usage of the singleton-pattern for this simple object allows just to save some memory.

Version:

$Date$ $Revision$

Author:

Fabio Bellifemine, TILAB

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`static Iterator`	`getInstance()`	Returns the singleton EmptyIterator object.
`boolean`	`hasNext()`	Checks whether the iterator can scan further.
`Object`	`next()`	Retrieves the next element in the collection scanned by this iterator.
`void`	`remove()`	Remove the element pointed to by this iterator from the collection.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Iterator
forEachRemaining

- Method Detail
  - getInstance
```
public static Iterator getInstance()
```
    Returns the singleton EmptyIterator object. Most of the methods of this class are instance methods and must be invoked with respect to the singleton object.
  - hasNext
```
public boolean hasNext()
```
    Checks whether the iterator can scan further.
    
    Specified by:
    
    hasNext in interface Iterator
    
    Returns:
    
    This method always returns false.
  - next
```
public Object next()
```
    Retrieves the next element in the collection scanned by this iterator.
    
    Specified by:
    
    next in interface Iterator
    
    Returns:
    
    This method always throws an exception.
    
    Throws:
    
    NoSuchElementException - Always, because the underlying collection is always empty.
  - remove
```
public void remove()
```
    Remove the element pointed to by this iterator from the collection.
    
    Specified by:
    
    remove in interface Iterator
    
    Throws:
    
    RuntimeException - Always, because the underlying collection is always empty.