This
interface defines a single method
for returning a
java.util.Iterator object. Iterable
was added in Java 5.0 to support the for/in loop,
which is also new in Java 5.0. The Collection,
List, Set, and
Queue collection interfaces of
java.util extend this interface, making all
collections other than maps Iterable. You can
implement this interface in your own classes if you want to allow
them to be iterated with the for/in loop.
The type variable T specifies the type parameter
of the returned Iterator object, which, in turn,
specifies the element type of the collection being iterated over.
public interface Iterable<T> {
// Public Instance Methods
java.util.Iterator<T> iterator( );
}