/*
* GeoTools - The Open Source Java GIS Toolkit
* http://geotools.org
*
* (C) 2002-2008, Open Source Geospatial Foundation (OSGeo)
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation;
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*/
package org.geotools.feature;
import org.opengis.feature.Feature;
/**
* A drop in replacement for Iterator<Feature> supporting a close method.
*
* @author Ian Schneider
* @source $URL$
*/
public interface FeatureIterator<F extends Feature> {
/**
* Does another Feature exist in this Iteration.
* <p>
* Iterator defin: Returns true if the iteration has more elements. (In other words, returns true if next would return an element rather than throwing an exception.)
* </p>
* @return true if more Features exist, false otherwise.
*/
public boolean hasNext();
/**
* Get the next Feature in this iteration.
*
* @return The next Feature
*
* @throws java.util.NoSuchElementException If no more Features exist.
*/
public F next() throws java.util.NoSuchElementException;
/**
* Required so FeatureCollection<SimpleFeatureType, SimpleFeature> classes can implement close( FeatureIterator<SimpleFeature> ).
*/
public void close();
}