DescribeStoredQueries 请求

发送反馈

请求参数

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

表1 DescribeStoredQueries 操作主要请求参数

请求参数 是否必需 描述

VERSION

是

请求版本号。

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

SERVICE

是

服务类型。

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

REQUEST

是

请求名称。

请求 DescribeStoredQueries 操作，请求名称需要设为"DescribeStoredQueries"。

NAMESPACES

否

命名空间。

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

目前 SuperMap iServer 不支持该参数。

VSPs

否

提供者特定参数。

DescribeStoredQueries 请求中允许可选的服务提供者特定参数（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 不支持该参数。

STOREDQUERY_ID

否

存储查询方式标识符。

用英文逗号分隔开的存储查询方式的标识符列表。如果该参数的值未指定，则表示返回 WFS 2.0.0 服务支持的所有存储查询方式的描述。

目前 SuperMap iServer 只支持 GetFeatureById 存储查询方式。

请求示例

<ServiceRoot>?SERVICE=WFS&VERSION=version&REQUEST=DescribeStoredQueries&STOREDQUERY_ID=storedquery_id

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

例如，本机 SuperMap iServer WFS 2.0.0 服务启动成功之后，访问 DescribeStoredQueries 操作的 URI 是：http://localhost:8090/iserver/services/data-world/wfs200?SERVICE=WFS&VERSION=2.0.0&REQUEST=DescribeStoredQueries&STOREDQUERY_ID=urn:ogc:def:query:OGC-WFS::GetFeatureById。

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

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

<?xml version="1.0" ?>

<DescribeStoredQueries service="WFS" version="2.0.0"

    xmlns="http://www.opengis.net/wfs/2.0" xmlns:myns="http://www.myserver.com/myns"

    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">

    <StoredQueryId>urn:ogc:def:query:OGC-WFS::GetFeatureById</StoredQueryId>

</DescribeStoredQueries>

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