org.gvsig.fmap.dal.feature.spi

Class AbstractFeatureSetProvider

java.lang.Object

org.gvsig.tools.dispose.impl.AbstractDisposable

org.gvsig.fmap.dal.feature.spi.AbstractFeatureSetProvider

All Implemented Interfaces:

FeatureSetProvider, Disposable

Direct Known Subclasses:

DBFSetProvider, GPESetProvider, JDBCSetProvider, MemoryFeatureSet, OGRFetureSetProvider, SimpleReaderSetProvider

public abstract class AbstractFeatureSetProvider
extends AbstractDisposable
implements FeatureSetProvider

Base implementation for FeatureSetProviders, adding some utility methods.

Field Summary

Fields

Modifier and Type	Field and Description
protected static Logger	LOGGER

Constructor Summary

Constructors

Constructor and Description
AbstractFeatureSetProvider(AbstractFeatureStoreProvider store, FeatureQuery query, FeatureType providerFeatureType)
AbstractFeatureSetProvider(AbstractFeatureStoreProvider store, FeatureQuery query, FeatureType providerFeatureType, FeatureType storeFeatureType) Creates a new FeatureSetProvider.

Method Summary

Modifier and Type	Method and Description
protected abstract AbstractFeatureProviderIterator	createFastIterator(long index) Creates a new fast Iterator, begginning at the specified data index.
protected AbstractFeatureProviderIterator	createFastIterator(long index, long elements)
protected abstract AbstractFeatureProviderIterator	createIterator(long index) Creates a new Iterator, begginning at the specified data index.
protected AbstractFeatureProviderIterator	createIterator(long index, long elements)
protected java.util.Iterator	createSpatialIterator(FeatureType featureType, FeatureQuery query)
DisposableIterator	fastIterator() Returns an iterator over the elements in this set, in the order (if any) defined when the collection was obtained.
DisposableIterator	fastIterator(long index)
DisposableIterator	fastIterator(long index, long elements) Returns an iterator over the elements in this set, in the order (if any) defined when the collection was obtained.
protected FeatureType	getFeatureType() Deprecated. use getProviderFeatureType
protected FeatureType	getProviderFeatureType() Returns the type of features from provider to load.
protected FeatureQuery	getQuery() Returns the FeatureQuery used to create this set.
protected SpatialIndex	getSpatialIndex(java.lang.String name)
protected AbstractFeatureStoreProvider	getStore() Return the AbstractFeatureStoreProvider.
protected FeatureType	getStoreFeatureType() Returns the type of features from store to load.
DisposableIterator	iterator() Returns an iterator over the elements in this set, in the order (if any) defined when the collection was obtained.
DisposableIterator	iterator(long index)
DisposableIterator	iterator(long index, long elements) Returns an iterator over the elements in this set, in the order (if any) defined when the collection was obtained.
java.lang.String	toString()

Methods inherited from class org.gvsig.tools.dispose.impl.AbstractDisposable

dispose, dispose, doDispose

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gvsig.fmap.dal.feature.spi.FeatureSetProvider

canFilter, canIterateFromIndex, canOrder, getSize, isEmpty

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

dispose

Field Detail

LOGGER

protected static final Logger LOGGER

Constructor Detail

AbstractFeatureSetProvider

public AbstractFeatureSetProvider(AbstractFeatureStoreProvider store,
                                  FeatureQuery query,
                                  FeatureType providerFeatureType,
                                  FeatureType storeFeatureType)

Creates a new FeatureSetProvider.

Parameters:

store - the underlying FeatureStoreProvider to get the data from

query - used to create the FeatureSetProvider

providerFeatureType - the type of feature to get

AbstractFeatureSetProvider

public AbstractFeatureSetProvider(AbstractFeatureStoreProvider store,
                                  FeatureQuery query,
                                  FeatureType providerFeatureType)

Method Detail

getStore

protected AbstractFeatureStoreProvider getStore()

Return the AbstractFeatureStoreProvider.

Returns:

the store

getQuery

protected FeatureQuery getQuery()

Returns the FeatureQuery used to create this set.

Returns:

the query

getProviderFeatureType

protected FeatureType getProviderFeatureType()

Returns the type of features from provider to load.

Returns:

the providerFeatureType

getStoreFeatureType

protected FeatureType getStoreFeatureType()

Returns the type of features from store to load.

Returns:

the storeFeatureType

getFeatureType

protected FeatureType getFeatureType()

Deprecated. use getProviderFeatureType

Returns the type of features from provider to load.

Returns:

the providerFeatureType

fastIterator

public final DisposableIterator fastIterator()
                                      throws DataException

Description copied from interface: FeatureSetProvider

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

Specified by:

fastIterator in interface FeatureSetProvider

Returns:

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

Throws:

DataException - if there is an error getting the iterator

See Also:

FeatureSetProvider.fastIterator(), #fastIterator(long)

fastIterator

public final DisposableIterator fastIterator(long index)
                                      throws DataException

Throws:

DataException

fastIterator

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

Description copied from interface: FeatureSetProvider

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

Specified by:

fastIterator in interface FeatureSetProvider

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).

Throws:

DataException - if there is an error getting the iterator

See Also:

FeatureSetProvider.fastIterator(), #fastIterator(long)

iterator

public final DisposableIterator iterator()
                                  throws DataException

Description copied from interface: FeatureSetProvider

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

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 FeatureProvider of the iterator, use the FeatureProvider.getCopy() to create a clone of the object.

Specified by:

iterator in interface FeatureSetProvider

Returns:

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

Throws:

DataException - if there is an error getting the iterator

iterator

public final DisposableIterator iterator(long index)
                                  throws DataException

Throws:

DataException

iterator

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

Description copied from interface: FeatureSetProvider

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

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 FeatureProvider of the iterator, use the FeatureProvider.getCopy() to create a clone of the object.

Specified by:

iterator in interface FeatureSetProvider

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).

Throws:

DataException - if there is an error getting the iterator

createIterator

protected abstract AbstractFeatureProviderIterator createIterator(long index)
                                                           throws DataException

Creates a new Iterator, begginning at the specified data index.

Parameters:

index - the first element position to be returned by the Iterator

Returns:

a new Iterator

Throws:

DataException - if there is an error creating the Iterator

createIterator

protected AbstractFeatureProviderIterator createIterator(long index,
                                                         long elements)
                                                  throws DataException

Throws:

DataException

createFastIterator

protected abstract AbstractFeatureProviderIterator createFastIterator(long index)
                                                               throws DataException

Creates a new fast Iterator, begginning at the specified data index. By fast this means the object instances of data ( FeatureProvider) may be reused between the Iterator.next() method invocations.

Parameters:

index - the first element position to be returned by the Iterator

Returns:

a new Iterator

Throws:

DataException - if there is an error creating the Iterator

createFastIterator

protected AbstractFeatureProviderIterator createFastIterator(long index,
                                                             long elements)
                                                      throws DataException

Throws:

DataException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getSpatialIndex

protected SpatialIndex getSpatialIndex(java.lang.String name)

createSpatialIterator

protected java.util.Iterator createSpatialIterator(FeatureType featureType,
                                                   FeatureQuery query)