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) 
    • 字段详细资料

      • 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()
        
      • 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
        
        从接口复制的说明: WMS

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

        指定者:
        getLegendGraphic 在接口中 WMS
        参数:
        version - WMS 服务版本号。
        wmsMapParam - WMS 地图参数。
        返回:
        图例图片的二进制流。
        抛出:
        MapException - 异常信息。
      • 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