请求参数

DescribeFeatureType 操作的 KVP 编码请求的主要请求参数如下表所示:

表1 DescribeFeatureType 操作的主要请求参数

请求参数

是否必需

描述

VERSION

请求版本号。

请求 WFS 2.0.0 服务,请求版本号需要设为"2.0.0"。

SERVICE

服务类型。

请求 WFS 2.0.0 服务,服务类型需要设为"WFS"。

REQUEST

请求名称。

请求 DescribeFeatureType 操作,请求名称需要设为"DescribeFeatureType"。

TYPENAME

要素类型列表。

要素类型之间以英文逗号分隔。如果没有设置 TYPENAME 的值,表示请求 WFS 2.0.0 服务提供的所有要素类型。

OUTPUTFORMAT

响应格式。

限定了执行 DescribeFeatureType 操作后,响应结果的编码格式。默认支持两种输出格式(outputFormat),这两种格式在 Capabilities XML 文档中有明确声明,分别为“application/gml+xml;version=3.2”和“text/xml;subtype=gml/3.2”。

NAMESPACES

命名空间。

用于指定命名空间及其前缀,形式为 xmlns(前缀为 escaped_url)。如果前缀没有被定义,则默认的命名空间应该被声明。可以通过英文逗号将 xmlns()值的多个命名空间连接起来。

VSPs

提供者特定参数。

DescribeFeatureType 请求中允许可选的服务提供者特定参数(vendor-specific parameters,VSPs),这些参数由供应商指定,不属于国际标准的 KVP 参数。这些参数的使用增强了请求的响应结果。VSPs 丢失或错误时,服务可以提供一个默认值。VSPs 在不被服务所知道的情况下被应用时,服务可以选择忽略不知道的请求参数。

WFS 可以选择不声明部分或全部 VSPs。如果 VSPs 包含在 Capabilities XML 中,则 ExtendedCapabilities 元素应该进行相应扩展。包含了 ExtendedCapabilities 扩展元素的其他 Schema 文档可以被引入到 Capabilities XML 文档中。客户端可以从 Capabilities Schema 中读取服务提供者特定的定义,并且使用 VSPs 构成请求。WFS 实现者在为 VSP 选择名字时应该注意,不要与国际标准中定义的 WFS 参数产生冲突。

目前 SuperMap iServer 不支持该参数。

请求示例

  • DescribeFeatureType 操作的 KVP 编码请求方式如下:

<ServiceRoot>?SERVICE=WFS&VERSION=version&REQUEST=DescribeFeatureType&OUTPUTFORMAT=outputformat&TYPENAME=type_list

ServiceRoot 为服务的 URI 根目录,请参见 服务的 URI 设置

例如,本机 SuperMap iServer WFS 2.0.0 服务启动成功之后,访问 DescribeFeatureType 操作的 URI 是:http://localhost:8090/iserver/services/data-world/wfs200?SERVICE=WFS&VERSION=2.0.0&REQUEST=DescribeFeatureType&OUTPUTFORMAT=text/xml;subtype=gml/3.2&TYPENAME=World:Countries。

该请求示例的响应结果请参见 响应示例

  • DescribeFeatureType 操作的 XML 编码请求方式如下:

即对 http://localhost:8090/iserver/services/data-world/wfs200 ,执行 POST 请求,请求体如下:

<?xml version="1.0" ?>

<DescribeFeatureType service="WFS" version="2.0.0"

    xmlns="http://www.opengis.net/wfs/2.0" xmlns:World="http://www.supermap.com.cn/World"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://www.opengis.net/wfs/2.0

                       http://schemas.opengis.net/wfs/2.0.0/wfs.xsd">

    <TypeName>World:Countries</TypeName>

</DescribeFeatureType>

该请求示例的响应结果同 KVP 编码请求,请参见 响应示例