Class GDALStoreProvider

Object

DataStoreProvider

GDALStoreProvider

public class GDALStoreProvider
extends DataStoreProvider

The provider of GDALStore instances. Given a Storage­Connector input, this class tries to instantiate a GDALStore. This data store uses the GDAL native library for loading data.

Each GDALStore­Provider instance is linked to a GDAL library specified at construction time, or to a JVM-wide shared GDAL library if the no-argument constructor is used. In the non-shared case, GDAL will be unloaded when this GDALStore­Provider instance is garbage collected.

Since:

1.5

Nested Class Summary

Nested classes/interfaces inherited from class DataStoreProvider

Data­Store­Provider.Prober<S>

Field Summary

Fields

Modifier and Type	Field	Description
static final Option­Key<String[]>	DRIVERS_OPTION_KEY	Key for declaring GDAL drivers that may be used for opening the file.

Fields inherited from class DataStoreProvider

CREATE, LOCATION

Constructor Summary

Constructors

Constructor	Description
GDALStore­Provider()	Creates a new provider which will load the GDAL library from the default library path.
GDALStore­Provider(Path library)	Creates a new provider which will load the GDAL library from the specified file.

Method Summary

Modifier and Type	Method	Description
Tree­Table	configuration()	Returns the GDAL version number together with the list of drivers.
List<Driver>	get­Drivers()	Returns an unmodifiable list of all GDAL drivers currently available.
Logger	get­Logger()	Returns the logger used by GDAL stores.
Parameter­Descriptor­Group	get­Open­Parameters()	Returns a description of all parameters accepted by this provider for opening a file with GDAL.
Optional<Local­Date>	get­Release­Date()	Returns the release date of the GDAL library.
String	get­Short­Name()	Returns a generic name for this data store, used mostly in warnings or error messages.
Optional<Version>	get­Version()	Returns the version number of the GDAL library.
Data­Store	open(Storage­Connector connector)	Creates a GDALStore instance associated with this provider.
Data­Store	open(Parameter­Value­Group parameters)	Creates a GDALStore instance from the given parameters.
Probe­Result	probe­Content(Storage­Connector connector)	Returns the MIME type if the given storage appears to be supported by this data store.

Methods inherited from class DataStoreProvider

get­Format, get­Supported­Versions, probe­Content

Methods inherited from class Object

clone, equals, finalize, get­Class, hash­Code, notify, notify­All, to­String, wait, wait, wait

Field Details

DRIVERS_OPTION_KEY

public static final OptionKey<String[]> DRIVERS_OPTION_KEY

Key for declaring GDAL drivers that may be used for opening the file. Drivers are identified by their short names. The drivers will be tested in the order they are specified.

See Also:

• Driver.get­Identifier()

Constructor Details

GDALStoreProvider

public GDALStoreProvider()

Creates a new provider which will load the GDAL library from the default library path.

GDALStoreProvider

public GDALStoreProvider(Path library)

Creates a new provider which will load the GDAL library from the specified file. The library will be unloaded when this provider will be garbage-collected.

Parameters:

library - path to the library to load.

Throws:

Illegal­Argument­Exception - if the GDAL library has not been found.

No­Such­Element­Exception - if a GDAL function has not been found in the library.

Illegal­Caller­Exception - if this Apache SIS module is not authorized to call native methods.

Method Details

getShortName

public String getShortName()

Returns a generic name for this data store, used mostly in warnings or error messages.

Specified by:

get­Short­Name in class Data­Store­Provider

Returns:

a short name or abbreviation for the data store.

See Also:

• Data­Store­Provider.get­Format()

getVersion

public Optional<Version> getVersion()

Returns the version number of the GDAL library. The returned version contains 4 components. Example: 3.6.3.0.

Returns:

GDAL version, or empty if the GDAL library has not been found.

getReleaseDate

public Optional<LocalDate> getReleaseDate()

Returns the release date of the GDAL library.

Returns:

the release date, or empty if the GDAL library has not been found.

getDrivers

public List<Driver> getDrivers()

Returns an unmodifiable list of all GDAL drivers currently available.

Returns:

all GDAL drivers, or an empty list if the GDAL library has not been found.

configuration

public TreeTable configuration()
                        throws DataStoreException

Returns the GDAL version number together with the list of drivers. The GDAL version is in the root node, and drivers are listed as children. The table contains the following columns:

1. invalid reference

   Table­Column#NAME

   for the value returned by
   invalid reference

   #get­Name()

   .
2. invalid reference

   Table­Column#IDENTIFIER

   for the value returned by
   invalid reference

   #get­Identifier()

   .

The current version lists only the drivers having raster capability, because this is the only type of data supported by the current implementation of this module.

Returns:

a table of available GDAL drivers.

Throws:

Data­Store­Exception - if an error occurred while querying GDAL metadata.

getOpenParameters

public ParameterDescriptorGroup getOpenParameters()

Returns a description of all parameters accepted by this provider for opening a file with GDAL.

Specified by:

get­Open­Parameters in class Data­Store­Provider

Returns:

description of available parameters for opening a file with GDAL.

See Also:

• Data­Store­Provider.LOCATION
• Data­Store­Provider.CREATE
• Data­Store­Provider.open(Parameter­Value­Group)
• Data­Store.get­Open­Parameters()

probeContent

public ProbeResult probeContent(StorageConnector connector)
                         throws DataStoreException

Returns the MIME type if the given storage appears to be supported by this data store. A supported status does not guarantee that reading or writing will succeed, only that there appears to be a reasonable chance according GDAL.

Specified by:

probe­Content in class Data­Store­Provider

Parameters:

connector - information about the storage (URL, stream, etc).

Returns:

a supported status with the MIME type if the given storage seems to be readable by GDALStore instances.

Throws:

Data­Store­Exception - if an I/O error occurred.

open

public DataStore open(StorageConnector connector)
               throws DataStoreException

Creates a GDALStore instance associated with this provider.

Specified by:

open in class Data­Store­Provider

Parameters:

connector - information about the storage (URL, stream, etc).

Returns:

a data store implementation associated with this provider for the given storage.

Throws:

Data­Store­Exception - if an error occurred while creating the data store instance.

See Also:

• Data­Stores.open(Object)

open

public DataStore open(ParameterValueGroup parameters)
               throws DataStoreException

Creates a GDALStore instance from the given parameters.

Overrides:

open in class Data­Store­Provider

Parameters:

parameters - opening parameters as defined by get­Open­Parameters().

Returns:

a data store instance associated with this provider for the given parameters.

Throws:

Data­Store­Exception - if an error occurred while creating the data store instance.

See Also:

• Data­Store­Provider.LOCATION
• Data­Store­Provider.CREATE
• Data­Store­Provider.get­Open­Parameters()

getLogger

public Logger getLogger()

Returns the logger used by GDAL stores.

Overrides:

get­Logger in class Data­Store­Provider

Returns:

the logger to use as a fallback (when there are no listeners) for warning messages.

See Also:

• Store­Listeners.get­Logger()