Application: gvSIG desktop

 * 

 * 

 * 

 * 

 * 

 * 

        public interface DisposableFeatureSetIterable 

        }

	/**

	 * Returns the default {@link FeatureType} of this FeatureSet.

	 * 

	 * @return default {@link FeatureType} in this FeatureSet.

	 */

	public FeatureType getDefaultFeatureType();

	/**

	 * Returns a list of the {@link FeatureType}(s) in this FeatureSet.

	 * 

	 * @return list of the {@link FeatureType}(s) in this FeatureSet.

	 */

	public List getFeatureTypes();

	/**

	 * Returns the number of {@link Feature}(s) contained in this FeatureSet.

	 * 

	 * The value returned by this method won't be accurate when

	 * the FeatureStore is being edited and this set's features

	 * are modified, added or deleted.

	 *  

	 * @return number of {@link Feature}(s) contained in this FeatureSet.

	 * 

	 * @throws DataException

	 */

     * 

     * 

     * {@link DisposableIterator#dispose()}) in any case, even if an error occurs

     * while getting the data. It is recommended to use the <code>accept</code>

     * methods instead, which handle everything for you. 

     * Take into account the accept methods may use a fast iterator to 

     * get the features.

     * 

     * 

     * @param index

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

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

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

     * @throws DataException

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

     *             size()).

	DisposableIterator iterator(long index) throws DataException;

     * 

     * 

     *         sequence).

     * 

     @Override

     DisposableIterator iterator();

     DisposableFeatureSetIterable iterable();

     DisposableFeatureSetIterable iterable(boolean disposeFeatureSet);

     * 

     * {@link DisposableIterator#dispose()}) in any case, even if an error occurs

     * while getting the data. It is recommended to use the <code>accept</code>

     * methods instead, which handle everything for you. 

     * Take into account the accept methods may use a fast iterator to 

     * get the features.

     * 

     * 

     * 

	public DisposableIterator fastIterator() throws DataException;

     * 

     * {@link DisposableIterator#dispose()}) in any case, even if an error occurs

     * while getting the data. It is recommended to use the <code>accept</code>

     * methods instead, which handle everything for you. 

     * Take into account the accept methods may use a fast iterator to 

     * get the features.

     * 

     * 

     * @param index

     *            position in which the iterator is initially located.

     * 

     *         given index

     * 

        /**

         * Return the first feature of the set.

         * If the set is empty return null.

         * 

         * This not is a good method to determine if the set is empty.

         * Use isEmpty instead.

         * 

         * This is a utility method that call iterator and retrieve the

         * first feature of the iterator.

         * 

         * @return the first fearure of the set or null. 

         */

        public Feature first();

	/**

	 * Updates a {@link Feature} with the given {@link EditableFeature}.<br>

	 * 

	 * Any {@link DisposableIterator} from this store that was still in use can will not

	 * reflect this change.

	 * 

	 * @param feature

	 *            an instance of {@link EditableFeature} with which to update

	 *            the associated {@link Feature}.

	 * 

	 * @throws DataException

	 */

	public void update(EditableFeature feature) throws DataException;

        public void commitChanges() throws DataException;

        /**

	 * Deletes a {@link Feature} from this FeatureSet.<br>

	 * 

	 * Any {@link DisposableIterator} from this store that was still in use will be

	 * <i>unsafe</i>. Use {@link DisposableIterator#remove()} instead.

	 * 

	 * @param feature

	 *            the {@link Feature} to delete.

	 * 

	 * @throws DataException

	 */

	public void delete(Feature feature) throws DataException;

	/**

	 * Inserts a new feature in this set. It needs to be an instance of

	 * {@link EditableFeature} as it has not been stored yet.<br>

	 * 

	 * Any {@link DisposableIterator} from this store that was still in use can will not

	 * reflect this change.

	 * 

	 * @param feature

	 *            the {@link EditableFeature} to insert.

	 * 

	 * @throws DataException

	 */

	public void insert(EditableFeature feature) throws DataException;

     * Returns a {@link DynObjectSet} of the contents of this set.

     * Defaults to fast iteration.

     * 

     * 

     * @param fast

     *            if the set will be able to be iterated in a fast way, by

     *            reusing the {@link DynObject} instance for each

     *            {@link Feature} instance.

     * beginning from the provided index position.

     * The values received through the {@link Visitor#visit(Object)} method

     * may be transient, reused or externally modifiable, so they can't

     * be used to be stored in any external form out of the visit method.

     * 

     * 

     * @param visitor

     *            the visitor to apply to each value.

     * @param firstValueIndex

     *            index of first element to be visited by the {@link Visitor}

     * @exception BaseException

     *                if there is an error while performing the visit

}