org.gvsig.raster.wmts.ogc.impl.base

Class WMTSProtocolHandler

java.lang.Object

org.gvsig.raster.wmts.ogc.impl.base.WMTSProtocolHandler

Direct Known Subclasses:

WMTSProtocolHandler1_0_0

public abstract class WMTSProtocolHandler
extends Object

Abstract class that represents handlers to comunicate via WMS protocol.

Field Summary

Fields

Modifier and Type	Field and Description
protected static Downloader	downloader
protected String	encoding Encoding used to parse different xml documents.
protected boolean	forceChangeAxisOrder
protected String	host
protected String	name
protected String	port
protected String	version

Constructor Summary

Constructors

Constructor and Description
WMTSProtocolHandler()

Method Summary

Modifier and Type	Method and Description
static String	buildCapabilitiesSuitableVersionRequest(String _host, String _version) Builds the GetCapabilitiesRequest according to the OGC WMS Specifications without a VERSION, to get the highest version than a WMS supports.
protected abstract WMTSGetCapabilitiesRequest	createGetCapabilitiesRequest()
protected abstract WMTSGetFeatureInfoRequest	createGetFeatureInfoRequest(WMTSStatusImpl status, int x, int y)
protected abstract WMTSGetTileRequest	createGetTileRequest(WMTSStatusImpl status)
File	downloadFile(URL url, ICancellable cancel, File forceFile)
protected byte[]	fileToBytes(File file) Copy the file in a byte array
String	getBaseURL(String operation) Gets the URL base for a operation (GetCapabilities, GetTile, ...)
String	getBaseURL(String operation, int protocol) Gets the URL base for a operation (GetCapabilities, GetTile, ...) and a protocol GET or POST
void	getCapabilities(WMTSServerDescription status, boolean override, ICancellable cancel) Builds a GetCapabilities request that is sent to the WMS the response will be parse to extract the data needed by the WMS client
String	getFeatureInfo(WMTSStatusImpl status, int x, int y, ICancellable cancel) It will send a GetFeatureInfo request to the WMTS Parsing the response and redirecting the info to the WMTS client TODO: return a stored file instead a String.
String	getHost()
File	getLegendGraphic(WMTSLayer layer, WMTSStyle style, ICancellable cancel)
String	getName()
String	getPort()
WMTSServerDescription	getServerDescription()
String	getSymbol(String h) Just for not repeat code.
File	getTile(String url, ICancellable cancel, File file)
File	getTile(WMTSStatus status, ICancellable cancel)
File	getTile(WMTSStatusImpl status, ICancellable cancel, File file)
URL	getTileURL(WMTSStatusImpl status)
String	getVersion()
abstract boolean	parseCapabilities(File f) parses the data retrieved by the Capabilities XML document
protected String	parseException(byte[] data)
void	setForceChangeAxisOrder(boolean force) Sets longitude first in the axis order read from the capabilities file
void	setHost(String host)
void	setName(String name)
void	setPort(String port)
void	setVersion(String version)

Methods inherited from class java.lang.Object

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

Field Detail

downloader

protected static final Downloader downloader

encoding

protected String encoding

Encoding used to parse different xml documents.

forceChangeAxisOrder

protected boolean forceChangeAxisOrder

name

protected String name

version

protected String version

host

protected String host

port

protected String port

Constructor Detail

WMTSProtocolHandler

public WMTSProtocolHandler()

Method Detail

createGetFeatureInfoRequest

protected abstract WMTSGetFeatureInfoRequest createGetFeatureInfoRequest(WMTSStatusImpl status,
                                                                         int x,
                                                                         int y)

createGetTileRequest

protected abstract WMTSGetTileRequest createGetTileRequest(WMTSStatusImpl status)

createGetCapabilitiesRequest

protected abstract WMTSGetCapabilitiesRequest createGetCapabilitiesRequest()

parseCapabilities

public abstract boolean parseCapabilities(File f)

parses the data retrieved by the Capabilities XML document

getServerDescription

public WMTSServerDescription getServerDescription()

getHost

public String getHost()

Returns:

Returns the host.

setHost

public void setHost(String host)

Parameters:

host - The host to set.

getName

public String getName()

Returns:

Returns the name.

setName

public void setName(String name)

Parameters:

name - The name to set.

getPort

public String getPort()

Returns:

Returns the port.

setPort

public void setPort(String port)

Parameters:

port - The port to set.

getVersion

public String getVersion()

Returns:

Returns the version.

setVersion

public void setVersion(String version)

Parameters:

version - The version to set.

getSymbol

public String getSymbol(String h)

Just for not repeat code. Gets the correct separator according to the server URL

Parameters:

h -

Returns:

fileToBytes

protected byte[] fileToBytes(File file)
                      throws IOException

Copy the file in a byte array

Parameters:

file - The file to copy

Returns:

An array of bytes

Throws:

IOException

setForceChangeAxisOrder

public void setForceChangeAxisOrder(boolean force)

Sets longitude first in the axis order read from the capabilities file

Parameters:

force -

getTile

public File getTile(WMTSStatusImpl status,
                    ICancellable cancel,
                    File file)
             throws ServerErrorException,
                    WMTSException

Throws:

ServerErrorException

WMTSException

getTile

public File getTile(WMTSStatus status,
                    ICancellable cancel)
             throws ServerErrorException,
                    WMTSException

Throws:

ServerErrorException

WMTSException

getTile

public File getTile(String url,
                    ICancellable cancel,
                    File file)
             throws ServerErrorException,
                    WMTSException

Throws:

ServerErrorException

WMTSException

getTileURL

public URL getTileURL(WMTSStatusImpl status)
               throws MalformedURLException

Throws:

MalformedURLException

getBaseURL

public String getBaseURL(String operation)

Gets the URL base for a operation (GetCapabilities, GetTile, ...)

Parameters:

operation -

Returns:

the base URL for the GET protocol or the host passed by the user if it does not exists.

getBaseURL

public String getBaseURL(String operation,
                         int protocol)

Gets the URL base for a operation (GetCapabilities, GetTile, ...) and a protocol GET or POST

Parameters:

operation -

Returns:

the base URL for this protocol or null if it does not exists.

downloadFile

public File downloadFile(URL url,
                         ICancellable cancel,
                         File forceFile)
                  throws DownloadException

Throws:

DownloadException

getLegendGraphic

public File getLegendGraphic(WMTSLayer layer,
                             WMTSStyle style,
                             ICancellable cancel)
                      throws ServerErrorException,
                             WMTSException,
                             DownloadException

Returns:

string that represents the url for getting the wms legend If the layer has the object layer-->style-->legendurl that url will be returned otherwise builds the getLegendGraphic according to the OGC WMS Specifications

Throws:

ServerErrorException

WMTSException

DownloadException

getFeatureInfo

public String getFeatureInfo(WMTSStatusImpl status,
                             int x,
                             int y,
                             ICancellable cancel)

It will send a GetFeatureInfo request to the WMTS Parsing the response and redirecting the info to the WMTS client

TODO: return a stored file instead a String.

getCapabilities

public void getCapabilities(WMTSServerDescription status,
                            boolean override,
                            ICancellable cancel)

Builds a GetCapabilities request that is sent to the WMS the response will be parse to extract the data needed by the WMS client

Parameters:

override, - if true the previous downloaded data will be overridden

buildCapabilitiesSuitableVersionRequest

public static String buildCapabilitiesSuitableVersionRequest(String _host,
                                                             String _version)

Builds the GetCapabilitiesRequest according to the OGC WMS Specifications without a VERSION, to get the highest version than a WMS supports.

parseException

protected String parseException(byte[] data)
                         throws IOException

Throws:

IOException