Transaction 请求

发送反馈

请求参数

 

Transaction 操作通过 POST 请求实现添加要素、更新要素、删除要素三个功能，请求体采用 XML 格式，主要节点要素介绍如下：

表1 Transaction 操作请求体节点元素

请求参数 是否必需 描述
<Transaction> 是

一个 Transaction 要素包括0个或多个用于添加、更新、删除要素的<Insert>、<Update> 或 <Delete> 元素。

允许<Transaction>元素为空，即不包含其他元素，这时 Transaction 操作没有意义。
<Insert> 否 进行添加要素操作时必选。
待添加的要素需要通过<feature>元素用 GML 语言进行描述。
可在一个<Insert>元素中添加多个要素。
<Update> 否 进行更新要素操作时必选。其中，typeName 参数来指定需要更新的要素的类型。
一个<Update>元素中可包含一个或多个<Property>元素，用于指定需要更新的要素的属性（<Name>元素）和属性值（<Value>元素），没有<Value>元素时该属性将被赋予空值。
<Update>元素中还包含<Filter>元素，用于限定待更新要素的范围，可以是一个或多个，详见请求示例。
<Delete> 否 进行删除要素操作时必选。其中，typeName 参数来指定需要删除的要素的类型。
通过<Filter>元素指定待删除的要素，可以是一个或多个。

 

 

请求示例

本示例中对 WFS 服务 data-world/wfs100进行了3次 Transaction 操作，先添加一个新要素，然后对此要素进行更新，最后把这个要素删除。即对 http://localhost:8090/iserver/services/data-World/wfs100?request=Transaction ，执行 POST 请求，分别传输以下请求体：

  1. 添加要素

执行 POST 请求，在 World:Capitals 图层创建名为 testCapital 的示例首都，请求体为：

<wfs:Transaction xmlns:wfs="http://www.opengis.net/wfs"

        service="WFS" version="1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

        xsi:schemaLocation="http://www.opengis.net/wfs http://schemas.opengis.net/wfs/1.0.0/WFS-transaction.xsd https://www.supermap.com/World http://localhost:8090/iserver/services/data-World/wfs100?SERVICE=WFS&amp;VERSION=1.0.0&amp;REQUEST=DescribeFeatureType&amp;TYPENAME=World:Capitals">

        <wfs:Insert>

                <World:Capitals xmlns:World="https://www.supermap.com/World">

                        <World:CAPITAL>testCapital</World:CAPITAL>

                        <World:COUNTRY>testCountry</World:COUNTRY>

                        <World:the_geom>

                                <gml:Point xmlns:gml="http://www.opengis.net/gml" srsName="EPSG:4326">

                                        <gml:coordinates>143.09,35.57</gml:coordinates>

                                </gml:Point>

                        </World:the_geom>

                </World:Capitals>

        </wfs:Insert>

</wfs:Transaction>

添加要素成功后，响应参见：响应示例。

  1. 更新要素

执行 POST 请求，将 testCountry 国家的首都修改为 “otherCapital”， 请求体为：

<wfs:Transaction xmlns:wfs="http://www.opengis.net/wfs"

        service="WFS" version="1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

        xsi:schemaLocation="http://www.opengis.net/wfs http://schemas.opengis.net/wfs/1.0.0/WFS-transaction.xsd https://www.supermap.com/World http://localhost:8090/iserver/services/data-world/wfs100?SERVICE=WFS&amp;VERSION=1.0.0&amp;REQUEST=DescribeFeatureType&amp;TYPENAME=World:Capitals">

        <wfs:Update typeName="World:Capitals" xmlns:World="https://www.supermap.com/World">

                <wfs:Property>

                        <wfs:Name>CAPITAL</wfs:Name>

                        <wfs:Value>otherCapital</wfs:Value>

                </wfs:Property>

                <ogc:Filter xmlns:ogc="http://www.opengis.net/ogc">

                        <ogc:PropertyIsEqualTo>

                                <ogc:PropertyName>COUNTRY</ogc:PropertyName>

                                <ogc:Literal>testCountry</ogc:Literal>

                        </ogc:PropertyIsEqualTo>

                </ogc:Filter>

        </wfs:Update>

</wfs:Transaction>

更新要素成功后，响应参见：响应示例。

  1. 删除要素

执行 POST 请求，将 World:Capitals 图层中 CAPITAL 字段名为 “otherCapital”的要素删除，请求体为：

<wfs:Transaction xmlns:wfs="http://www.opengis.net/wfs"

        service="WFS" version="1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

        xsi:schemaLocation="http://www.opengis.net/wfs http://schemas.opengis.net/wfs/1.0.0/WFS-transaction.xsd https://www.supermap.com/World http://localhost:8090/iserver/services/data-world/wfs100?SERVICE=WFS&amp;VERSION=1.0.0&amp;REQUEST=DescribeFeatureType&amp;TYPENAME=World:Capitals">

        <wfs:Delete typeName="feature:Capitals" xmlns:feature="https://www.supermap.com/World">

                <ogc:Filter xmlns:ogc="http://www.opengis.net/ogc">

                        <ogc:PropertyIsEqualTo>

                                <ogc:PropertyName>CAPITAL</ogc:PropertyName>

                                <ogc:Literal>otherCapital</ogc:Literal>

                        </ogc:PropertyIsEqualTo>

                </ogc:Filter>

        </wfs:Delete>

</wfs:Transaction>

删除要素成功后，响应参见：响应示例。