com.supermap.services.components.spi.ogc

类 WMSClient

java.lang.Object

com.supermap.services.components.spi.ogc.WMSClient

所有已实现的接口:

WMS

public class WMSClient
extends java.lang.Object
implements WMS

WMS 1.1.1及1.1.3 版本客户端实现类。

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	URL_CHARSET URL 编码时使用的字符集。

构造器概要

构造器

构造器和说明
WMSClient(java.lang.String url, java.lang.String userName, java.lang.String password) 构造函数。
WMSClient(java.lang.String url, java.lang.String userName, java.lang.String password, java.util.List<java.lang.String> srsNames)

方法概要

方法

限定符和类型	方法和说明
java.lang.String[]	checkExceptionNode(org.w3c.dom.Node exceptionNode)
WMSCapabilities	getCapabilities(java.lang.String version) 获取 WMS 服务级元数据。
WMSFeatureInfo[]	getFeatureInfo(java.lang.String version, WMSQueryParameter wmsQueryParam) 获取地物要素信息。
java.util.Map<Layer,QueryResult>	getFeatureInfoMap(java.lang.String version, WMSQueryParameter wmsQueryParam) 获取地物要素信息。
MapLegend	getLayerLegend(java.lang.String version, WMSMapParameter wmsMapParam) 获取指定图层的图例。
java.util.List<WMSLayer>	getLayers()
byte[]	getLegendGraphic(java.lang.String version, WMSMapParameter wmsMapParam) 获取图例图片的二进制流。
java.lang.String	getLegendUrl(java.lang.String version, WMSMapParameter wmsMapParam)
byte[]	getMap(java.lang.String version, WMSMapParameter wmsMapParam) 获取地图图片的二进制数组。
java.lang.String	getMapUrl(java.lang.String version, WMSMapParameter wmsMapParam) 获取图片对应的url地址

从类继承的方法 java.lang.Object

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

字段详细资料

URL_CHARSET

public static final java.lang.String URL_CHARSET

URL 编码时使用的字符集。默认为 utf-8。

构造器详细资料

WMSClient

public WMSClient(java.lang.String url,
         java.lang.String userName,
         java.lang.String password)

构造函数。

参数:

urlWMS 服务的 URL 地址。 -

userName访问 WMS 服务的用户名。 -

password访问 WMS 服务的密码。 -

WMSClient

public WMSClient(java.lang.String url,
         java.lang.String userName,
         java.lang.String password,
         java.util.List<java.lang.String> srsNames)

方法详细资料

getLayers

public java.util.List<WMSLayer> getLayers()

getFeatureInfoMap

public java.util.Map<Layer,QueryResult> getFeatureInfoMap(java.lang.String version,
                                                 WMSQueryParameter wmsQueryParam)
                                                   throws OGCException

从接口复制的说明: WMS

获取地物要素信息。

该方法用于获取地图上要素的信息，地图是通过 GetMap 操作返回的，因此，要访问 GetFeatureInfo 操作应该先访问 GetMap 操作获取地图，用户在获取的地图上选取一个点（point(i, j)）来查询更加丰富的信息。用户可以指定要查询的像素、查询的图层以及返回信息的格式等。

指定者:

getFeatureInfoMap 在接口中 WMS

参数:

version - WMS 服务版本号。

wmsQueryParam - WMS 查询参数。

返回:

Map 对象,key为图层对象，value为该图层对应的查询结果。

抛出:

OGCException - OGC 异常信息。

getCapabilities

public WMSCapabilities getCapabilities(java.lang.String version)
                                throws WMSServiceException

获取 WMS 服务级元数据。

该方法用于获取服务元数据，元数据用于描述服务器信息内容和可接受的请求参数值，是一种机器可读（并适合人阅读）的描述。

指定者:

getCapabilities 在接口中 WMS

参数:

versionWMS 服务版本号。 -

返回:

返回 WMSCapabilities 对象。

抛出:

WMSServiceExceptionWMS 服务异常信息。以下情况会抛出该异常：


1. 当获取的服务元数据信息中 <Capability> 元素不存在时。

2. 当获取的服务元数据信息中 <Exception> 元素的子元素 <Format> 不存在时。

WMSServiceException

checkExceptionNode

public java.lang.String[] checkExceptionNode(org.w3c.dom.Node exceptionNode)
                                      throws javax.xml.xpath.XPathExpressionException

抛出:

javax.xml.xpath.XPathExpressionException

getFeatureInfo

public WMSFeatureInfo[] getFeatureInfo(java.lang.String version,
                              WMSQueryParameter wmsQueryParam)
                                throws WMSServiceException

获取地物要素信息。

该方法用于获取地图上要素的信息，地图是通过 GetMap 操作返回的，因此，要访问 GetFeatureInfo 操作应该先访问 GetMap 操作获取地图，用户在获取的地图上选取一个点（point(i, j)）来查询更加丰富的信息。用户可以指定要查询的像素、查询的图层以及返回信息的格式等。

该操作对于 queryable 属性为“1”的图层有效，对于其他图层客户端不能发送 GetFeatureInfo 操作请求。当 WMS 服务接收到不支持的 GetFeatureInfo 操作请求时，会返回服务异常信息。

指定者:

getFeatureInfo 在接口中 WMS

参数:

versionWMS 服务版本号。 -

wmsQueryParamWMS 查询参数。 -

返回:

返回 WMSFeatureInfo 数组。

抛出:

WMSServiceExceptionWMS 服务异常信息。

WMSServiceException

getMap

public byte[] getMap(java.lang.String version,
            WMSMapParameter wmsMapParam)
              throws WMSServiceException

获取地图图片的二进制数组。

指定者:

getMap 在接口中 WMS

参数:

versionWMS 服务版本号。 -

wmsMapParamWMS 地图参数。 -

返回:

返回地图图片的二进制数组。

抛出:

WMSServiceExceptionWMS 服务异常信息。

WMSServiceException

getLegendGraphic

public byte[] getLegendGraphic(java.lang.String version,
                      WMSMapParameter wmsMapParam)
                        throws MapException,
                               OGCException

从接口复制的说明: WMS

获取图例图片的二进制流。

指定者:

getLegendGraphic 在接口中 WMS

参数:

version - WMS 服务版本号。

wmsMapParam - WMS 地图参数。

返回:

图例图片的二进制流。

抛出:

MapException - 异常信息。

OGCException

getLayerLegend

public MapLegend getLayerLegend(java.lang.String version,
                       WMSMapParameter wmsMapParam)
                         throws MapException,
                                OGCException

从接口复制的说明: WMS

获取指定图层的图例。

指定者:

getLayerLegend 在接口中 WMS

抛出:

MapException

OGCException

getLegendUrl

public java.lang.String getLegendUrl(java.lang.String version,
                            WMSMapParameter wmsMapParam)
                              throws java.lang.IllegalArgumentException

抛出:

java.lang.IllegalArgumentException

getMapUrl

public java.lang.String getMapUrl(java.lang.String version,
                         WMSMapParameter wmsMapParam)
                           throws java.lang.IllegalArgumentException

获取图片对应的url地址

参数:

version版本 -

wmsMapParamwms参数信息 -

返回:

图片url地址

抛出:

IllegalArgumentException异常信息

java.lang.IllegalArgumentException