org.geotools.feature.collection

Interface RandomFeatureAccess

All Superinterfaces:

FeatureCollection<SimpleFeatureType,SimpleFeature>, SimpleFeatureCollection

All Known Implementing Classes:

MemoryFeatureCollection, SubFeatureList

public interface RandomFeatureAccess
extends SimpleFeatureCollection

Access Feature content using Feature "Id".

Many SimpleFeatureCollection classes will make use of this API to avoid unnecessary caching of content. Supporting this interface will allow SubCollections to occur based on FeatureIds, with a suitable improvement in memory consumption.

For an addition improvement in memory comsumption SubCollections may use of a sparse reprsentation where only (beginId,endId] ranges are kept in memory.

Author:

Jody Garnett, Refractions Research Inc.

Method Summary

Modifier and Type	Method and Description
SimpleFeature	getFeatureMember(String id) Access Feature content by feature id.
SimpleFeature	removeFeatureMember(String id) Optional Method

Methods inherited from interface SimpleFeatureCollection

features, sort, subCollection

Methods inherited from interface FeatureCollection

accepts, contains, containsAll, getBounds, getID, getSchema, isEmpty, size, toArray, toArray

Method Detail

getFeatureMember

SimpleFeature getFeatureMember(String id)
                        throws NoSuchElementException

Access Feature content by feature id.

Parameters:

id -

Returns:

Feature with the indicated or id

Throws:

NoSuchElementException - if a Feature with the indicated id is not present

removeFeatureMember

SimpleFeature removeFeatureMember(String id)

Optional Method