# Package org.apache.sis.storage

package org.apache.sis.storage
Data store base types for retrieving and saving geospatial data in various storage formats.

`DataStore` provides the methods for reading or writing geospatial data in a given storage. A storage may be a file, a directory, a connection to a database or any other implementation specific mechanism. Suitable `DataStore` implementation for a given storage can be discovered and opened by the static methods provided in `DataStores`.

Since:
  0.3

- Related Packages
  Module
  Package
  Description
  org.apache.sis.storage
  org.apache.sis.storage.aggregate
  Resources which are aggregations or concatenations of other resources.
  org.apache.sis.storage
  org.apache.sis.storage.event
  Provides interfaces and classes for dealing with different types of events fired by resources.
  org.apache.sis.storage.geotiff
  org.apache.sis.storage.geotiff
  A data store that can read and write GeoTIFF files as grid coverages.
  org.apache.sis.storage.xml
  org.apache.sis.storage.gps
  Structures related to Global Positioning System (GPS).
  org.apache.sis.storage.earthobservation
  org.apache.sis.storage.landsat
  Reader of Landsat 8 level 1-2 data.
  org.apache.sis.storage
  org.apache.sis.storage.modifier
  A plugin mechanism for modifying some aspects of the resources read by data stores.
  org.apache.sis.storage.netcdf
  org.apache.sis.storage.netcdf
  Reads netCDF files conforming to the Climate and Forecast (CF).
  org.apache.sis.storage.sql
  org.apache.sis.storage.sql
  Data store capable to read and write features using a JDBC connection to a database.
  org.apache.sis.storage
  org.apache.sis.storage.tiling
  Base types for retrieving and saving tiles in resources.
- Class
  Description
  AbstractFeatureSet
  Default implementations of several methods for classes that want to implement the `FeatureSet` interface.
  AbstractGridCoverageResource
  Default implementations of several methods for classes that want to implement the `GridCoverageResource` interface.
  AbstractResource
  Default implementations of several methods for classes that want to implement the `Resource` interface.
  Aggregate
  A collection of resources.
  CanNotProbeException
  Thrown when an unrecoverable error occurred during the probing of a file.
  ConcurrentReadException
  Thrown when an operation cannot be performed while a read operation is in progress.
  ConcurrentWriteException
  Thrown when an operation cannot be performed while a write operation is in progress.
  CoverageQuery
  Definition of filtering to apply for fetching a subset of `GridCoverageResource`.
  DataOptionKey<T>
  Keys in a map of options for configuring the way data are read or written to a storage.
  DataSet
  Collection of features that share a common set of attributes or properties.
  DataStore
  Manages a series of features, coverages or sensor data.
  DataStoreClosedException
  Thrown when a data store is closed and can no more return data.
  DataStoreContentException
  Thrown when a store cannot be read because the stream or database contains invalid data.
  DataStoreException
  Thrown when a `DataStore` cannot complete a read or write operation.
  DataStoreProvider
  Provides information about a specific `DataStore` implementation.
  DataStoreProvider.Prober<S>
  An action to execute for testing if a `StorageConnector` input can be read.
  DataStoreReferencingException
  Thrown when a data store failed to construct the coordinate reference system (CRS) or other positioning information.
  DataStores
  Static convenience methods creating `DataStore` instances from a given storage object.
  FeatureNaming<E>
  Helper class for mapping `GenericName` instances and their shortened names to features.
  FeatureQuery
  Definition of filtering to apply for fetching a subset of `FeatureSet`.
  FeatureQuery.NamedExpression
  An expression to be retrieved by a `Query`, together with the name to assign to it.
  FeatureQuery.ProjectionType
  Whether a property evaluated by a query is computed on the fly or stored.
  FeatureSet
  A dataset providing access to a stream of features.
  ForwardOnlyStorageException
  Thrown when an operation would require to move the cursor back, but the underlying storage does not allow that.
  GridCoverageResource
  Access to data values in a n-dimensional grid.
  IllegalFeatureTypeException
  Thrown when a store cannot write the given feature because its type is not one of the supported types.
  IllegalNameException
  Thrown when an invalid name is used for identifying a coverage, a feature or other kind of element in a data store.
  IllegalOpenParameterException
  Thrown when a `DataStore` cannot be opened because of invalid parameters.
  IncompatibleResourceException
  Thrown when a write operation cannot be performed because the resource to write is incompatible with the data store.
  InternalDataStoreException
  Thrown when an internal error occurred in a `DataStore` implementation.
  NoSuchDataException
  Thrown when requested data are not found in the data store.
  ProbeResult
  Tells whether a storage (file, database) appears to be supported by a `DataStore`.
  Query
  Definition of filtering to apply for fetching a resource subset.
  RasterLoadingStrategy
  Time when the "physical" loading of raster data should happen.
  ReadOnlyStorageException
  Thrown when a `DataStore` cannot perform a write operation.
  Resource
  Provides access to geospatial data in a `DataStore`.
  Resource.FileSet
  Paths to the files potentially used by the enclosing resource.
  ResourceAlreadyExistsException
  Thrown when a write operation cannot be performed because it would cause the replacement of an existing resource.
  StorageConnector
  Information for creating a connection to a `DataStore` in read and/or write mode.
  UnsupportedEncodingException
  Thrown when a storage uses some encoding options not supported by current implementation.
  UnsupportedQueryException
  Thrown when a resources cannot be filtered with a given query.
  UnsupportedStorageException
  Thrown when no `DataStoreProvider` is found for a given storage object.
  WritableAggregate
  An `Aggregate` with writing capabilities.
  WritableFeatureSet
  A `FeatureSet` with writing capabilities.
  WritableGridCoverageResource
  A `GridCoverageResource` with writing capabilities.
  WritableGridCoverageResource.CommonOption
  Write options that may apply to any data store.
  WritableGridCoverageResource.Option
  Configuration of the process of writing a coverage in a data store.
  WriteOnlyStorageException
  Thrown when a `DataStore` cannot perform a read operation.