org.gvsig.fmap.dal.feature

Interface FeatureSet

All Superinterfaces:

DataSet, Disposable, IndexedVisitable, IsEmpty, java.lang.Iterable<Feature>, Size, Size64, Visitable

All Known Subinterfaces:

FeatureSelection, FeatureSet

All Known Implementing Classes:

AbstractFeatureSet, DefaultFeatureSelection, DefaultFeatureSet, IndexFeatureSet, LargeFeatureSelection

public interface FeatureSet
extends DataSet, Size64, Size, IsEmpty, IndexedVisitable, java.lang.Iterable<Feature>

A FeatureSet represents a set of Feature(s). These sets of features are typically obtained directly from a FeatureStore, or through a FeatureQuery. A FeatureSet may contain subsets of Feature(s) of different FeatureType(s). It allows iterating and editing the features. FIXME: Actualizar javadoc Si el store en el que esta basado el featureset es modificado, se realiza un update, insert, delete o se modifican los featuretype de este, el FeatureSet quedara invalidado, y cualquier acceso a el provocara que se lance una excepcion de tiempo de ejecucion ConcurrentModificationException. Habria que indicar que invocar al metodo accept del interface visitor provocara la excepcion ConcurrentModificationException si el store a sido modificado desde otro punto. Indicar que los metodos insert/delete/update ademas de actuar sobre el set, actuan sobre el store en el que este esta basado, pero que no invalidan el set sobre el que se ejecutan. No se si esto deberia hacerse mencion en esos metodos o en la doc general del featureset.

Field Summary

Fields

Modifier and Type	Field and Description
static FeatureSet	EMPTY_FEATURESET

Method Summary

Modifier and Type	Method and Description
void	accept(Visitor visitor, long firstValueIndex) Provides each value of this Store to the provided Visitor, beginning from the provided index position.
void	accept(Visitor visitor, long firstValueIndex, long elements)
void	commitChanges()
void	delete(Feature feature) Deletes a Feature from this FeatureSet.
DisposableIterator	fastIterator() Returns a fast iterator over this set.
DisposableIterator	fastIterator(long index) Returns a fast iterator over this set, starting from the given index.
DisposableIterator	fastIterator(long index, long elemets)
Feature	first() Return the first feature of the set.
FeatureType	getDefaultFeatureType() Returns the default FeatureType of this FeatureSet.
DynObjectSet	getDynObjectSet() Returns a DynObjectSet of the contents of this set.
DynObjectSet	getDynObjectSet(boolean fast) Returns a DynObjectSet of the contents of this set.
FeatureStore	getFeatureStore()
java.util.List	getFeatureTypes() Returns a list of the FeatureType(s) in this FeatureSet.
long	getSize() Returns the number of Feature(s) contained in this FeatureSet.
void	insert(EditableFeature feature) Inserts a new feature in this set.
DisposableFeatureSetIterable	iterable()
DisposableFeatureSetIterable	iterable(boolean disposeFeatureSet)
DisposableIterator	iterator() Deprecated. use fastiterator. In next versions the signature of this method will be changed to "Iterator<Feature> iterator()".
DisposableIterator	iterator(long index) Deprecated. use fastIterator(long) instead
DisposableIterator	iterator(long index, long elements)
Expression	makeFilter(int maxfeatures)
JsonArray	toJson()
JsonArray	toJSON() Deprecated.
JsonArrayBuilder	toJsonBuilder()
void	update(EditableFeature feature) Updates a Feature with the given EditableFeature.

Methods inherited from interface org.gvsig.fmap.dal.DataSet

accept, isFromStore

Methods inherited from interface org.gvsig.tools.dispose.Disposable

dispose

Methods inherited from interface org.gvsig.tools.util.Size64

size64

Methods inherited from interface org.gvsig.tools.util.Size

size

Methods inherited from interface org.gvsig.tools.util.IsEmpty

isEmpty, isEmpty, isEmpty, isEmptyQuietly

Methods inherited from interface org.gvsig.tools.visitor.Visitable

accept

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

EMPTY_FEATURESET

static final FeatureSet EMPTY_FEATURESET

Method Detail

getDefaultFeatureType

FeatureType getDefaultFeatureType()

Returns the default FeatureType of this FeatureSet.

Returns:

default FeatureType in this FeatureSet.

getFeatureTypes

java.util.List getFeatureTypes()

Returns a list of the FeatureType(s) in this FeatureSet.

Returns:

list of the FeatureType(s) in this FeatureSet.

getSize

long getSize()
      throws DataException

Returns the number of 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.

Returns:

number of Feature(s) contained in this FeatureSet.

Throws:

DataException

iterator

DisposableIterator iterator(long index)
                     throws DataException

Deprecated. use fastIterator(long) instead

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 next method. An initial call to the previous method would return the element with the specified index minus one.

NOTE: if you use this method to get the iterator, you must get sure the iterator is disposed (@see Disposable.dispose()) in any case, even if an error occurs while getting the data. It is recommended to use the accept methods instead, which handle everything for you. Take into account the accept methods may use a fast iterator to get the features.

Parameters:

index - index of first element to be returned from the iterator (by a call to the next method).

Returns:

an iterator of the elements in this collection (in proper sequence), starting at the specified position in the collection.

Throws:

DataException - if the index is out of range (index < 0 || index > size()).

See Also:

DataSet.accept(org.gvsig.tools.visitor.Visitor), accept(org.gvsig.tools.visitor.Visitor, long), fastIterator(), fastIterator(long)

iterator

DisposableIterator iterator(long index,
                            long elements)
                     throws DataException

Throws:

DataException

iterator

DisposableIterator iterator()

Deprecated. use fastiterator. In next versions the signature of this method will be changed to "Iterator<Feature> iterator()".

Returns an iterator over the elements in this collection, in the order (if any) defined when the collection was obtained.

Specified by:

iterator in interface java.lang.Iterable<Feature>

Returns:

an iterator of the elements in this collection (in proper sequence).

See Also:

DataSet.accept(org.gvsig.tools.visitor.Visitor), accept(org.gvsig.tools.visitor.Visitor, long), fastIterator(), fastIterator(long)

iterable

DisposableFeatureSetIterable iterable()

iterable

DisposableFeatureSetIterable iterable(boolean disposeFeatureSet)

fastIterator

DisposableIterator fastIterator()
                         throws DataException

Returns a fast iterator over this set.

Fast in this case means that each of the elements returned may be a reused or pooled object instance, so don't use it to be stored in any way.

If you need to store one of the Feature of the iterator, use the Feature.getCopy() to create a clone of the object.

NOTE: if you use this method to get the iterator, you must get sure the iterator is disposed (@see Disposable.dispose()) in any case, even if an error occurs while getting the data. It is recommended to use the accept methods instead, which handle everything for you. Take into account the accept methods may use a fast iterator to get the features.

Returns:

an iterator over this set.

Throws:

DataException

See Also:

DataSet.accept(org.gvsig.tools.visitor.Visitor), accept(org.gvsig.tools.visitor.Visitor, long)

fastIterator

DisposableIterator fastIterator(long index)
                         throws DataException

Returns a fast iterator over this set, starting from the given index.

Fast in this case means that each of the elements returned may be a reused or pooled object instance, so don't use it to be stored in any way.

If you need to store one of the Feature of the iterator, use the Feature.getCopy() to create a clone of the object.

NOTE: if you use this method to get the iterator, you must get sure the iterator is disposed (@see Disposable.dispose()) in any case, even if an error occurs while getting the data. It is recommended to use the accept methods instead, which handle everything for you. Take into account the accept methods may use a fast iterator to get the features.

Parameters:

index - position in which the iterator is initially located.

Returns:

an iterator initially located at the position indicated by the given index

Throws:

DataException

See Also:

DataSet.accept(org.gvsig.tools.visitor.Visitor), accept(org.gvsig.tools.visitor.Visitor, long)

fastIterator

DisposableIterator fastIterator(long index,
                                long elemets)
                         throws DataException

Throws:

DataException

first

Feature first()

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.

Returns:

the first fearure of the set or null.

update

void update(EditableFeature feature)
     throws DataException

Updates a Feature with the given EditableFeature.
Any DisposableIterator from this store that was still in use can will not reflect this change.

Parameters:

feature - an instance of EditableFeature with which to update the associated Feature.

Throws:

DataException

commitChanges

void commitChanges()
            throws DataException

Throws:

DataException

delete

void delete(Feature feature)
     throws DataException

Deletes a Feature from this FeatureSet.
Any DisposableIterator from this store that was still in use will be unsafe. Use Iterator.remove() instead.

Parameters:

feature - the Feature to delete.

Throws:

DataException

insert

void insert(EditableFeature feature)
     throws DataException

Inserts a new feature in this set. It needs to be an instance of EditableFeature as it has not been stored yet.
Any DisposableIterator from this store that was still in use can will not reflect this change.

Parameters:

feature - the EditableFeature to insert.

Throws:

DataException

getDynObjectSet

DynObjectSet getDynObjectSet()

Returns a DynObjectSet of the contents of this set. Defaults to fast iteration.

Returns:

a DynObjectSet

getDynObjectSet

DynObjectSet getDynObjectSet(boolean fast)

Returns a DynObjectSet of the contents of this set.

Parameters:

fast - if the set will be able to be iterated in a fast way, by reusing the DynObject instance for each Feature instance.

Returns:

a DynObjectSet

accept

void accept(Visitor visitor,
            long firstValueIndex)
     throws BaseException

Provides each value of this Store to the provided Visitor, beginning from the provided index position. The values received through the 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. If you need to store any of the values out of the Visitor.visit(Object) method execution, create a copy or clone the received value in order to be stored.

Specified by:

accept in interface IndexedVisitable

Parameters:

visitor - the visitor to apply to each value.

firstValueIndex - index of first element to be visited by the Visitor

Throws:

BaseException - if there is an error while performing the visit

accept

void accept(Visitor visitor,
            long firstValueIndex,
            long elements)
     throws BaseException

Throws:

BaseException

getFeatureStore

FeatureStore getFeatureStore()

toJSON

@Deprecated
JsonArray toJSON()

Deprecated.

toJson

JsonArray toJson()

toJsonBuilder

JsonArrayBuilder toJsonBuilder()

makeFilter

Expression makeFilter(int maxfeatures)