Table Of Contents

Previous topic

gxp.plugins.Tool

Next topic

gxp.plugins.WMSFilterView

gxp.plugins.WMSCSource

Extends
ptype
gxp_wmscsource
class gxp.plugins.WMSCSource(config)
Plugin for using WMS-C layers with gxp.Viewer instances. The plugin issues a GetCapabilities request to create a store of the WMS’s layers. If tilesets are available, it will use them.

Example Use

Configuration in the gxp.Viewer:

defaultSourceType: "gxp_wmscsource",
sources: {
    "opengeo": {
        url: "http://suite.opengeo.org/geoserver/wms"
    }
}

A typical configuration for a layer from this source (in the layers array of the viewer’s map config option would look like this:

{
    source: "opengeo",
    name: "world",
    group: "background"
}

Config Options

Configuration properties in addition to those listed for Ext.util.Observable.

baseParams
Object Base parameters to use on the WMS GetCapabilities request.
requiredProperties
Array(String) List of config properties that are required for each layer from this source to allow lazy loading. Default is ["title", "bbox"]. When the source loads layers from a WMS-C that does not use subsets of the default Web Mercator grid, not provide tiles for all default Web Mercator resolutions, and not use a tileSize of 256x256 pixels, tileOrigin, resolutions and tileSize should be included in this list.
url
String WMS service URL for this source
version
String Only WMS 1.1.1 is supported at the moment.

Public Properties

Public properties in addition to those listed for Ext.util.Observable.

WMSCSource.lazy
Boolean. true when the source is ready, but its store hasn’t been loaded yet (i.e. lazy source). Read-only.
WMSCSource.requiredProperties
Array(String) List of config properties that are required for a complete layer configuration, in addition to name.
WMSCSource.store
GeoExt.data.LayerStore
WMSCSource.title
String A descriptive title for this layer source.

Public Methods

Public methods in addition to those listed for Ext.util.Observable.

WMSCSource.createLayerRecord()
Parameter:configObject The application config for this layer.
Returns:GeoExt.data.LayerRecord or null when the source is lazy.

Create a layer record given the config. Applications should check that the source is not lazy` or that the config is complete (i.e. configured with all fields listed in requiredProperties before using this method. Otherwise, it is recommended to use the asynchronous gxp.Viewer.createLayerRecord() method on the target viewer instead, which will load the source’s store to complete the configuration if necessary.

WMSCSource.createStore()
Creates a store of layer records. Fires “ready” when store is loaded.
WMSCSource.describeLayer()
Parameters:
  • recGeoExt.data.LayerRecord the layer to issue a WMS DescribeLayer request for
  • callbackFunction Callback function. Will be called with an Ext.data.Record from a GeoExt.data.DescribeLayerStore as first argument, or false if the WMS does not support DescribeLayer.
  • scopeObject Optional scope for the callback.

Get a DescribeLayer response from this source’s WMS.

WMSCSource.getConfigForRecord()
Parameter:recordGeoExt.data.LayerRecord
Returns:Object

Create a config object that can be used to recreate the given record.

WMSCSource.getProjection()
Parameter:layerRecordGeoExt.data.LayerRecord a record from this source’s store
Returns:OpenLayers.Projection A suitable projection for the layerRecord. If the layer is available in the map projection, the map projection will be returned. Otherwise an equal projection, or null if none is available.

Get the projection that the source will use for the layer created in createLayerRecord. If the layer is not available in a projection that fits the map projection, null will be returned.

WMSCSource.getSchema()
Parameters:
  • recGeoExt.data.LayerRecord the WMS layer to issue a WFS DescribeFeatureType request for
  • callbackFunction Callback function. Will be called with a GeoExt.data.AttributeStore containing the schema as first argument, or false if the WMS does not support DescribeLayer or the layer is not associated with a WFS feature type.
  • scopeObject Optional scope for the callback.

Gets the schema for a layer of this source, if the layer is a feature layer.

WMSCSource.getState()
Returns:Object

Gets the configured source state.

WMSCSource.getWFSProtocol()
Parameters:
  • recordGeoExt.data.LayerRecord
  • callbackFunction
  • scopeObject
Returns:

OpenLayers.Protocol.WFS

Creates a WFS protocol for the given WMS layer record.

WMSCSource.init()
Parameter:targetObject The object initializing this plugin.

Events

Events in addition to those listed for Ext.util.Observable.

failure
Fires if the layer source fails to load.
ready
Fires when the layer source is ready for action.