org.gvsig.fmap.dal.coverage.util

Interface ProviderServices

All Known Implementing Classes:

DefaultProviderServices

public interface ProviderServices

Providers information and basic operations

Method Summary

Modifier and Type	Method and Description
void	addFormat(String ext, Class<?> c) Register a format and a provider which is capable to manage this format
RasterDataParameters	createNotTiledParameters(String id) Builds a RasterStoreParameters using a file name.
RasterDataParameters	createParameters(String id) Builds a RasterStoreParameters using a file name.
RasterDataParameters	createParametersForTiledFiled(String id) Builds a RasterStoreParameters for tiled files using a file name.
ArrayList<RasterDataParameters>	createParametersList(File file) Builds a RasterStoreParameters using a file.
ArrayList<RasterDataParameters>	createParametersList(String id) Builds a RasterStoreParameters using a file name.
void	exportBufferToFile(Buffer bufResult, double pixelSize, String extension, boolean alphaBand, File file, Extent extent, ColorInterpretation colorInterpretation) Saves a buffer to disk
String[]	getDriversExtensions() Obtiene la lista de extensiones registradas
ArrayList<String>	getExtensionsSupported(int dataType, int bands) Obtiene la lista de extensiones de ficheros sobre los que se puede salvar en un determinado tipo de datos.
String[]	getReadOnlyFormatList() Returns the list of supported formats in read only mode
String[]	getWriteDriversType() Obtiene la lista de tipos de driver
String	getWriteDriverType(String ext) Obtiene el tipo de driver a partir de la extensión
int	getWriteNDrivers() Devuelve el número de drivers soportados
int	getWriteNTypes() Devuelve el número de tipos de driver registrados
boolean	isExtensionSupported(String ext) Returns true if the extension is supported and false if doesn't
boolean	isExtensionSupported(String ext, Class<?> c) Returns true if the extension is supported and false if doesn't
boolean	isSupportedThisFileToWrite(String ext, int dataType, int bands) Método que pregunta si la extensión pasada por parámetro está soportada con el tipo y número de bandas indicadas.
RasterDataStore	open(CoverageStoreProvider prov, DataStoreParameters params)
RasterDataStore	open(DataStoreParameters param) Abre un dataset pasando como parámetros la proyección y un objeto identificador del dataset.
RasterDataStore	open(String file)
void	registerCRSUtilImplementation(CRSUtils crsUtil) Registers a implementation for the CRS service
void	registerFileProvidersTiled(Class<?> provider) Registers raster providers that support tiles.
void	registerOverviewBuilderImplementation(String id, OverviewBuilder ovBuilder) Registers a implementation to create overviews
void	registerTileProviderFormats(Class<?> c) Gets the list of raster providers that support tiles.
void	saveObjectToRmfFile(String file, Class<?> class1, Object value) Guarda en el fichero file (en formato RMF) el objecto value usando el serializador que trata las clases class1.
void	saveObjectToRmfFile(String file, Object value) The object passed by parameter is saved in the selected file (in RMF format) using the serializer.

Method Detail

open

RasterDataStore open(DataStoreParameters param)
              throws NotSupportedExtensionException,
                     RasterDriverException

Abre un dataset pasando como parámetros la proyección y un objeto identificador del dataset. Este objeto puede ser una ruta a un fichero en disco. En este caso la extensión del fichero servirá para buscar el driver que lo gestiona. Si proporcionamos un array de cadenas se tratarán como la ruta a N ficheros de disco. También puede ser un buffer de datos en memoria o cualquier otro objeto que pueda aceptar un driver.

Parameters:

param - Parámetros al driver

Returns:

RasterMultiDatset

Throws:

NotSupportedExtensionException

RasterDriverException

open

RasterDataStore open(String file)
              throws NotSupportedExtensionException,
                     RasterDriverException,
                     InitializeException,
                     ProviderNotRegisteredException

Throws:

NotSupportedExtensionException

RasterDriverException

InitializeException

ProviderNotRegisteredException

open

RasterDataStore open(CoverageStoreProvider prov,
                     DataStoreParameters params)
              throws NotSupportedExtensionException,
                     RasterDriverException

Throws:

NotSupportedExtensionException

RasterDriverException

registerFileProvidersTiled

void registerFileProvidersTiled(Class<?> provider)

Registers raster providers that support tiles. This method is only for providers. In a far future it will be in the SPI.

Parameters:

provider -

registerTileProviderFormats

void registerTileProviderFormats(Class<?> c)

Gets the list of raster providers that support tiles. This method is only for providers. In a far future it will be in the SPI.

registerOverviewBuilderImplementation

void registerOverviewBuilderImplementation(String id,
                                           OverviewBuilder ovBuilder)

Registers a implementation to create overviews

Parameters:

ovBuilder -

registerCRSUtilImplementation

void registerCRSUtilImplementation(CRSUtils crsUtil)

Registers a implementation for the CRS service

Parameters:

crsUtil -

addFormat

void addFormat(String ext,
               Class<?> c)

Register a format and a provider which is capable to manage this format

Parameters:

ext - Extension

c - Provider class

isExtensionSupported

boolean isExtensionSupported(String ext,
                             Class<?> c)

Returns true if the extension is supported and false if doesn't

Parameters:

ext -

Returns:

isExtensionSupported

boolean isExtensionSupported(String ext)

Returns true if the extension is supported and false if doesn't

Parameters:

ext -

Returns:

getReadOnlyFormatList

String[] getReadOnlyFormatList()

Returns the list of supported formats in read only mode

Returns:

getDriversExtensions

String[] getDriversExtensions()

Obtiene la lista de extensiones registradas

Returns:

Lista de extensiones registradas o null si no hay ninguna

getExtensionsSupported

ArrayList<String> getExtensionsSupported(int dataType,
                                         int bands)
                                  throws RasterDriverException

Obtiene la lista de extensiones de ficheros sobre los que se puede salvar en un determinado tipo de datos. Como parámetro de la función se especifica el tipo de datos sobre el que se desea consultar. Este método consulta para cada driver registrado que extensiones soportan un tipo.

Parameters:

dataType - Tipo de datos

bands - Numero de bandas

reprojectable - Especifica si devuelve solo los formatos reproyectables

Returns:

Lista de extensiones registradas que soportan el tipo de datos pasado por parámetro.

Throws:

RasterDriverException

getWriteDriversType

String[] getWriteDriversType()

Obtiene la lista de tipos de driver

Returns:

Lista de tipos de driver registradas o null si no hay ninguno

getWriteDriverType

String getWriteDriverType(String ext)

Obtiene el tipo de driver a partir de la extensión

Parameters:

ext - Extensión

Returns:

Tipo

getWriteNDrivers

int getWriteNDrivers()

Devuelve el número de drivers soportados

Returns:

Número de drivers soportados

getWriteNTypes

int getWriteNTypes()

Devuelve el número de tipos de driver registrados

Returns:

Número de tipos de driver soportados

isSupportedThisFileToWrite

boolean isSupportedThisFileToWrite(String ext,
                                   int dataType,
                                   int bands)

Método que pregunta si la extensión pasada por parámetro está soportada con el tipo y número de bandas indicadas.

Parameters:

dataType - Tipo de dato

bands - Número de bandas

extensión -

Returns:

true si está soportada y false si no lo está

saveObjectToRmfFile

void saveObjectToRmfFile(String file,
                         Class<?> class1,
                         Object value)
                  throws RmfSerializerException

Guarda en el fichero file (en formato RMF) el objecto value usando el serializador que trata las clases class1. Si el fichero RMF no existe se crea. Ha de ser un RMF de formato valido.

Parameters:

file -

class1 -

value -

Throws:

RmfSerializerException

saveObjectToRmfFile

void saveObjectToRmfFile(String file,
                         Object value)
                  throws RmfSerializerException

The object passed by parameter is saved in the selected file (in RMF format) using the serializer. If the RMF file does not exists it is created

Parameters:

file -

value -

Throws:

RmfSerializerException

createParameters

RasterDataParameters createParameters(String id)

Builds a RasterStoreParameters using a file name. It is only valid for files.

createNotTiledParameters

RasterDataParameters createNotTiledParameters(String id)
                                       throws InitializeException,
                                              ProviderNotRegisteredException

Builds a RasterStoreParameters using a file name. It is only valid for files but the provider will be not tiled

Throws:

ProviderNotRegisteredException

InitializeException

createParametersList

ArrayList<RasterDataParameters> createParametersList(String id)

Builds a RasterStoreParameters using a file name. If exists more than one provider which support this file this method will return a list of parameters It is only valid for files.

createParametersList

ArrayList<RasterDataParameters> createParametersList(File file)

Builds a RasterStoreParameters using a file. If exists more than one provider which support this file this method will return a list of parameters It is only valid for files.

createParametersForTiledFiled

RasterDataParameters createParametersForTiledFiled(String id)

Builds a RasterStoreParameters for tiled files using a file name.

exportBufferToFile

void exportBufferToFile(Buffer bufResult,
                        double pixelSize,
                        String extension,
                        boolean alphaBand,
                        File file,
                        Extent extent,
                        ColorInterpretation colorInterpretation)
                 throws NotSupportedExtensionException,
                        RasterDriverException,
                        ProcessInterruptedException,
                        IOException

Saves a buffer to disk

Parameters:

bufResult - Buffer to save

pixelSize - Pixel size

extension - output file format

alphaBand - true if it has alpha band

file - Path to the new file

extent - Bounding box of the buffer

Throws:

NotSupportedExtensionException

RasterDriverException

ProcessInterruptedException

IOException