org.gvsig.fmap.dal.feature.impl.featureset

Class DefaultFeatureSet

java.lang.Object

org.gvsig.tools.visitor.impl.AbstractVisitable

org.gvsig.tools.visitor.impl.AbstractIndexedVisitable

org.gvsig.fmap.dal.feature.impl.featureset.AbstractFeatureSet

org.gvsig.fmap.dal.feature.impl.featureset.DefaultFeatureSet

All Implemented Interfaces:

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

public class DefaultFeatureSet
extends AbstractFeatureSet
implements FeatureSet, Observer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultFeatureSet.SetConcurrentModificationException

Field Summary

Fields

Modifier and Type	Field and Description
protected FeatureType	defatulFeatureTypeForProvider
protected static int	DEFAULT
protected FeatureType	defaultFeatureType
protected static int	EDITED
protected static int	EDITED_FILTERED
protected Feature	featureToIgnoreNotification
protected java.util.List	featureTypes
protected static int	FILTERED
protected boolean	ignoreChanges
protected int	iteratorMode
protected static int	NO_CHECKED
protected static int	ORDERD_EDITED
protected static int	ORDERED
protected static int	ORDERED_EDITED_FILTER
protected static int	ORDERED_FILTERED
protected java.util.List	orderedData
protected boolean	ownFeaturesModified
protected FeatureSetProvider	provider
protected FeatureQuery	query
protected FeatureQuery	queryForProvider
protected long	size
protected boolean	sourceStoreModified
protected java.lang.Throwable	sourceStoreModifiedCause
protected DefaultFeatureStore	store
protected DefaultFeatureStoreTransforms	transform

Fields inherited from class org.gvsig.fmap.dal.feature.impl.featureset.AbstractFeatureSet

LOG

Fields inherited from interface org.gvsig.fmap.dal.feature.FeatureSet

EMPTY_FEATURESET

Constructor Summary

Constructors

Constructor and Description
DefaultFeatureSet(DefaultFeatureStore store, FeatureQuery query)

Method Summary

Modifier and Type	Method and Description
protected void	checkSourceStoreModified()
void	commitChanges()
void	delete(Feature feature) Deletes a Feature from this FeatureSet.
void	dispose() Disposes the current object, to allow it to close and dispose any used resources.
void	doDispose()
DisposableIterator	fastIterator(long index) Returns a fast iterator over this set, starting from the given index.
DisposableIterator	fastIterator(long index, long elements)
FeatureType	getDefaultFeatureType() Returns the default FeatureType of this FeatureSet.
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.
DisposableIterator	iterator(long index) Returns an iterator over the elements in this collection, in the order (if any) defined when the collection was obtained.
DisposableIterator	iterator(long index, long elements)
void	setIgnoreConcurrentChanges(boolean b)
void	update(EditableFeature feature) Updates a Feature with the given EditableFeature.
void	update(Observable obsevable, java.lang.Object notification) Called whenever a Observable object is changed and this Observer has registered on it to receive notifications.

Methods inherited from class org.gvsig.fmap.dal.feature.impl.featureset.AbstractFeatureSet

accept, doAccept, doAccept, fastIterator, first, getDynObjectSet, getDynObjectSet, isEmpty, isFromStore, iterable, iterable, iterator, makeFilter, size, size64, toJson, toJSON, toJsonBuilder

Methods inherited from class org.gvsig.tools.visitor.impl.AbstractIndexedVisitable

accept, doAccept

Methods inherited from class org.gvsig.tools.visitor.impl.AbstractVisitable

accept

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gvsig.fmap.dal.feature.FeatureSet

accept, accept, fastIterator, first, getDynObjectSet, getDynObjectSet, iterable, iterable, iterator, makeFilter, toJson, toJSON, toJsonBuilder

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

accept, isFromStore

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

NO_CHECKED

protected static final int NO_CHECKED

See Also:

Constant Field Values

DEFAULT

protected static final int DEFAULT

See Also:

Constant Field Values

FILTERED

protected static final int FILTERED

See Also:

Constant Field Values

ORDERED

protected static final int ORDERED

See Also:

Constant Field Values

ORDERED_FILTERED

protected static final int ORDERED_FILTERED

See Also:

Constant Field Values

EDITED

protected static final int EDITED

See Also:

Constant Field Values

EDITED_FILTERED

protected static final int EDITED_FILTERED

See Also:

Constant Field Values

ORDERD_EDITED

protected static final int ORDERD_EDITED

See Also:

Constant Field Values

ORDERED_EDITED_FILTER

protected static final int ORDERED_EDITED_FILTER

See Also:

Constant Field Values

sourceStoreModifiedCause

protected java.lang.Throwable sourceStoreModifiedCause

sourceStoreModified

protected boolean sourceStoreModified

ownFeaturesModified

protected boolean ownFeaturesModified

store

protected DefaultFeatureStore store

featureTypes

protected java.util.List featureTypes

query

protected FeatureQuery query

provider

protected FeatureSetProvider provider

size

protected long size

iteratorMode

protected int iteratorMode

orderedData

protected java.util.List orderedData

featureToIgnoreNotification

protected Feature featureToIgnoreNotification

transform

protected DefaultFeatureStoreTransforms transform

queryForProvider

protected FeatureQuery queryForProvider

defaultFeatureType

protected FeatureType defaultFeatureType

defatulFeatureTypeForProvider

protected FeatureType defatulFeatureTypeForProvider

ignoreChanges

protected boolean ignoreChanges

Constructor Detail

DefaultFeatureSet

public DefaultFeatureSet(DefaultFeatureStore store,
                         FeatureQuery query)
                  throws DataException

Throws:

DataException

Method Detail

getDefaultFeatureType

public FeatureType getDefaultFeatureType()

Description copied from interface: FeatureSet

Returns the default FeatureType of this FeatureSet.

Specified by:

getDefaultFeatureType in interface FeatureSet

Returns:

default FeatureType in this FeatureSet.

getFeatureTypes

public java.util.List getFeatureTypes()

Description copied from interface: FeatureSet

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

Specified by:

getFeatureTypes in interface FeatureSet

Returns:

list of the FeatureType(s) in this FeatureSet.

getSize

public long getSize()
             throws DataException

Description copied from interface: FeatureSet

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.

Specified by:

getSize in interface FeatureSet

Returns:

number of Feature(s) contained in this FeatureSet.

Throws:

DataException

dispose

public final void dispose()

Description copied from interface: Disposable

Disposes the current object, to allow it to close and dispose any used resources.

NOTE:After calling this method, the object may not be usable anymore.

Specified by:

dispose in interface Disposable

doDispose

public void doDispose()

update

public void update(Observable obsevable,
                   java.lang.Object notification)

Description copied from interface: Observer

Called whenever a Observable object is changed and this Observer has registered on it to receive notifications.

Implementations of this method will be called for each simple notification or, if a complex notification is created, for each of the child notifications.

In the latter case, don't assume any ordering in the notification between this Observer and other Observers listening to the same Observable.

In a complex notification scenario, if you want to receive only the complex notification and not each of the child notifications, just implement the ComplexObserver and prepare this method implementation to handle receiving DefaultComplexNotification instances as well as direct notification objects.

Specified by:

update in interface Observer

Parameters:

obsevable - the observable object.

notification - the notification data.

checkSourceStoreModified

protected void checkSourceStoreModified()

fastIterator

public DisposableIterator fastIterator(long index)
                                throws DataException

Description copied from interface: FeatureSet

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.

Specified by:

fastIterator in interface FeatureSet

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), FeatureSet.accept(org.gvsig.tools.visitor.Visitor, long)

fastIterator

public DisposableIterator fastIterator(long index,
                                       long elements)
                                throws DataException

Specified by:

fastIterator in interface FeatureSet

Throws:

DataException

setIgnoreConcurrentChanges

public void setIgnoreConcurrentChanges(boolean b)

iterator

public DisposableIterator iterator(long index)
                            throws DataException

Description copied from interface: FeatureSet

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.

Specified by:

iterator in interface FeatureSet

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), FeatureSet.accept(org.gvsig.tools.visitor.Visitor, long), FeatureSet.fastIterator(), FeatureSet.fastIterator(long)

iterator

public DisposableIterator iterator(long index,
                                   long elements)
                            throws DataException

Specified by:

iterator in interface FeatureSet

Throws:

DataException

delete

public void delete(Feature feature)
            throws DataException

Description copied from interface: FeatureSet

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

Specified by:

delete in interface FeatureSet

Parameters:

feature - the Feature to delete.

Throws:

DataException

insert

public void insert(EditableFeature feature)
            throws DataException

Description copied from interface: FeatureSet

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.

Specified by:

insert in interface FeatureSet

Parameters:

feature - the EditableFeature to insert.

Throws:

DataException

update

public void update(EditableFeature feature)
            throws DataException

Description copied from interface: FeatureSet

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

Specified by:

update in interface FeatureSet

Parameters:

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

Throws:

DataException

commitChanges

public void commitChanges()
                   throws DataException

Specified by:

commitChanges in interface FeatureSet

Throws:

DataException

getFeatureStore

public FeatureStore getFeatureStore()

Specified by:

getFeatureStore in interface FeatureSet

Specified by:

getFeatureStore in class AbstractFeatureSet