org.gvsig.raster.wcs.io

Class WCSConnector

java.lang.Object

org.gvsig.raster.wcs.io.WCSConnector

public class WCSConnector
extends Object

Connector between a WCS data provider and a WCSClient.

Constructor Summary

Constructors

Constructor and Description
WCSConnector(URL url)

Method Summary

Modifier and Type	Method and Description
void	close() No close operation is needed since WCS service it is a non-session based protocol.
boolean	connect(boolean override, ICancellable cancel) Establishes the connection to the WCS server.
void	downloadFile(URL url, File dstFile, ICancellable cancel)
File	getCoverage(WCSStatus status, ICancellable cancel) Sends a GetCoverage request to the client.
String	getCoverageDescription(String coverageName) Returns a String containing a description of an specific coverage.
void	getCoverageURL(WCSStatus status, ICancellable cancel, File file) Sends a GetCoverage request to the client.
String	getDescription() Returns name and description of the server.
Rectangle2D	getFullExtent(String coverageName, String srs) Returns the coverage's MAX extent from the server.
int	getHeight(String coverageName) Gets the maximum height in pixels of this coverage
String	getLabel() Returns a human-readable string containing the server's name.
String	getLabel(String coverageName) Returns the label of an specific coverage given by the coverage name
WCSLayerNode	getLayer(String layerName) Returns the layer descriptor for a given coverage name.
WCSLayerNode[]	getLayerList() Returns an array of WCSLayer's with the descriptors of all coverages
Point2D	getMaxResolution(String coverageName) Returns the max resolution of a specific coverage given by the coverage's name.
String	getName() Returns the string "WCSDriver", which is the driver's name.
ArrayList	getSRSs(String coverageName) Returns an ArrayList containing a set of Strings with the coverage's SRSs.
ArrayList	getTimes(String coverageName) Returns an ArrayList containing strings for the time positions of an specific coverage given by the coverage's name.
String	getVersion() Returns a string containing the server's WCS version number.
int	getWidth(String coverageName) Gets the maximum width in pixels of this coverage
void	setHost(String host) Sets the server that we want to connect to.

Methods inherited from class java.lang.Object

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

Constructor Detail

WCSConnector

public WCSConnector(URL url)
             throws ConnectException,
                    IOException

Throws:

ConnectException

IOException

Method Detail

getName

public String getName()

Returns the string "WCSDriver", which is the driver's name.

Returns:

String

setHost

public void setHost(String host)
             throws IOException

Sets the server that we want to connect to.

Parameters:

host -

Throws:

IOException

getLabel

public String getLabel()

Returns a human-readable string containing the server's name.

Returns:

String

getVersion

public String getVersion()

Returns a string containing the server's WCS version number.

Returns:

String

getDescription

public String getDescription()

Returns name and description of the server. It is supposed to be used as the source of the abstract field in your application's interface.

Devuelve nombre y descripción (abstract) del servidor.

Returns:

String

getLayer

public WCSLayerNode getLayer(String layerName)

Returns the layer descriptor for a given coverage name.

Parameters:

layerName -

Returns:

WCSLayer

getLayerList

public WCSLayerNode[] getLayerList()

Returns an array of WCSLayer's with the descriptors of all coverages

Returns:

WCSLayer[]

connect

public boolean connect(boolean override,
                       ICancellable cancel)
                throws IOException

Establishes the connection to the WCS server. Connecting to a WCS is an abstraction.

Actually, it sends a GetCapabilities and a general DescribeCoverage request (not a coverage-specific DescribeCoverage request) to read the necessary data for building further GetCoverage requests.

Parameters:

override -

Throws:

IOException.

IOException

close

public void close()

No close operation is needed since WCS service it is a non-session based protocol. So, this does nothing and you can omit it.

getLabel

public String getLabel(String coverageName)

Returns the label of an specific coverage given by the coverage name

Parameters:

coverage - name (string)

Returns:

string

getFullExtent

public Rectangle2D getFullExtent(String coverageName,
                                 String srs)
                          throws IOException

Returns the coverage's MAX extent from the server.

Returns:

Rectangle2D

Throws:

IOException

getMaxResolution

public Point2D getMaxResolution(String coverageName)

Returns the max resolution of a specific coverage given by the coverage's name.

Parameters:

coverage - name (string)

Returns:

double

getWidth

public int getWidth(String coverageName)

Gets the maximum width in pixels of this coverage

Parameters:

coverageName -

Returns:

getHeight

public int getHeight(String coverageName)

Gets the maximum height in pixels of this coverage

Parameters:

coverageName -

Returns:

getSRSs

public ArrayList getSRSs(String coverageName)

Returns an ArrayList containing a set of Strings with the coverage's SRSs.

Parameters:

coverage - name (string)

Returns:

ArrayList

getCoverageDescription

public String getCoverageDescription(String coverageName)

Returns a String containing a description of an specific coverage.

Parameters:

coverage - name (string)

Returns:

string

getTimes

public ArrayList getTimes(String coverageName)

Returns an ArrayList containing strings for the time positions of an specific coverage given by the coverage's name.

Parameters:

coverage - name (string)

Returns:

ArrayList

getCoverage

public File getCoverage(WCSStatus status,
                        ICancellable cancel)
                 throws RemoteServiceException

Sends a GetCoverage request to the client.

Parameters:

status -

Returns:

Throws:

WCSException

RemoteServiceException

getCoverageURL

public void getCoverageURL(WCSStatus status,
                           ICancellable cancel,
                           File file)
                    throws RemoteServiceException

Sends a GetCoverage request to the client.

Parameters:

status -

Throws:

WCSException

RemoteServiceException

downloadFile

public void downloadFile(URL url,
                         File dstFile,
                         ICancellable cancel)
                  throws IOException

Throws:

IOException