Transaction 响应

发送反馈

响应说明

在响应 Transaction 事务请求时， WFS 2.0.0 服务会生成一个 XML 文档指明事务的最终状态。另外，如果 Transaction 事务请求中包含 Insert 元素，则 WFS 2.0.0 服务需要报告所有新添加要素的要素标识符。

TransactionResponse 为执行 Transaction 请求后，响应结果的根元素，如下所示：

<xsd:element name="TransactionResponse" type="wfs:TransactionResponseType" />

<xsd:complexType name="TransactionResponseType">

        <xsd:sequence>

                <xsd:element name="TransactionSummary" type="wfs:TransactionSummaryType" />

                <xsd:element name="InsertResults" type="wfs:ActionResultsType"

                        minOccurs="0" />

                <xsd:element name="UpdateResults" type="wfs:ActionResultsType"

                        minOccurs="0" />

                <xsd:element name="ReplaceResults" type="wfs:ActionResultsType"

                        minOccurs="0" />

        </xsd:sequence>

        <xsd:attribute name="version" type="xsd:string" use="required"

                fixed="2.0.0" />

</xsd:complexType>

TransactionSummary：用于统计执行 Transaction 事务请求后， 添加、修改、替换或删除的要素数量。只有操作 Capabilities 文档中列出的要素类型中的要素时，才会有 TransactionSummary 元素。

InsertResults：如果 Transaction 事务请求中包含 Insert 元素，则在事务请求的响应结果中会指定 InsertResults 元素，用以表示执行添加要素操作后产生的结果。InsertResults 元素可包含一个或多个 Feature 元素。每个 Feature 元素中使用唯一要素标识符标识新添加要素。InsertResults 元素中新添加要素应按 Insert 操作中指定的添加要素顺序显示。

UpdateResults：如果 Transaction 事务请求中包含 Update 元素，则在事务请求的响应结果中会指定 UpdateResults 元素，用以表示执行更新要素操作后产生的结果。UpdateResults 元素可包含一个或多个 Feature 元素。每个 Feature 元素中使用唯一要素标识符标识更新后的要素。UpdateResults 元素中更新后的要素应按 Update 操作中指定的更新要素顺序显示。

ReplaceResults：如果 Transaction 事务请求中包含 Replace 元素，则在事务请求的响应结果中会指定 ReplaceResults 元素，用以表示执行替换要素操作后产生的结果。ReplaceResults 元素可包含一个或多个 Feature 元素。每个 Feature 元素中使用唯一要素标识符标识替换后的要素。ReplaceResults 元素中替换后的要素应按 Replace 操作中指定的替换要素顺序显示。

响应示例

请求示例 中，添加要素、更新要素、替换要素、删除要素的响应结果分别如下所示：

  1. 添加要素请求，服务器端返回相应的 xml 文本如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<wfs:TransactionResponse xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:wfs="http://www.opengis.net/wfs/2.0" xmlns:fes="http://www.opengis.net/fes/2.0" xmlns:gml="http://www.opengis.net/gml/3.2" version="2.0.0">

    <wfs:TransactionSummary>

        <wfs:totalInserted>2</wfs:totalInserted>

    </wfs:TransactionSummary>

    <wfs:InsertResults>

        <wfs:Feature>

            <fes:ResourceId rid="World.Capitals.193"/>

        </wfs:Feature>

        <wfs:Feature>

            <fes:ResourceId rid="World.Capitals.194"/>

        </wfs:Feature>

    </wfs:InsertResults>

</wfs:TransactionResponse>

  1. 更新要素请求，服务器端返回的 xml 文本如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<wfs:TransactionResponse xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:wfs="http://www.opengis.net/wfs/2.0" xmlns:fes="http://www.opengis.net/fes/2.0" xmlns:gml="http://www.opengis.net/gml/3.2" version="2.0.0">

    <wfs:TransactionSummary>

        <wfs:totalUpdated>1</wfs:totalUpdated>

    </wfs:TransactionSummary>

    <wfs:UpdateResults>

        <wfs:Feature>

            <fes:ResourceId rid="World.Capitals.193"/>

        </wfs:Feature>

    </wfs:UpdateResults>

</wfs:TransactionResponse>

  1. 替换要素请求，服务器端返回的 xml 文本如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<wfs:TransactionResponse xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:wfs="http://www.opengis.net/wfs/2.0" xmlns:fes="http://www.opengis.net/fes/2.0" xmlns:gml="http://www.opengis.net/gml/3.2" version="2.0.0">

    <wfs:TransactionSummary>

        <wfs:totalReplaced>1</wfs:totalReplaced>

    </wfs:TransactionSummary>

</wfs:TransactionResponse>

  1. 删除要素请求，服务器端返回的 xml 文本如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<wfs:TransactionResponse xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:wfs="http://www.opengis.net/wfs/2.0" xmlns:fes="http://www.opengis.net/fes/2.0" xmlns:gml="http://www.opengis.net/gml/3.2" version="2.0.0">

    <wfs:TransactionSummary>

        <wfs:totalDeleted>2</wfs:totalDeleted>

    </wfs:TransactionSummary>

</wfs:TransactionResponse>