Package org.geotools.api.data
Defines the DataStore API via which all data is imported or exported.
All DataStores (e.g. PostGIS, Shapefile(tm), GML...) must provide implementations of the DataStore interface and the DataStoreFactorySpi interface. These interfaces allow new types of datastore to be plugged into applications which use GeoTools without the need to modify any code.
Example:
FeatureStore postgis = new PostGisDataStore( ... );
Query all = Query.ALL;
FeatureType roadType = postgis.getFeatureType( "roads" );
// reader 1 streams over all roads
FeatureReader reader1 = postgis.getFeatureReader( roadsType, all, Transaction.AUTO_COMMIT );
// allRoads = featureResults is a prepaired query of all roads
FeatureSource roads = postgis.getFeatureSource( "roads" );
FeatureResults allRoads = roads.getFeatures( all );
// reader 2 & 3 streams over all roads in the same manner as reader 1
FeatureReader reader2 = allRoads.reader();
FeatureReader reader3 = allRoads.reader();
// bounds1 returns the bounding box of roads, may be null depending on expense
Envelope bounds1 = roads.getBounds( all );
// bounds2 returns the bounding box of roads, may actually calculate by going over the entire dataset
Envelope bounds 2 = allRoads.getBounds();
-
Interface Summary Interface Description AttributeReader The low-level attribute reading API.AttributeWriter - Added hasNext to support the FeatureWriter API. - Changed order of writer parameters to match Collections, JDBC API. - Added IOExceptions on all methods. - Do we want AttributeWriters to know about the schema and perform validation??CloseableIterator<T> An iterator backed by some resource that needs closing when done using itDataAccess<T extends FeatureType,F extends Feature> This is the top-level interface for access toFeatureData
.DataAccessFactory Constructs a live DataAccess from a set of connection parameters.DataStore This represents a physical source of feature data, such as a shapefiles or database, where the features will be instances ofSimpleFeature
.DataStoreFactorySpi Factory used to construct a DataStore from a set of parameters.DelegatingFeatureReader<T extends FeatureType,F extends Feature> Interface for wrapping feature readers which delegate to another feature reader.DelegatingFeatureWriter<T extends FeatureType,F extends Feature> Interface for wrapping feature writers which delegate to another feature writer.FeatureListener Interface to be implemented by all listeners of FeatureEvents.FeatureLocking<T extends FeatureType,F extends Feature> Provides Feature based locking.FeatureReader<T extends FeatureType,F extends Feature> The low-level interface for reading Features.FeatureSource<T extends FeatureType,F extends Feature> This class provides a high-level API for operations on feature data.FeatureStore<T extends FeatureType,F extends Feature> This interface extendsFeatureSource
, adding methods to add and remove features and to modify existing features.FeatureWriter<T extends FeatureType,F extends Feature> Provides the ability to write Features information.FIDReader FeatureReadercustomized for FeatureID handling. FileDataStore DataStore represents a single file of content.FileDataStoreFactorySpi DataAccessFactory for working with formats based on a single URL.FileGroupProvider AFileGroupProvider.FileGroup
provider allowing to return aCloseableIterator
ofFileGroupProvider.FileGroup
s.FileResourceInfo ExtendsResourceInfo
with information about the file structure of the resourceFileServiceInfo ExtendsServiceInfo
with information about the underlying file structureFileStoreFactory A delegate that finds the files managed by the directory store andFilteringFileStoreFactory A delegate that indicates which files can be managed by the delegate store, when setting up a DirectoryDataStoreLockingManager This class describes a featureID based locking service.Repository An adapter interface allowing a hosting application to advertise DataStore instances to GeoTools.ResourceInfo This interface defines methods to convey information about some resource such as title, keywords, description and spatial parameters.ServiceInfo Information about a service.SimpleFeatureLocking Used to lock feature content to protect against other threads (or depending on the source of data other applications) making modifications when you are not looking.SimpleFeatureReader FeatureReader for SimpleFeature content.SimpleFeatureSource FeatureSource explicitly working with SimpleFeatureCollection.SimpleFeatureStore SimpleFeatureWriter FeatureWriter for updating SimpleFeature content.Transaction The controller for Transaction with FeatureStore.Transaction.State DataStore implementations can use this interface to externalize the state they require to implement Transaction Support. -
Class Summary Class Description BatchFeatureEvent Provide batch notification on Commit / Rollback.DataAccessFactory.Param Data class used to capture Parameter requirements.DataAccessFinder Enable programs to find all available DataAccess implementations, including the DataStore ones.DataStoreFinder Enable programs to find all available datastore implementations.FeatureEvent Represents all events triggered by DataStore instances (typically change events).FeatureLock Used in conjuction withFeatureLocking
to lock features during a transaction.FeatureLocking.Response Idea for a response from a high-level lock( Query ) function.FileDataStoreFinder Most of this code was copied from DataStoreFinder.FileGroupProvider.FileGroup A Group of Files consisting of a reference to a mainFile, plus a set of support Files (if any) and metadata map.Join Represents the joining of two feature types within aQuery
.Parameter<T> A Parameter defines information about a valid process parameter.Query Encapsulates a request for data, typically as:QueryCapabilities Describes the query capabilities for a specific FeatureType, so client code can request which features are natively supported by a FeatureSource. -
Enum Summary Enum Description FeatureEvent.Type Join.Type type of join -
Exception Summary Exception Description DataSourceException Thrown when there is an error in a datasource.FeatureLockException Indicates a lock contention, and attempt was made to modify or aquire with out Authroization.