• 网络要素服务(WFS)详解


    1. 概述

    前置文章:
    地图服务器GeoServer的安装与配置
    GeoServer发布地图服务(WMS、WFS)
    网络地图服务(WMS)详解

    WMS是一个返回图片地图的服务,图片本身就是栅格数据的一种,而对于矢量数据则可以进行矢量栅格化;因此,WMS的数据源既可以是栅格数据,也可以是矢量数据。而WFS则不同,它是一个专门针对于矢量数据的服务,其返回的也是矢量要素本身。在Web环境中,图片是很容易进行可视化展示的,甚至图片本身就是GUI中一类很重要的元素。但矢量要素则不同,是不太容易可视化的。例如,如果要在前端的HTML5页面中展示获取的要素,就需要调用HTML5的Canvas元素来进行绘图,这其中涉及到繁复的操作不说,也很有可能会有性能问题。因此,WFS并不关心可视化问题,而是为返回GIS矢量数据而设计的,同时还支持矢量的查询、增加、删除以及修改等事务性操作。

    WFS与WMS一样,同样使用HTTP来实现的各种操作,不同的是由于进行请求要求发送复杂的XML数据,简单的Get请求方式可能会受到数据量的限制,这种情况下需要使用Post方式进行请求。而在Web前端环境中,XML数据并不方便使用(最方便的是JSON数据),经常要考虑到繁琐的字符串拼接以及字符转义的问题。另一方面,由于WFS需要传输的参数比较多,在其标准规范《OpenGIS_Web_Map_Service_WMS_Implementation_Specification》使用了XML Schema(描述XML结构的语言)这一复杂的语言来描述需要传递的XML数据;并且一个操作的数据描述还分散在文档不同的地方。官方的参考资料尚且如此复杂,普通GIS从业人员也就很少愿意主动去使用,这无疑限制了造成WFS的应用场景。应该来说,WFS的设计出来的年代比较早,XML格式还是主流,如果使用JSON格式来进行数据传输,应该会方便不少。

    目前WFS有2.0.2、2.0.0、1.1.3、1.1.0和1.0.0等多个版本,不过有4种操作是每个版本都有并且比较常见的,如下表1所示。由于有的操作与WMS比较类似,有的操作又比较繁琐,在下面的介绍中就不再对参数进行穷举说明,以实际的例子为主。

    【表1 WFS支持的操作】

    操作 描述
    GetCapabilities 生成元数据文档,描述服务器提供的WFS服务以及有效的WFS操作和参数
    DescribeFeatureType 返回WFS服务支持的要素类型的描述
    GetFeature 从数据源中返回所选要素,包括几何和属性值
    Transaction 通过创建、更新和删除来编辑现有要素类型

    2. GetCapabilities

    这个操作与WMS的GetCapabilities操作比较类似,都是生成描述服务器提供的WFS服务能力的元数据信息。例如我们在浏览器地址栏中输入如下地址:

    http://localhost:8080/geoserver/wfs?
    service=wfs&
    version=2.0.0&
    request=GetCapabilities
    

    此时会返回一个XML文件,如下图所示:

    图8.33 WFS GetCapabilities返回结果

    3. DescribeFeatureType

    在请求实际数据之前,往往需要知道要请求要素类型的信息,此时可以使用DescribeFeatureType操作。除此之外,该操作还可以获取属性的字段名称,以及字段类型。例如我们获取第8.1.3节发布的矢量要素test:multipolygons的类型,可通过如下地址来进行访问:

    http://localhost:8080/geoserver/wfs?
    service=wfs&
    version=2.0.0&
    request=DescribeFeatureType&
    typeName=test:multipolygons&
    outputFormat=application/json
    

    由于我们设置了输出类型为JSON,因此会返回一个JSON数据,如下图8.34所示:

    图8.34 WFS DescribeFeatureType返回结果

    4. GetFeature

    4.1 Get访问方式

    接下来就是WFS中最重要的操作GetFeature了,通过该操作可以返回矢量数据源的要素信息,包括几何信息和属性信息。例如,要获取矢量要素的全部信息,可通过如下地址来进行访问:

    http://localhost:8080/geoserver/wfs?
    service=wfs&
    version=2.0.0&
    request=GetFeature&
    typeNames=test:multipolygons&
    outputFormat=application/json
    

    此时返回的是所有的350个要素信息,如下图所示:

    图8.35 WFS GetFeature返回所有要素

    很多时候返回所有的要素信息并不是我们想要的,我们希望进行空间查询,例如查找一个矩形范围内要素,那么可以通过在浏览器中输入如下地址来实现:

    http://localhost:8080/geoserver/wfs?
    service=wfs&
    version=2.0.0&
    request=GetFeature&
    typeNames=test:multipolygons&
    outputFormat=application/json&
    srsName=EPSG:4326&
    bbox=38.8954267799311,-77.039412232917,38.8965224165805,-77.0380063000187
    

    其中srsName表示空间坐标参考,bbox表示具体的四至范围。此时的返回结果如下图所示,可以看到返回的矢量要素只有21个了:

    图8.36 WFS GetFeature返回矩形范围内要素

    如果我们要进行属性查询,例如查找特定要素ID的特定属性值,可通过在浏览器中输入如下地址来实现:

    http://localhost:8080/geoserver/wfs?
    service=wfs&
    version=2.0.0&
    request=GetFeature&
    typeNames=test:multipolygons&
    outputFormat=application/json&
    featureID=multipolygons.2&
    propertyName=name,building
    

    featureID表示要素Id,propertyName表示要素字段名。此时返回的结果可以看到该要素具体的属性值,如下图所示:

    图8.37 WFS GetFeature返回要素属性值

    4.2 Post访问方式

    以上几种方式都是通过在浏览器中输入如下地址,也就是通过HTTP协议的Get请求来实现。但是如果进行空间查询的参数数据量特别大,比如查询一个多边形范围内的要素就很麻烦了。虽然仍然可以通过给Get请求的filter参数传递一个XML格式的文本字符串的方式来实现,但是可能会受到URL长度的限制。因此,复杂的空间查询最好通过POST请求来实现。

    不过,使用Post访问方式的示例就要麻烦一点。为了避免在访问WFS服务时遇到跨域问题,我们需要发布一个静态网页,通过JavaScript来实现Post请求。具体操作是新建一个test.html文件夹,内容如下例1所示:

    【例1 给WFS发送Post请求】

    html>
    <html lang="en">
    
    <head>
      <meta charset="UTF-8">
      <title>test handle responsetitle>
      <script>
        var url = "http://localhost:8080/geoserver/wfs";
        var xhr = new XMLHttpRequest();
        xhr.open("POST", url);
        //xhr.open("GET", url);
        xhr.setRequestHeader("Content-Type", "text/xml");
        xhr.onload = function (e) {
          if (xhr.readyState === 4) {
            if (xhr.status === 200) {
              console.log(xhr.responseText);
            } else {
              console.error(xhr.statusText);
            }
          }
        };
    
        xhr.onerror = function (e) {
          console.error(xhr.statusText);
        };
    
        var xml = `
    <wfs:GetFeature service=\"WFS\" version=\"2.0.0\" outputFormat=\"json\" 
    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\" 
    xmlns:test=\"https://test\" 
    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/wfs.xsd 
    http://www.opengis.net/gml/3.2 
    http://schemas.opengis.net/gml/3.2.1/gml.xsd\">
      <wfs:Query typeNames='test:multipolygons'>
        <fes:Filter>
          <fes:Intersects>
            <fes:ValueReference>test:the_geomfes:ValueReference>
            <gml:Envelope srsName=\"EPSG:4326\">
              <gml:lowerCorner>
                -77.039412232917 38.8954267799311
              gml:lowerCorner>
              <gml:upperCorner>
                -77.0380063000187 38.8965224165805
              gml:upperCorner>
            gml:Envelope>
          fes:Intersects>
        fes:Filter>
      wfs:Query>
    wfs:GetFeature>`;
        xhr.send(xml); 
      script>
    head>
    <body>
    body>
    html>
    

    然后将这个文件放入到一个新的文件夹geoservertest,最后将geoservertest文件夹放入到Tomcat的项目发布目录webapps中,如下图所示:

    图8.38 发布一个测试Post请求的静态网页

    在这个示例中,使用了XMLHttpRequest来发送Post请求,并且在请求头中标明数据内容是一个XML文件。我们这里使用的是一个XML格式的文本字符串,实际上我们要传输的XML数据内容经过格式化如下所示:

    
    <wfs:GetFeature service="WFS" version="2.0.0" outputFormat="json"
      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"
      xmlns:test="https://test"
      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/wfs.xsd 
    http://www.opengis.net/gml/3.2 
    http://schemas.opengis.net/gml/3.2.1/gml.xsd">
      <wfs:Query typeNames='test:multipolygons'>
        <fes:Filter>
          <fes:Intersects>
            <fes:ValueReference>test:the_geomfes:ValueReference>
            <gml:Envelope srsName="EPSG:4326">
              <gml:lowerCorner>
                -77.039412232917 38.8954267799311
              gml:lowerCorner>
              <gml:upperCorner>
                -77.0380063000187 38.8965224165805
              gml:upperCorner>
            gml:Envelope>
          fes:Intersects>
        fes:Filter>
      wfs:Query>
    wfs:GetFeature>
    

    我们可以看到XML其中一些属性和属性的值就是之前的参数,例如service="WFS"、version="2.0.0"、outputFormat="json"以及typeNames='test:multipolygons'。而fes:filter正是前面提到的用于设置过滤数据的元素;fes:Intersects则表示相交,test:the_geom表示相交查询要素的几何字段名称;gml:Envelope整个节点则通过GML(Geographic Markup Language,地理标记语言)描述了一个矩形范围。

    我们在浏览器输入访问地址:http://localhost:8080/geoservertest/test.html ,打开浏览器调试器,可以看到在浏览器控制台输出了返回的信息。也可以检查该访问请求,查看具体的返回信息,如下图所示。可以看到返回的要素个数和前面Get请求的结果一样,也是21个要素。这是因为我们空间查询输入的四至范围是一样的。不过Post请求可以通过GML构造复杂的几何要素来进行空间查询,这时Get请求不能做到的。

    图8.39 WFS GetFeature使用Post请求返回信息

    5. Transaction

    Transaction操作可以创建、修改和删除WFS发布的要素,加上GetFeature的查询操作,就组成了类似于处理常规数据库数据的“增删改查”操作。区别只在WFS服务的Transaction和GetFeature操作针对的是远端的地理空间数据。这也是将这个操作命名为Transaction(事务)的原因。简要来说,Transaction操作支持四个动作(Action),分别是Insert(插入)、Replace(替换)、Update(更新)和Delete(删除)。由于Transaction操作也比较复杂,通常使用Post请求来实现。

    还是使用例1所示的test.html页面来进行WFS的Transaction操作。由于WFS操作Post请求发送的请求的文件头都差不多,区别主要在于发送的内容,也就是XML数据;那么我们就只需要修改发送的XML格式字符串就可以了。因此,Transaction操作所使用的示例与例1相同,这里只列出具体的XML数据。

    5.1 Insert

    既然我们要插入一个要素,首先就需要描述一个要素信息来进行传输。但是WFS要求请求的要素信息都是GML描述的,比如这里我们的示例矢量数据类型是面要素(multipolygon),那么应该如何去描述呢?最简单的方式是通过GetFeature查看默认格式的要素信息,就可以看到GML描述的要素,如下所示:

    <test:multipolygons gml:id="multipolygons.5">
      <gml:name/>
      <test:the_geom>
          <gml:MultiSurface srsName="http://www.opengis.net/gml/srs/epsg.xml#4326" srsDimension="2" gml:id="multipolygons.5.the_geom">
              <gml:surfaceMember>
                  <gml:Polygon gml:id="multipolygons.5.the_geom.1">
                      <gml:exterior>
                          <gml:LinearRing>
                              <gml:posList>-77.0383595 38.8960779 -77.0383609 38.8961371 -77.0383618 38.8961764 ... -77.0383595 38.8960779gml:posList>
                          gml:LinearRing>
                      gml:exterior>
                      <gml:interior>
                          <gml:LinearRing>
                              <gml:posList>-77.0386713 38.8958537 -77.0387129 38.8958542 -77.0387253 38.8958338 ... -77.0386713 38.8958537gml:posList>
                          gml:LinearRing>
                      gml:interior>
                  gml:Polygon>
              gml:surfaceMember>
          gml:MultiSurface>
      test:the_geom>
      <test:osm_id>3211113test:osm_id>
      <test:osm_way_id/>
      <test:type>multipolygontest:type> 
    test:multipolygons>
    

    这段GML描述,如果我们对矢量比较熟悉的话,理解起来就会非常容易。一个面要素可能有一个外环和多个内环。环是起点和终点为同一个点的线串,线串由一系列连续的点组成。我们可以仿照这个格式,也创建一个GML格式的要素信息,将其嵌入到要传输的XML数据中。具体的插入要素要发送Post请求的XML数据如下所示:

    
    <wfs:Transaction service="WFS" version="2.0.0"
        xmlns:test="https://test"
        xmlns:fes="http://www.opengis.net/fes/2.0"
        xmlns:gml="http://www.opengis.net/gml/3.2"
        xmlns:wfs="http://www.opengis.net/wfs/2.0"
        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/wfs.xsd http://www.opengis.net/gml/3.2 http://schemas.opengis.net/gml/3.2.1/gml.xsd">
        <wfs:Insert>
            <test:multipolygons gml:id="multipolygons.351">
                <test:the_geom>
                    <gml:MultiSurface srsName="http://www.opengis.net/gml/srs/epsg.xml#4326" srsDimension="2" gml:id="multipolygons.352.the_geom">
                        <gml:surfaceMember>
                            <gml:Polygon gml:id="multipolygons.351.the_geom.1">
                                <gml:exterior>
                                    <gml:LinearRing>
                                        <gml:posList>-77.039412232917 38.8954267799311 -77.039412232917 38.8965224165805 -77.0380063000187 38.8965224165805 -77.0380063000187 38.8954267799311 -77.039412232917 38.8954267799311gml:posList>
                                    gml:LinearRing>
                                gml:exterior>
                            gml:Polygon>
                        gml:surfaceMember>
                    gml:MultiSurface>
                test:the_geom>
            test:multipolygons>
        wfs:Insert>
    wfs:Transaction>
    

    在这个XML中我们可以看到一些熟悉的配置,例如service="WFS",version="2.0.0"等。wfs:Insert表示使用wfs的插入操作,test:multipolygons则索引到我们要插入的要素图层名称。test是我们在前文中创建的工作空间,我们同时还创建了对应的命名空间URI:https://test ;工作空间需要与命名空间URI相关联,这也是为什么要写xmlns:test="https://test"。除此之外,剩下的就是通过GML描述的面要素了,可以看到我们构建了一个四边形。

    同样的还是在浏览器输入访问地址http://localhost:8080/geoservertest/test.html 来发送Post请求。如果一切顺利的话,再通过GetFeature操作(http://localhost:8080/geoserver/wfs?service=wfs&version=2.0.0&request=GetFeature&typeNames=test:multipolygons&outputFormat=application/json )就可以看到刚刚插入的新的要素,如下图所示:

    图8.40 WFS的Transaction操作的Insert(插入)结果

    5.2 Replace

    有了Insert操作作为基础,理解Replace的实现就非常容易了。Replace操作Post请求需要传输的XML数据如下:

    
    <wfs:Transaction version="2.0.0" service="WFS"
        xmlns:test="https://test"
        xmlns:fes="http://www.opengis.net/fes/2.0"
        xmlns:wfs="http://www.opengis.net/wfs/2.0"
        xmlns:gml="http://www.opengis.net/gml/3.2"
        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/wfs.xsd">
        <wfs:Replace>
            <test:multipolygons gml:id="multipolygons.351">
                <test:the_geom>
                    <gml:MultiSurface srsName="http://www.opengis.net/gml/srs/epsg.xml#4326" srsDimension="2" gml:id="multipolygons.352.the_geom">
                        <gml:surfaceMember>
                            <gml:Polygon gml:id="multipolygons.352.the_geom.1">
                                <gml:exterior>
                                    <gml:LinearRing>
                                        <gml:posList>-77.039412232917 38.8954267799311 -77.039412232917 38.8965224165805 -77.0380063000187 38.8965224165805 -77.039412232917 38.8954267799311
                                        gml:posList>
                                    gml:LinearRing>
                                gml:exterior>
                            gml:Polygon>
                        gml:surfaceMember>
                    gml:MultiSurface>
                test:the_geom>
            test:multipolygons>
            <fes:Filter>
                <fes:ResourceId rid="multipolygons.351"/>
            fes:Filter>
        wfs:Replace>
    wfs:Transaction>
    

    可以看到XML数据内容与Insert操作差不多,不过要注意的是多了一个fes:Filter元素来帮助选定到具体需要替换的要素。最后通过GetFeature操作查询替换的要素如下图所示,可以看到我们将一个四边形要素替换成了三角形:

    图8.41 WFS的Transaction操作的Replace(替换)结果

    5.3 Update

    前面Insert和Replace操作的对象都是要素的几何信息,其实要素的属性信息也可以修改。例如可以通过Update操作来更新要素的属性信息,其Post请求需要传输的XML数据如下:

    
    <wfs:Transaction version="2.0.0" service="WFS"
       xmlns:fes="http://www.opengis.net/fes/2.0"
       xmlns:wfs="http://www.opengis.net/wfs/2.0"
       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">
       <wfs:Update typeName="test:multipolygons">
          <wfs:Property>
             <wfs:ValueReference>namewfs:ValueReference>
             <wfs:Value>boundwfs:Value>
          wfs:Property>
          <wfs:Property>
             <wfs:ValueReference>other_tagswfs:ValueReference>
             <wfs:Value>testwfs:Value>
          wfs:Property>      
          <fes:Filter>
             <fes:ResourceId rid="multipolygons.351"/>
          fes:Filter>
       wfs:Update>
    wfs:Transaction>
    

    可以看到我们为这个新增加并且替换后的要素更新了两个属性字段(name和other_tags)的值,通过GetFeature操作查询要素的结果如下图所示:

    图8.42 WFS的Transaction操作的Update(更新)结果

    5.4 Delete

    最后就让我们形成一个回环,将这个新增并且修改的矢量要素删除掉吧,Delete操作的Post请求需要传输的XML数据如下:

    
    <wfs:Transaction version="2.0.0" service="WFS"
        xmlns:fes="http://www.opengis.net/fes/2.0"
        xmlns:wfs="http://www.opengis.net/wfs/2.0"
        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/wfs.xsd">
        <wfs:Delete typeName="test:multipolygons">
            <fes:Filter>
                <fes:ResourceId rid="multipolygons.351"/>
            fes:Filter>
        wfs:Delete>
    wfs:Transaction>
    

    经过GetFeature操作查询后,我们发现这个矢量数据的要素个数又回到了350个,如下图所示:

    图8.43 WFS的Transaction操作的Delete(删除)结果

    6 注意事项

    除了以上四种常用的操作,WFS还有一些其他操作,有的操作还是特定版本特有的,篇幅所限笔者这里就不介绍了。另外,相信读者也能感受到,WFS提供的一些操作确实非常复杂繁琐。对于空间数据的增删改查,直接使用地理数据库+定制的后端接口也许更为方便安全一些。

  • 相关阅读:
    【DevOps】Git 图文详解(七):标签管理
    2021 Lifelong learning(李宏毅
    SpringCloud系列——Ribbon day2-2
    Element Plus 的下拉选择器el-option的字体全部蓝色,全部是选中状态
    【SQL之降龙十八掌】01——亢龙有悔:入门10题
    2023华为OD统一考试(B卷)题库清单(按算法分类),如果你时间紧迫,就按这个刷
    微服务12:系统服务熔断、限流
    如何用 Zabbix 监控 Radius 服务?
    如何录制微课?简单,手把手教你:教学微课视频如何录制
    金仓数据库KingbaseES客户端编程开发框架-Hibernate(4. Hibernate编程指南)
  • 原文地址:https://www.cnblogs.com/charlee44/p/17978722