org.gvsig.raster.wcs.io

Class WCSProvider

java.lang.Object

org.gvsig.tools.dispose.impl.AbstractDisposable

org.gvsig.fmap.dal.raster.spi.AbstractCoverageStoreProvider

org.gvsig.raster.impl.provider.AbstractRasterProvider

org.gvsig.raster.wcs.io.WCSProvider

All Implemented Interfaces:

Histogramable, DataFactoryUnit, DataStoreProvider, CoverageStoreProvider, RasterProvider, RemoteRasterProvider, Disposable, DynObject, DynObject_v2

public class WCSProvider
extends AbstractRasterProvider
implements RemoteRasterProvider

Clase que representa al driver de acceso a datos de wcs.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DESCRIPTION
static String	METADATA_DEFINITION_NAME
static String	NAME

Fields inherited from class org.gvsig.raster.impl.provider.AbstractRasterProvider

ALPHA_BAND, bandCount, BLUE_BAND, bytesReaded, colorTable, externalTransformation, fileSize, fileUtil, geoPointList, GREEN_BAND, histogram, lineCnt, noData, ownTransformation, param, proj, rasterUtil, RED_BAND, rmfBlocksManager, selectedSubdatasetID, serialInfo, stats, storeServices, tileServer, transparency, uri

Fields inherited from class org.gvsig.fmap.dal.raster.spi.AbstractCoverageStoreProvider

metadata, parameters, store

Constructor Summary

Constructors

Constructor and Description
WCSProvider()
WCSProvider(String params) Deprecated. use WCSProvider(URI), this constructor will be removed in gvSIG 2.5
WCSProvider(URI uri)
WCSProvider(WCSDataParametersImpl params, DataStoreProviderServices storeServices)

Method Summary

Modifier and Type	Method and Description
void	addFile(File file) Adds a new file.
void	close() Request to close de source
AffineTransform	getAffineTransform() Obtiene la transformación afin aplicada en las peticiones con coordenadas reales.
int	getBlockSize() When a WCS provider is opened the information of data type and number of bands is not available.
Buffer	getBuffer(BandList bandList, File lastFile, double ulx, double uly, double lrx, double lry) Assigns the list of bands RGB and read a window of data
Buffer	getBufferLastRequest() Gets the buffer of the last request.
ColorInterpretation	getColorInterpretation() Obtiene el objeto que contiene que contiene la interpretación de color por banda
WCSConnector	getConnector() Gets the connector from the URL
static WCSConnector	getConnectorFromURL(URL url)
Object	getData(int x, int y, int band) Obtiene el valor del raster en la coordenada que se le pasa.
Extent	getExtent() Calcula el extent en coordenadas del mundo real
File	getFileLayer() When the remote layer has fixed size this method downloads the file and return its reference.
String	getFileSuffix() Gets the suffix of the downloaded image
double	getHeight() Obtiene el ancho de la imagen
HistogramComputer	getHistogramComputer() Gets the object which computes the histogram
File	getLastRequest() Gets the file of the last request.
double	getLastRequestHeight()
double	getLastRequestWidth()
Rectangle2D	getLayerExtent(String layerName, String srs) Gets the bounding box of this layer
String	getName() Returns the name associated to the provider.
int	getOverviewCount(int band) Obtiene el número de overviews de una banda
int	getOverviewHeight(int band, int overview) Obtiene el alto de una overview de una banda
int	getOverviewWidth(int band, int overview) Obtiene el ancho de una overview de una banda
WCSDataParameters	getParameters() Gets WCS parameters
String	getProviderName() Return the name of the provider.
File	getRMFFile() Gets the rmf file path.
TileServer	getTileServer() Gets the tile cache data server
Transparency	getTransparency() Obtiene el estado de transparencia a partir de los estados de transparencia de todos los ficheros que lo componen.
Extent	getView() Obtiene el extent asignado
double	getWidth() Obtiene el ancho de la imagen
void	init(DataStoreParameters params, DataStoreProviderServices storeServices) Crea las referencias al fichero y carga las estructuras con la información y los metadatos.
boolean	isOpen() Returns true if this provider is open and false if don't
boolean	isOverviewsSupported() Informa de si el dataset soporta overviews o no.
boolean	isRasterEnclosed() Some services neither has limits nor pixel size.
boolean	isReproyectable() Devuelve si el Dataset es reproyectable
RasterProvider	load() Carga un fichero raster.
void	loadBuffer(SpiRasterQuery query) Load a buffer with the parameters.
boolean	needEnhanced() This function returns true if the image to be loaded needs a enhanced filter or doesn't.
Point2D	rasterToWorld(Point2D pt) Convierte un punto desde coordenadas pixel a coordenadas del mundo.
Object	readBlock(int pos, int blockHeight, double scale) Reads a complete block of data and returns an tridimensional array of the right type.
Object	readCompleteLine(int line, int band)
static void	register()
void	removeFile(File file) Removes a file.
void	setAffineTransform(AffineTransform t) Asigna una transformación al raster para que se tenga en cuenta en la asignación del setView.
void	setParam(DataStoreProviderServices storeServices, DataStoreParameters param) ASigna el parámetro de inicialización del driver.
void	setStatus(RasterProvider provider) Sets the status information using other provider of the same type.
void	setView(Extent e) Asigna un nuevo Extent
URI	translateURI(URI uri) Traduce el nombre del fichero por un alias asignado por el propio driver.
Point2D	worldToRaster(Point2D pt) Convierte un punto desde del mundo a coordenadas pixel.

Methods inherited from class org.gvsig.raster.impl.provider.AbstractRasterProvider

cloneProvider, deleteLayerFromCache, doDispose, finalize, getBandCount, getBandCountByProvider, getBandPositionByProvider, getCellSize, getChilds, getColorTable, getDataParameters, getDataSet, getDataType, getDefaultBandList, getExplorer, getExtentWithoutRot, getFileSize, getFileSizeByProvider, getFormatList, getFullName, getGeoPointList, getImageLegend, getInfoByPoint, getInfoByPoint, getInternalProvider, getInternalProviderCount, getInterval, getMetadata, getNoDataValue, getOwnAffineTransform, getPixelSizeX, getPixelSizeY, getProjection, getResource, getRmfBlocksManager, getRMFFileForRemoteServices, getSourceId, getSourceType, getStatistics, getSubdatasetCount, getTileSize, getTime, getTimes, getTimes, getTimeSerials, getURI, getURIByBand, getURIByProvider, getURIOfFirstProvider, getWktProjection, init, isARGB, isGeoreferenced, isInside, isMosaic, isMultiFile, isRGB, isRotated, isTiled, isTimeSupported, loadFromRmf, loadObjectFromRmf, loadObjectFromRmf, loadObjectFromRmfFile, newProvider, open, reload, resetAffineTransform, saveObjectToRmf, saveObjectToRmf, selectSubdataset, selectSubdataset, setColorInterpretation, setColorTable, setDataType, setFileSize, setFName, setGeoPointList, setNoDataValue, setProjection, setStatistics, setTileServer, setTimeSerials, singleDatasetInstance, translateFileName

Methods inherited from class org.gvsig.fmap.dal.raster.spi.AbstractCoverageStoreProvider

allowWrite, clear, createCoverageSelection, createResource, delegate, getClassName, getDataStoreParameters, getDynClass, getDynValue, getEnvelope, getStoreServices, hasDynMethod, hasDynValue, implement, init, invokeDynMethod, invokeDynMethod, refresh, setDynValue, setMetadata

Methods inherited from class org.gvsig.tools.dispose.impl.AbstractDisposable

dispose, dispose

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gvsig.raster.impl.provider.RasterProvider

cloneProvider, deleteLayerFromCache, getBandCount, getBandCountByProvider, getBandPositionByProvider, getCellSize, getColorTable, getDataParameters, getDataSet, getDataType, getExtentWithoutRot, getFileSizeByProvider, getFormatList, getGeoPointList, getImageLegend, getInfoByPoint, getInfoByPoint, getInternalProvider, getInternalProviderCount, getMetadata, getNoDataValue, getOwnAffineTransform, getPixelSizeX, getPixelSizeY, getProjection, getSourceType, getStatistics, getSubdatasetCount, getTimeSerials, getURI, getURIByBand, getURIByProvider, getURIOfFirstProvider, getWktProjection, isGeoreferenced, isInside, isMosaic, isMultiFile, isRotated, isTiled, isTimeSupported, loadObjectFromRmf, reload, saveObjectToRmf, selectSubdataset, setColorInterpretation, setColorTable, setGeoPointList, setNoDataValue, setProjection, setStatistics, setTimeSerials

Methods inherited from interface org.gvsig.fmap.dal.raster.spi.CoverageStoreProvider

allowWrite, getStoreServices

Methods inherited from interface org.gvsig.fmap.dal.spi.DataStoreProvider

getChilds, getExplorer, getFullName, getInterval, getResource, getSourceId, getTimes, getTimes, open, refresh

Methods inherited from interface org.gvsig.tools.dynobject.DynObject_v2

hasDynMethod

Methods inherited from interface org.gvsig.tools.dynobject.DynObject

clear, delegate, getDynClass, getDynValue, hasDynValue, implement, invokeDynMethod, invokeDynMethod, setDynValue

Methods inherited from interface org.gvsig.tools.dispose.Disposable

dispose

Field Detail

NAME

public static String NAME

DESCRIPTION

public static String DESCRIPTION

METADATA_DEFINITION_NAME

public static final String METADATA_DEFINITION_NAME

See Also:

Constant Field Values

Constructor Detail

WCSProvider

public WCSProvider()
            throws NotSupportedExtensionException

Throws:

NotSupportedExtensionException

WCSProvider

public WCSProvider(String params)
            throws InitializeException,
                   OpenException

Deprecated. use WCSProvider(URI), this constructor will be removed in gvSIG 2.5

Constructor. Abre el dataset.

Throws:

OpenException

NotSupportedExtensionException

InitializeException

WCSProvider

public WCSProvider(URI uri)
            throws InitializeException,
                   OpenException

Throws:

InitializeException

OpenException

WCSProvider

public WCSProvider(WCSDataParametersImpl params,
                   DataStoreProviderServices storeServices)
            throws InitializeException

Throws:

InitializeException

Method Detail

register

public static void register()

getConnector

public WCSConnector getConnector()
                          throws RemoteServiceException

Gets the connector from the URL

Returns:

Throws:

RemoteServiceException

init

public void init(DataStoreParameters params,
                 DataStoreProviderServices storeServices)
          throws InitializeException

Crea las referencias al fichero y carga las estructuras con la información y los metadatos.

Parameters:

proj - Proyección

param - Parametros de carga

Throws:

NotSupportedExtensionException

RasterDriverException

InitializeException

getConnectorFromURL

public static final WCSConnector getConnectorFromURL(URL url)
                                              throws IOException

Throws:

IOException

getColorInterpretation

public ColorInterpretation getColorInterpretation()

Obtiene el objeto que contiene que contiene la interpretación de color por banda

Specified by:

getColorInterpretation in interface RasterProvider

Overrides:

getColorInterpretation in class AbstractRasterProvider

Returns:

getParameters

public WCSDataParameters getParameters()

Gets WCS parameters

Returns:

getAffineTransform

public AffineTransform getAffineTransform()

Description copied from interface: RasterProvider

Obtiene la transformación afin aplicada en las peticiones con coordenadas reales. Esta corresponde al producto matricial entre la transformación de la propia georreferenciación del raster (ownTransformation) y la transformación que se le aplique de forma externa. Si esta última no existe será la matriz identidad.

Specified by:

getAffineTransform in interface RasterProvider

Overrides:

getAffineTransform in class AbstractRasterProvider

Returns:

Matriz de la transformación afín.

getExtent

public Extent getExtent()

Calcula el extent en coordenadas del mundo real

Specified by:

getExtent in interface RasterProvider

Overrides:

getExtent in class AbstractRasterProvider

Returns:

Extent

getLayerExtent

public Rectangle2D getLayerExtent(String layerName,
                                  String srs)
                           throws RemoteServiceException

Description copied from interface: RemoteRasterProvider

Gets the bounding box of this layer

Specified by:

getLayerExtent in interface RemoteRasterProvider

Returns:

Throws:

RemoteServiceException

load

public RasterProvider load()

Description copied from class: AbstractRasterProvider

Carga un fichero raster. Puede usarse para calcular el extent e instanciar un objeto de este tipo.

Specified by:

load in class AbstractRasterProvider

Returns:

RasterProvider

isOpen

public boolean isOpen()

Description copied from interface: RasterProvider

Returns true if this provider is open and false if don't

Specified by:

isOpen in interface RasterProvider

Returns:

close

public void close()

Description copied from interface: DataStoreProvider

Request to close de source

Specified by:

close in interface RasterProvider

Overrides:

close in class AbstractRasterProvider

getTransparency

public Transparency getTransparency()

Description copied from interface: RasterProvider

Obtiene el estado de transparencia a partir de los estados de transparencia de todos los ficheros que lo componen. Si varios de los ficheros que lo componen tienen banda de transparencia estas tendrán que ser mezcladas sobre una banda de transparencia única.

Specified by:

getTransparency in interface RasterProvider

Overrides:

getTransparency in class AbstractRasterProvider

Returns:

Objeto FileTransparency con el estado de transparencia

translateURI

public URI translateURI(URI uri)

Description copied from class: AbstractRasterProvider

Traduce el nombre del fichero por un alias asignado por el propio driver. Cuando es traducido por un alias el driver intentar� abrir el alias y no el fichero. Esto es util porque algunos formatos tienen la extensi�n en el fichero de cabecera pero lo que se abre realmente es el fichero de datos.

Overrides:

translateURI in class AbstractRasterProvider

Returns:

uri

setView

public void setView(Extent e)

Description copied from class: AbstractRasterProvider

Asigna un nuevo Extent

Specified by:

setView in class AbstractRasterProvider

Parameters:

e - Extent

getView

public Extent getView()

Description copied from class: AbstractRasterProvider

Obtiene el extent asignado

Specified by:

getView in interface RasterProvider

Specified by:

getView in class AbstractRasterProvider

Returns:

Extent

getWidth

public double getWidth()

Description copied from class: AbstractRasterProvider

Obtiene el ancho de la imagen

Specified by:

getWidth in interface RasterProvider

Specified by:

getWidth in class AbstractRasterProvider

Returns:

Ancho de la imagen

getHeight

public double getHeight()

Description copied from class: AbstractRasterProvider

Obtiene el ancho de la imagen

Specified by:

getHeight in interface RasterProvider

Specified by:

getHeight in class AbstractRasterProvider

Returns:

Ancho de la imagen

readCompleteLine

public Object readCompleteLine(int line,
                               int band)
                        throws InvalidSetViewException,
                               FileNotOpenException,
                               RasterDriverException

Throws:

InvalidSetViewException

FileNotOpenException

RasterDriverException

getFileLayer

public File getFileLayer()
                  throws RasterDriverException

When the remote layer has fixed size this method downloads the file and return its reference. File layer has in the long side FIXED_SIZE pixels and the bounding box is complete. This file could be useful to build an histogram or calculate statistics. This represents a sample of data.

Specified by:

getFileLayer in interface RemoteRasterProvider

Returns:

Throws:

RasterDriverException

readBlock

public Object readBlock(int pos,
                        int blockHeight,
                        double scale)
                 throws InvalidSetViewException,
                        FileNotOpenException,
                        RasterDriverException,
                        ProcessInterruptedException

Reads a complete block of data and returns an tridimensional array of the right type. This function is useful to read a file very fast without setting a view. In a WCS service when the size is fixed then it will read the entire image but when the source hasn't pixel size it will read a sample of data. This set of data will have the size defined in FIXED_SIZE.

Specified by:

readBlock in interface RasterProvider

Parameters:

pos - Posición donde se empieza a leer

blockHeight - Altura máxima del bloque leido

Returns:

Object que es un array tridimendional del tipo de datos del raster. (Bandas X Filas X Columnas)

Throws:

InvalidSetViewException

FileNotOpenException

RasterDriverException

ProcessInterruptedException

getLastRequestHeight

public double getLastRequestHeight()
                            throws RasterDriverException

Throws:

RasterDriverException

getLastRequestWidth

public double getLastRequestWidth()
                           throws RasterDriverException

Throws:

RasterDriverException

getLastRequest

public File getLastRequest()

Description copied from interface: RemoteRasterProvider

Gets the file of the last request. Be careful because if a complete request is tiled, this file will only contain the last tile.

Specified by:

getLastRequest in interface RemoteRasterProvider

Returns:

getBufferLastRequest

public Buffer getBufferLastRequest()
                            throws ProcessInterruptedException,
                                   RasterDriverException

Description copied from interface: RemoteRasterProvider

Gets the buffer of the last request. Be careful because if a complete request is tiled, this file will only contain the last tile.

Specified by:

getBufferLastRequest in interface RemoteRasterProvider

Returns:

Throws:

ProcessInterruptedException

RasterDriverException

getData

public Object getData(int x,
                      int y,
                      int band)
               throws InvalidSetViewException,
                      FileNotOpenException,
                      RasterDriverException

Description copied from class: AbstractRasterProvider

Obtiene el valor del raster en la coordenada que se le pasa. El valor será Double, Int, Byte, etc. dependiendo del tipo de raster.

Specified by:

getData in interface RasterProvider

Specified by:

getData in class AbstractRasterProvider

Parameters:

x - coordenada X

y - coordenada Y

Returns:

data

Throws:

InvalidSetViewException

FileNotOpenException

RasterDriverException

needEnhanced

public boolean needEnhanced()

Description copied from interface: RasterProvider

This function returns true if the image to be loaded needs a enhanced filter or doesn't. It depends on the format, number of bands, type of data and so on.

Specified by:

needEnhanced in interface RasterProvider

Overrides:

needEnhanced in class AbstractRasterProvider

Returns:

The default value is false but each driver can change this value.

getBuffer

public Buffer getBuffer(BandList bandList,
                        File lastFile,
                        double ulx,
                        double uly,
                        double lrx,
                        double lry)
                 throws RasterDriverException,
                        ProcessInterruptedException

Assigns the list of bands RGB and read a window of data

Parameters:

rasterBuf -

bandList -

lastFile -

ulx -

uly -

lrx -

lry -

Returns:

Throws:

RasterDriverException

ProcessInterruptedException

loadBuffer

public void loadBuffer(SpiRasterQuery query)
                throws ProcessInterruptedException,
                       RasterDriverException

Description copied from class: AbstractRasterProvider

Load a buffer with the parameters. The buffer should already have been created inside the query structure SpiRasterQuery by the RasterDataStore. The other parameters have been calculated too, all of them adjusted to the raster limits. The provider only have to read the parameters and load the buffer.

Specified by:

loadBuffer in class AbstractRasterProvider

Throws:

ProcessInterruptedException

RasterDriverException

getBlockSize

public int getBlockSize()

When a WCS provider is opened the information of data type and number of bands is not available. Only after the first time a raster has been downloaded it can be know.

Specified by:

getBlockSize in class AbstractRasterProvider

Parameters:

newDataType -

buf -

bandList -

Returns:

setAffineTransform

public void setAffineTransform(AffineTransform t)

Description copied from interface: RasterProvider

Asigna una transformación al raster para que se tenga en cuenta en la asignación del setView. Esta asignación recalcula el extent, el requestExtent y asigna el AffineTransform que se usará para la transformación. Esta transformación será considerada como si la imagen tuviera asociado un rmf.

Specified by:

setAffineTransform in interface RasterProvider

Overrides:

setAffineTransform in class AbstractRasterProvider

Parameters:

t - Transformación afín a aplicar

getOverviewCount

public int getOverviewCount(int band)
                     throws BandAccessException,
                            RasterDriverException

Description copied from interface: RasterProvider

Obtiene el número de overviews de una banda

Specified by:

getOverviewCount in interface RasterProvider

Returns:

Throws:

BandAccessException

RasterDriverException

getOverviewWidth

public int getOverviewWidth(int band,
                            int overview)
                     throws BandAccessException,
                            RasterDriverException

Description copied from interface: RasterProvider

Obtiene el ancho de una overview de una banda

Specified by:

getOverviewWidth in interface RasterProvider

Specified by:

getOverviewWidth in class AbstractRasterProvider

Returns:

Throws:

BandAccessException

RasterDriverException

getOverviewHeight

public int getOverviewHeight(int band,
                             int overview)
                      throws BandAccessException,
                             RasterDriverException

Description copied from interface: RasterProvider

Obtiene el alto de una overview de una banda

Specified by:

getOverviewHeight in interface RasterProvider

Specified by:

getOverviewHeight in class AbstractRasterProvider

Returns:

Throws:

BandAccessException

RasterDriverException

isOverviewsSupported

public boolean isOverviewsSupported()

Description copied from class: AbstractRasterProvider

Informa de si el dataset soporta overviews o no.

Specified by:

isOverviewsSupported in interface RasterProvider

Specified by:

isOverviewsSupported in class AbstractRasterProvider

Returns:

true si soporta overviews y false si no las soporta.

isReproyectable

public boolean isReproyectable()

Description copied from class: AbstractRasterProvider

Devuelve si el Dataset es reproyectable

Specified by:

isReproyectable in interface RasterProvider

Overrides:

isReproyectable in class AbstractRasterProvider

Returns:

true if Dataset is reproyectable

getProviderName

public String getProviderName()

Description copied from interface: DataStoreProvider

Return the name of the provider. Examples: dbf, shp, jdbc, postgresql, wfs, gml

Specified by:

getProviderName in interface CoverageStoreProvider

Returns:

getName

public String getName()

Description copied from interface: DataStoreProvider

Returns the name associated to the provider. This name is provided for informational purposes only. Explamples: In a dbf the filename without the path In a DDBB table the name of the table In a WFS layer the name of the layer.

Overrides:

getName in class AbstractRasterProvider

Returns:

String containing this store's name.

rasterToWorld

public Point2D rasterToWorld(Point2D pt)

Convierte un punto desde coordenadas pixel a coordenadas del mundo.

Specified by:

rasterToWorld in interface RasterProvider

Overrides:

rasterToWorld in class AbstractRasterProvider

Parameters:

pt - Punto a transformar

Returns:

punto transformado en coordenadas del mundo

worldToRaster

public Point2D worldToRaster(Point2D pt)

Convierte un punto desde del mundo a coordenadas pixel.

Specified by:

worldToRaster in interface RasterProvider

Overrides:

worldToRaster in class AbstractRasterProvider

Parameters:

pt - Punto a transformar

Returns:

punto transformado en coordenadas pixel

setStatus

public void setStatus(RasterProvider provider)

Description copied from interface: RasterProvider

Sets the status information using other provider of the same type. The first action of this method should be to check the type of the parameter.

Specified by:

setStatus in interface RasterProvider

setParam

public void setParam(DataStoreProviderServices storeServices,
                     DataStoreParameters param)

ASigna el parámetro de inicialización del driver.

Overrides:

setParam in class AbstractRasterProvider

getFileSuffix

public String getFileSuffix()

Gets the suffix of the downloaded image

Specified by:

getFileSuffix in interface RasterProvider

Overrides:

getFileSuffix in class AbstractRasterProvider

Returns:

getTileServer

public TileServer getTileServer()

Description copied from interface: RasterProvider

Gets the tile cache data server

Specified by:

getTileServer in interface RasterProvider

Returns:

isRasterEnclosed

public boolean isRasterEnclosed()

Description copied from interface: RasterProvider

Some services neither has limits nor pixel size. For instance, WebMapService is a service of this type if the size is not fixed. Other services, like WMTS are enclosed too but in this case it will have resolution by level. This method returns true if the data source is enclosed.

Specified by:

isRasterEnclosed in interface RasterProvider

Overrides:

isRasterEnclosed in class AbstractRasterProvider

Returns:

getRMFFile

public File getRMFFile()

Description copied from interface: RasterProvider

Gets the rmf file path. This method will have to be redefined by providers with a different path

Specified by:

getRMFFile in interface RasterProvider

Overrides:

getRMFFile in class AbstractRasterProvider

Returns:

getHistogramComputer

public HistogramComputer getHistogramComputer()

Description copied from interface: Histogramable

Gets the object which computes the histogram

Specified by:

getHistogramComputer in interface Histogramable

Overrides:

getHistogramComputer in class AbstractRasterProvider

Returns:

Histograma

addFile

public void addFile(File file)
             throws InvalidSourceException

Description copied from interface: RasterProvider

Adds a new file. The behavior of this function depends on the kind of provider and its implementation.

Specified by:

addFile in interface RasterProvider

Throws:

InvalidSourceException

removeFile

public void removeFile(File file)

Description copied from interface: RasterProvider

Removes a file. The behavior of this function depends on the kind of provider and its implementation.

Specified by:

removeFile in interface RasterProvider