org.geotools.data.wms.request
Class AbstractGetMapRequest

java.lang.Object
  extended byorg.geotools.data.wms.request.AbstractRequest
      extended byorg.geotools.data.wms.request.AbstractGetMapRequest
All Implemented Interfaces:
GetMapRequest, Request
Direct Known Subclasses:
WMS1_0_0.GetMapRequest

public abstract class AbstractGetMapRequest
extends AbstractRequest
implements GetMapRequest

Author:
Richard Gould TODO To change the template for this generated type comment go to Window - Preferences - Java - Code Style - Code Templates

Field Summary
 
Fields inherited from class org.geotools.data.wms.request.AbstractRequest
EXCEPTION_XML, onlineResource, properties
 
Fields inherited from interface org.geotools.data.wms.request.GetMapRequest
BBOX, BGCOLOR, ELEVATION, EXCEPTION_BLANK, EXCEPTION_INIMAGE, EXCEPTION_XML, EXCEPTIONS, FORMAT, HEIGHT, LAYERS, REMOTE_OWS_TYPE, REMOTE_OWS_WCS, REMOTE_OWS_WFS, REMOVE_OWS_URL, SLD, SLD_BODY, SRS, STYLES, TIME, TRANSPARENT, WFS, WIDTH
 
Fields inherited from interface org.geotools.data.wms.request.Request
REQUEST, SERVICE, VERSION, WMTVER
 
Constructor Summary
AbstractGetMapRequest(java.net.URL onlineResource, java.util.Properties properties)
          Constructs a GetMapRequest.
 
Method Summary
 void addLayer(Layer layer)
          Adds a Layer to the list of layers to be requested.
 void addLayer(Layer layer, java.lang.String style)
          Adds a Layer to the list of layers to be requested.
 void addLayer(Layer layer, org.opengis.layer.Style style)
          Adds a Layer to the list of layers to be requested.
 void addLayer(java.lang.String layerName, java.lang.String style)
          Adds a Layer to the list of layers to be requested.
 void addLayer(java.lang.String layerName, org.opengis.layer.Style style)
          Adds a Layer to the list of layers to be requested.
 java.net.URL getFinalURL()
          Once the properties of the request are configured, this will return the URL that points to the server and contains all of the appropriate name/value parameters.
protected  void initRequest()
           
protected abstract  void initVersion()
           
 void setBBox(CRSEnvelope box)
           
 void setBBox(java.lang.String bbox)
          From the Web Map Service Implementation Specification: "The required BBOX parameter allows a Client to request a particular Bounding Box.
 void setBGColour(java.lang.String bgColour)
          Specifies the colour, in hexidecimal format, to be used as the background of the map.
 void setDimensions(int width, int height)
           
 void setDimensions(java.lang.String width, java.lang.String height)
          From the Web Map Service Implementation Specification: "The required WIDTH and HEIGHT parameters specify the size in integer pixels of the map image to be produced.
 void setElevation(java.lang.String elevation)
          See the Web Map Server Implementation Specification 1.1.1, Annex C, in particular section C.4
 void setExceptions(java.lang.String exceptions)
          The exceptions type specifies what format the server should return exceptions in.
 void setFormat(java.lang.String format)
          From the Web Map Service Implementation Specification: "The required FORMAT parameter states the desired format of the response to an operation.
 void setProperties(java.util.Properties p)
          create a request using a properties file to save time
 void setSampleDimensionValue(java.lang.String name, java.lang.String value)
          See the Web Map Server Implementation Specification 1.1.1, Annex C, in particular section C.4.2 Example use: request.setSampleDimensionValue("DIM_WAVELENGTH", "4000");
 void setSRS(java.lang.String srs)
          From the Web Map Service Implementation Specification: "The required SRS parameter states which Spatial Reference System applies to the values in the BBOX parameter.
 void setTime(java.lang.String time)
          See the Web Map Server Implementation Specification 1.1.1, Annexes B and C
 void setTransparent(boolean transparent)
          From the Web Map Service Implementation Specification: "The optional TRANSPARENT parameter specifies whether the map background is to be made transparent or not.
 void setVendorSpecificParameter(java.lang.String name, java.lang.String value)
          Used to implement vendor specific parameters.
 void setVersion(java.lang.String version)
          Sets the version number of the request.
 
Methods inherited from class org.geotools.data.wms.request.AbstractRequest
getProperties, processKey, setProperty
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.geotools.data.wms.request.Request
getProperties, setProperty
 

Constructor Detail

AbstractGetMapRequest

public AbstractGetMapRequest(java.net.URL onlineResource,
                             java.util.Properties properties)
Constructs a GetMapRequest. The data passed in represents valid values that can be used.

Parameters:
onlineResource - the location that the request should be applied to
properties - pre-set properties to be used. Can be null.
Method Detail

getFinalURL

public java.net.URL getFinalURL()
Description copied from interface: Request
Once the properties of the request are configured, this will return the URL that points to the server and contains all of the appropriate name/value parameters.

Specified by:
getFinalURL in interface Request
Overrides:
getFinalURL in class AbstractRequest
See Also:
Request.getFinalURL()

initVersion

protected abstract void initVersion()

initRequest

protected void initRequest()

setVersion

public void setVersion(java.lang.String version)
Sets the version number of the request.

Specified by:
setVersion in interface GetMapRequest
Parameters:
version - A String indicting a WMS Version ("1.0.0", "1.1.0", "1.1.1", or "1.3.0")

addLayer

public void addLayer(Layer layer,
                     java.lang.String style)
Description copied from interface: GetMapRequest
Adds a Layer to the list of layers to be requested. This layer will be drawn below any previously added layers.

Specified by:
addLayer in interface GetMapRequest
Parameters:
layer - the Layer to use
style - the style to use to draw the layer, can also be NULL, "" or "default"

addLayer

public void addLayer(Layer layer)
Description copied from interface: GetMapRequest
Adds a Layer to the list of layers to be requested. This layer will be drawn below any previously added layers. The style will be the default one.

Specified by:
addLayer in interface GetMapRequest
Parameters:
layer - the Layer to use

addLayer

public void addLayer(java.lang.String layerName,
                     java.lang.String style)
Description copied from interface: GetMapRequest
Adds a Layer to the list of layers to be requested. This layer will be drawn below any previously added layers.

Specified by:
addLayer in interface GetMapRequest
Parameters:
layerName - the name of the layer to use
style - the style to use to draw the layer, can also be NULL, "" or "default"

addLayer

public void addLayer(Layer layer,
                     org.opengis.layer.Style style)
Description copied from interface: GetMapRequest
Adds a Layer to the list of layers to be requested. This layer will be drawn below any previously added layers.

Specified by:
addLayer in interface GetMapRequest
Parameters:
layer - the Layer to use
style - the style to use. If it is null, the default style is used.

addLayer

public void addLayer(java.lang.String layerName,
                     org.opengis.layer.Style style)
Description copied from interface: GetMapRequest
Adds a Layer to the list of layers to be requested. This layer will be drawn below any previously added layers.

Specified by:
addLayer in interface GetMapRequest
Parameters:
style - the style to use. If it is null, the default style is used.

setSRS

public void setSRS(java.lang.String srs)
From the Web Map Service Implementation Specification: "The required SRS parameter states which Spatial Reference System applies to the values in the BBOX parameter. The value of the SRS parameter shall be on of the values defined in the character data section of an <SRS> element defined or inherited by the requested layer. The same SRS applies to all layers in a single request. If the WMS has declared SRS=NONE for a Layer, then the Layer does not have a well-defined spatial reference system and should not be shown in conjunction with other layers. The client shall specify SRS as "none" in the GetMap request and the Server may issue a Service Exception otherwise."

Specified by:
setSRS in interface GetMapRequest
Parameters:
srs - A String indicating the Spatial Reference System to render the layers in.

setBBox

public void setBBox(java.lang.String bbox)
From the Web Map Service Implementation Specification: "The required BBOX parameter allows a Client to request a particular Bounding Box. The value of the BBOX parameter in a GetMap request is a list of comma-separated numbers of the form "minx,miny,maxx,maxy". If the WMS server has declared that a Layer is not subsettable, then the Client shall specify exactly the declared Bounding Box values in the GetMap request and the Server may issue a Service Exception otherwise."

Specified by:
setBBox in interface GetMapRequest
Parameters:
bbox - A string representing a bounding box in the format "minx,miny,maxx,maxy"

setBBox

public void setBBox(CRSEnvelope box)
Specified by:
setBBox in interface GetMapRequest

setFormat

public void setFormat(java.lang.String format)
From the Web Map Service Implementation Specification: "The required FORMAT parameter states the desired format of the response to an operation. Supported values for a GetMap request on a WMS instance are listed in one or more <Format> elements in the &;ltRequest><GetMap> element of its Capabilities XML. The entire MIME type string in <Format> is used as the value of the FORMAT parameter."

Specified by:
setFormat in interface GetMapRequest
Parameters:
format - The desired format for the GetMap response

setDimensions

public void setDimensions(java.lang.String width,
                          java.lang.String height)
From the Web Map Service Implementation Specification: "The required WIDTH and HEIGHT parameters specify the size in integer pixels of the map image to be produced. WIDTH specifies the number of pixels to be used between the minimum and maximum X values (inclusive) in the BBOX parameter, while HEIGHT specifies the number of pixels between the minimum and maximum Y values. If the WMS server has declared that a Layer has fixed width and height, then the Client shall specify exactly those WIDTH and HEIGHT values in the GetMap request and the Server may issue a Service Exception otherwise."

Specified by:
setDimensions in interface GetMapRequest
Parameters:
width -
height -

setTransparent

public void setTransparent(boolean transparent)
From the Web Map Service Implementation Specification: "The optional TRANSPARENT parameter specifies whether the map background is to be made transparent or not. The default value is false if the parameter is absent from the request."

Specified by:
setTransparent in interface GetMapRequest
Parameters:
transparent - true for transparency, false otherwise

setBGColour

public void setBGColour(java.lang.String bgColour)
Specifies the colour, in hexidecimal format, to be used as the background of the map. It is a String representing RGB values in hexidecimal format, prefixed by "0x". The format is: 0xRRGGBB. The default value is 0xFFFFFF (white)

Specified by:
setBGColour in interface GetMapRequest
Parameters:
bgColour - the background colour of the map, in the format 0xRRGGBB

setExceptions

public void setExceptions(java.lang.String exceptions)
The exceptions type specifies what format the server should return exceptions in.

Valid values are:

Specified by:
setExceptions in interface GetMapRequest
Parameters:
exceptions -

setTime

public void setTime(java.lang.String time)
See the Web Map Server Implementation Specification 1.1.1, Annexes B and C

Specified by:
setTime in interface GetMapRequest
Parameters:
time - See the Web Map Server Implementation Specification 1.1.1, Annexes B and C

setElevation

public void setElevation(java.lang.String elevation)
See the Web Map Server Implementation Specification 1.1.1, Annex C, in particular section C.4

Specified by:
setElevation in interface GetMapRequest
Parameters:
elevation - See the Web Map Server Implementation Specification 1.1.1, Annex C

setSampleDimensionValue

public void setSampleDimensionValue(java.lang.String name,
                                    java.lang.String value)
See the Web Map Server Implementation Specification 1.1.1, Annex C, in particular section C.4.2

Example use: request.setSampleDimensionValue("DIM_WAVELENGTH", "4000");

Specified by:
setSampleDimensionValue in interface GetMapRequest
Parameters:
name - the request parameter name to set (usually with 'dim_' as prefix)
value - the value of the request parameter (value, interval or comma-separated list)

setVendorSpecificParameter

public void setVendorSpecificParameter(java.lang.String name,
                                       java.lang.String value)
Used to implement vendor specific parameters. Entirely optional.

Specified by:
setVendorSpecificParameter in interface GetMapRequest
Parameters:
name - a request parameter name
value - a value to accompany the name

setDimensions

public void setDimensions(int width,
                          int height)
Specified by:
setDimensions in interface GetMapRequest

setProperties

public void setProperties(java.util.Properties p)
Description copied from interface: GetMapRequest
create a request using a properties file to save time

Specified by:
setProperties in interface GetMapRequest


Copyright © GeoTools. All Rights Reserved.