org.geotools.data.property

Class PropertyFeatureSource

Object

ContentFeatureSource

PropertyFeatureSource

All Implemented Interfaces:

FeatureSource<SimpleFeatureType,SimpleFeature>, SimpleFeatureSource

public class PropertyFeatureSource
extends ContentFeatureSource

Author:

Jody Garnett, Torben Barsballe (Boundless)

Field Summary

Fields inherited from class ContentFeatureSource

entry, hints, lock, query, queryCapabilities, schema, transaction

Constructor Summary

Constructors

Constructor and Description
PropertyFeatureSource(ContentEntry entry, Query query)

Method Summary

Modifier and Type	Method and Description
protected void	addHints(Set<Hints.Key> hints) Subclass hook too add additional hints.
protected SimpleFeatureType	buildFeatureType() Creates the feature type or schema for the feature source.
protected QueryCapabilities	buildQueryCapabilities() Builds the query capabilities for this feature source.
protected ReferencedEnvelope	getBoundsInternal(Query query) Calculates the bounds of a specified query.
protected int	getCountInternal(Query query) Calculates the number of features of a specified query.
PropertyDataStore	getDataStore() The datastore that this feature source originated from.
protected FeatureReader<SimpleFeatureType,SimpleFeature>	getReaderInternal(Query query) Subclass method for returning a native reader from the datastore.
protected boolean	handleVisitor(Query query, FeatureVisitor visitor) Make handleVisitor package visible allowing PropertyFeatureStore to delegate to this implementation.

Methods inherited from class ContentFeatureSource

accepts, addFeatureListener, canEvent, canFilter, canLimit, canLock, canOffset, canReproject, canRetype, canSort, canTransact, doLockInternal, doUnlockInternal, getAbsoluteSchema, getBounds, getBounds, getCount, getEntry, getFeatures, getFeatures, getFeatures, getInfo, getName, getQueryCapabilities, getReader, getReader, getReader, getSchema, getState, getSupportedHints, getTransaction, getView, getView, isView, joinQuery, lockFeatures, lockFeatures, lockFeatures, processLock, removeFeatureListener, resolvePropertyNames, resolvePropertyNames, setFeatureLock, setTransaction, unLockFeatures, unLockFeatures, unLockFeatures

Methods inherited from class Object

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

Constructor Detail

PropertyFeatureSource

public PropertyFeatureSource(ContentEntry entry,
                             Query query)

Method Detail

addHints

protected void addHints(Set<Hints.Key> hints)

Description copied from class: ContentFeatureSource

Subclass hook too add additional hints.

By default, the followings are already present:

• Hints.JTS_COORDINATE_SEQUENCE_FACTORY
• Hints.JTS_GEOMETRY_FACTORY

Overrides:

addHints in class ContentFeatureSource

Parameters:

hints - The set of hints supported by the feature source.

getDataStore

public PropertyDataStore getDataStore()

Description copied from class: ContentFeatureSource

The datastore that this feature source originated from.

Subclasses may wish to extend this method in order to type narrow its return type.

Specified by:

getDataStore in interface FeatureSource<SimpleFeatureType,SimpleFeature>

Overrides:

getDataStore in class ContentFeatureSource

Returns:

the data source providing this FeatureSource

buildQueryCapabilities

protected QueryCapabilities buildQueryCapabilities()

Description copied from class: ContentFeatureSource

Builds the query capabilities for this feature source. The default implementation returns a newly built QueryCapabilities, subclasses are advised to build their own.

Overrides:

buildQueryCapabilities in class ContentFeatureSource

getBoundsInternal

protected ReferencedEnvelope getBoundsInternal(Query query)
                                        throws IOException

Description copied from class: ContentFeatureSource

Calculates the bounds of a specified query. Subclasses must implement this method. If the computation is not fast, subclasses can return null.

Specified by:

getBoundsInternal in class ContentFeatureSource

Throws:

IOException

getCountInternal

protected int getCountInternal(Query query)
                        throws IOException

Description copied from class: ContentFeatureSource

Calculates the number of features of a specified query. Subclasses must implement this method. If the computation is not fast, it's possible to return -1.

Specified by:

getCountInternal in class ContentFeatureSource

Throws:

IOException

buildFeatureType

protected SimpleFeatureType buildFeatureType()
                                      throws IOException

Description copied from class: ContentFeatureSource

Creates the feature type or schema for the feature source.

Implementations should use SimpleFeatureTypeBuilder to build the feature type. Also, the builder should be injected with the feature factory which has been set on the DataStore (see ContentDataStore.getFeatureFactory(). Example:

   SimpleFeatureTypeBuilder b = new SimpleFeatureTypeBuilder();
   b.setFeatureTypeFactory( getDataStore().getFeatureTypeFactory() );

   //build the feature type
   ...
 

Specified by:

buildFeatureType in class ContentFeatureSource

Throws:

IOException

getReaderInternal

protected FeatureReader<SimpleFeatureType,SimpleFeature> getReaderInternal(Query query)
                                                                    throws IOException

Description copied from class: ContentFeatureSource

Subclass method for returning a native reader from the datastore.

It is important to note that if the native reader intends to handle any of the following natively:

• reprojection
• filtering
• max feature limiting
• sorting
• locking
• transactions

Then it *must* set the corresponding flags to true:

• ContentFeatureSource.canReproject() - handles Query.getCoordinateSystemReproject() internally. Example would be PostGIS using Proj to handle reproejction internally
• ContentFeatureSource.canFilter() - handles Query#getFilter() internally.
• {@link #canLimit()} - handles {@link Query#getMaxFeatures()} and {@link Query#getStartIndex()} internally.
• {@link #canSort()} - handles {@link Query#getSortBy()} natively.
• {@link #canRetype()} - handles {@link Query#getProperties()} natively. Example would be only parsing the properties the user asks for from an XML file
• {@link #canLock()} - handles read-locks natively
• {@link #canTransact()} - handles transactions natively

Specified by:

getReaderInternal in class ContentFeatureSource

Throws:

IOException

handleVisitor

protected boolean handleVisitor(Query query,
                                FeatureVisitor visitor)
                         throws IOException

Make handleVisitor package visible allowing PropertyFeatureStore to delegate to this implementation.

Overrides:

handleVisitor in class ContentFeatureSource

Parameters:

query - The query being made.

visitor - The visitor to

Returns:

true if the visitor can be handled natively, otherwise false.

Throws:

IOException