Package org.geotools.data

Defines the DataStoreAPI via which all data is imported or exported.

See: Description

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 it
DataAccess<T extends FeatureType,F extends Feature>	This is the top-level interface for access to FeatureData.
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 of SimpleFeature.
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 extends FeatureSource, 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	FeatureReader customized for FeatureID handling.
FileDataStore	DataStore represents a single file of content.
FileDataStoreFactorySpi	DataAccessFactory for working with formats based on a single URL.
FileGroupProvider	A FileGroupProvider.FileGroup provider allowing to return a CloseableIterator of FileGroupProvider.FileGroups.
FileResourceInfo	Extends ResourceInfo with information about the file structure of the resource
FileServiceInfo	Extends ServiceInfo with information about the underlying file structure
GmlObjectStore	Interface providing lookup operations for gml objects.
InProcessLockingManager.Lock	Represents In-Process locks for Transactions or FeatureLocks.
LockingManager	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.
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.
CollectionFeatureReader	FeatureReader that reads features from a java.util.collection of features, an array of features or a FeatureCollection.
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.
DataTestCase	A set of constructs and utility methods used to test the data module.
DataUtilities	Utility functions for use with GeoTools with data classes.
DefaultCloseableIterator<T>	Default implementation of CloseableIterator
DefaultFeatureReader	Basic support for reading Features from an AttributeReader.
DefaultFeatureResults	Generic "results" of a query, class.
DefaultFIDReader	A Default FIDReader.
DefaultFileResourceInfo	Default implementation of FileResourceInfo.
DefaultFileServiceInfo	Default implementation of FileServiceInfo.
DefaultRepository	Default Repository implementation allows GeoTools to manage your DataStores.
DefaultResourceInfo	Default implementation of ResourceInfo; a simple java bean.
DefaultServiceInfo	Implementation of DefaultServiceInfo as a java bean.
DefaultTransaction	Quick implementation of Transaction api.
Diff	Captures changes made to a FeatureStore prior to being committed.
DiffFeatureReader<T extends FeatureType,F extends Feature>	A FeatureReader that considers differences.
DiffFeatureWriter	A FeatureWriter that captures modifications against a FeatureReader.
EmptyFeatureReader<T extends FeatureType,F extends Feature>	Represents an Empty, Typed, FeatureReader.
EmptyFeatureWriter	Represents an Empty, Typed, FeatureWriter.
FeatureEvent	Represents all events triggered by DataStore instances (typically change events).
FeatureListenerManager	This class is used by DataStore implementations to provide FeatureListener support for the FeatureSources they create.
FeatureLock	Used in conjuction with FeatureLocking to lock features during a transaction.
FeatureLocking.Response	Idea for a response from a high-level lock( Query ) function.
FIDFeatureReader	Experimental FeatureReader that always takes the first column of the attributeReader as the FeatureID.
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.
FilteringFeatureReader<T extends FeatureType,F extends Feature>	Basic support for a FeatureReader that does filtering.
FilteringFeatureWriter	Filtering is performed on this hasNext() method.
InProcessLockingManager	Provides In-Process FeatureLocking support for DataStore implementations.
Join	Represents the joining of two feature types within a Query.
JoiningAttributeReader	Attribute Reader that joins.
JoiningAttributeWriter	Provides ...
MapInfoFileReader	Reader for Mapinfo .TAB files Finds control points and CRS in .TAB file and parses them accordingly and builds a mathtransform and CRS
MaxFeatureReader<T extends FeatureType,F extends Feature>	Basic support for a FeatureReader that limits itself to the number of features passed in.
Parameter<T>	A Parameter defines information about a valid process parameter.
PrjFileReader
Query	Encapsulates a request for data, typically as: Query query = ...
QueryCapabilities	Describes the query capabilities for a specific FeatureType, so client code can request which features are natively supported by a FeatureSource.
ReTypeFeatureReader	Supports on the fly retyping of FeatureReader contents.
WorldFileReader	This class is responsible for parsing a world file in order to build an affine transform using the parameters provided in the file itself.
WorldFileWriter	This class is responsible for creating a world file from a MathTransform or AffineTransform.

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.
SchemaNotFoundException	Indicates a FeatureType could not be found.

Package org.geotools.data Description

Defines the DataStoreAPI 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();