|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface FeatureStore<T extends FeatureType,F extends Feature>
Provides storage of data for Features.
Individual shapefiles, database tables, etc. are modified through this interface.
This is a prototype DataSource replacement please see FeatureSource
modules/library/api (gt-api.jar)
Method Summary | |
---|---|
List<FeatureId> |
addFeatures(FeatureCollection<T,F> collection)
Adds all features from the passed feature collection to the datasource. |
Transaction |
getTransaction()
Used to access the Transaction this DataSource is currently opperating against. |
void |
modifyFeatures(AttributeDescriptor[] type,
Object[] value,
Filter filter)
Modifies the passed attribute types with the passed objects in all features that correspond to the passed OGS filter. |
void |
modifyFeatures(AttributeDescriptor type,
Object value,
Filter filter)
Modifies the passed attribute types with the passed objects in all features that correspond to the passed OGS filter. |
void |
removeFeatures(Filter filter)
Removes all of the features specificed by the passed filter from the collection. |
void |
setFeatures(FeatureReader<T,F> reader)
Deletes the all the current Features of this datasource and adds the new collection. |
void |
setTransaction(Transaction transaction)
Provides a transaction for commit/rollback control of this FeatureStore. |
Methods inherited from interface FeatureSource |
---|
addFeatureListener, getBounds, getBounds, getCount, getDataStore, getFeatures, getFeatures, getFeatures, getInfo, getName, getQueryCapabilities, getSchema, getSupportedHints, removeFeatureListener |
Method Detail |
---|
List<FeatureId> addFeatures(FeatureCollection<T,F> collection) throws IOException
A list of FeatureIds is returned; one for each Feature in the order created. Please note that these FeatureIds may not be assigned until after a commit has been performed.
collection
- The collection of features to add.
IOException
- if anything goes wrong.void removeFeatures(Filter filter) throws IOException
filter
- An OpenGIS filter; specifies which features to remove.
IOException
- If anything goes wrong.void modifyFeatures(AttributeDescriptor[] type, Object[] value, Filter filter) throws IOException
type
- The attributes to modify.value
- The values to put in the attribute types.filter
- An OGC filter to note which attributes to modify.
IOException
- if the attribute and object arrays are not eqaul
length, if the object types do not match the attribute types,
or if there are backend errors.void modifyFeatures(AttributeDescriptor type, Object value, Filter filter) throws IOException
type
- The attributes to modify.value
- The values to put in the attribute types.filter
- An OGC filter to note which attributes to modify.
IOException
- If modificaton is not supported, if the object type
do not match the attribute type.void setFeatures(FeatureReader<T,F> reader) throws IOException
reader
- - the collection to be written
IOException
- if there are any datasource errors.void setTransaction(Transaction transaction)
This method operates as a replacement for setAutoCommitMode. When a transaction is provided you are no longer automatically committing.
In order to return to AutoCommit mode supply the Transaction.AUTO_COMMIT to this method. Since this represents a return to AutoCommit mode the previous Transaction will be commited.
transaction
- DOCUMENT ME!Transaction getTransaction()
Example Use: adding features to a road DataSource
Transaction t = roads.getTransaction();
try{
roads.addFeatures( features );
roads.getTransaction().commit();
}
catch( IOException erp ){
//something went wrong;
roads.getTransaction().rollback();
}
Transaction.AUTO_COMMIT
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |