RandomFeatureAccess (Geotools modules 31-SNAPSHOT API)

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

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`SimpleFeature`	`getFeatureMember(String id)`	Access Feature content by feature id.
`SimpleFeature`	`removeFeatureMember(String id)`	Optional Method

Methods inherited from interface FeatureCollection
accepts, contains, containsAll, getBounds, getID, getSchema, isEmpty, size, toArray, toArray

Methods inherited from interface SimpleFeatureCollection
features, sort, subCollection

- Method Detail
  - getFeatureMember
```
SimpleFeature getFeatureMember(String id)
                        throws NoSuchElementException
```
    Access Feature content by feature 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