org.apache.sis.storage.netcdf

Class NetcdfStoreProvider

Object

DataStoreProvider

NetcdfStoreProvider

public class NetcdfStoreProvider
extends DataStoreProvider

The provider of NetcdfStore instances. Given a StorageConnector input, this class tries to instantiate a NetcdfStore using the embedded NetCDF decoder. If the embedded decoder can not decode the given input and the UCAR library is reachable on the classpath, then this class tries to instantiate a NetcdfStore backed by the UCAR library.

Thread safety

The same NetcdfStoreProvider instance can be safely used by many threads without synchronization on the part of the caller. However the NetcdfStore instances created by this factory are not thread-safe.

Since:

0.3

See Also:

NetcdfStore

Defined in the sis-netcdf module

Constructor Summary

Constructors

Constructor and Description
NetcdfStoreProvider() Creates a new provider.

Method Summary

Methods

Modifier and Type	Method and Description
DataStore	open(StorageConnector storage) Returns a NetcdfStore implementation associated with this provider.
ProbeResult	probeContent(StorageConnector storage) Returns ProbeResult.SUPPORTED if the given storage appears to be supported by NetcdfStore.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NetcdfStoreProvider

public NetcdfStoreProvider()

Creates a new provider.

Method Detail

probeContent

public ProbeResult probeContent(StorageConnector storage)
                         throws DataStoreException

Returns ProbeResult.SUPPORTED if the given storage appears to be supported by NetcdfStore. Returning SUPPORTED from this method does not guarantee that reading or writing will succeed, only that there appears to be a reasonable chance of success based on a brief inspection of the storage object or contents.

Specified by:

probeContent in class DataStoreProvider

Parameters:

storage - Information about the storage (URL, stream, NetcdfFile instance, etc).

Returns:

SUPPORTED if the given storage seems to be usable by the NetcdfStore instances.

Throws:

DataStoreException - if an I/O error occurred.

open

public DataStore open(StorageConnector storage)
               throws DataStoreException

Returns a NetcdfStore implementation associated with this provider.

Specified by:

open in class DataStoreProvider

Parameters:

storage - Information about the storage (URL, stream, NetcdfFile instance, etc).

Returns:

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

Throws:

DataStoreException - If an error occurred while creating the data store instance.