| gvSIG desktop 1

package org.gvsig.fmap.data;

import java.util.Collection;

import java.util.Iterator;

import org.gvsig.tools.observer.Observer;

/**

 * <p> Interface that extends java.util.Collection. Represents 

 * a group of data elements (similar Recordset of JDBC). It`s used 

 * in a generic way as a collection of elements, regardless of that`s

 * the result of a data consult, a selection or a collection of 

 * blocked elements.</p>

 * 

 * @author 

 *

 */

public interface DataCollection extends Collection, Observer{

        public void dispose(); 

    public boolean isFromStore(DataStore store);

    /**

     * Returns an iterator over the elements in this collection, in the order

     * (if any) defined when the collection was obtained.

     * 

     * The iterator starts at the specified position in this collection. The

     * specified index indicates the first element that would be returned by an

     * initial call to the <tt>next</tt> method. An initial call to the

     * <tt>previous</tt> method would return the element with the specified

     * index minus one.

     * 

     * @param index

     *            index of first element to be returned from the iterator (by a

     *            call to the <tt>next</tt> method).

     * @return an iterator of the elements in this collection (in proper

     *         sequence), starting at the specified position in the collection.

     * @throws IndexOutOfBoundsException

     *             if the index is out of range (index < 0 || index >

     *             size()).

     */

    Iterator iterator(int index);

}