通过REST API对数据服务进行要素的增、删、改

已于 2023-12-19 15:55:38 修改
阅读量980 收藏 20
点赞数 21
文章标签： postman javascript
于 2023-12-19 15:33:17 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_42493559/article/details/135079651
版权

目录

作者：kxj

前言

    SuperMap iServer使用工作空间发布数据服务之后，可以通过对 features 资源执行 GET 请求获取数据集中的要素列表，当数据集为点、线、面数据集、文本数据集、复合数据集或纯属性表数据集时，对 features 资源执行 POST 请求可以完成对数据集中的要素进行添加、删除或修改。接下来具体介绍一下如何对数据服务进行要素的添加、删除和修改。（本文以SuperMap iServer 11i(2023) SP1为例）

一、设置数据服务可编辑

1.在iServer服务管理页面找到对应数据服务，点击进入
在这里插入图片描述

  1. 在基本信息页面开启【是否启用编辑】
    在这里插入图片描述

二、接口介绍

2.1 请求参数

    features 资源表示的是数据集中的要素集合。对 features 资源执行 POST 请求默认是在创建新的要素。但可以在 features 资源的 URI 中包含如下参数来控制 POST 请求的预期是删除要素还是修改要素。
注：三维模型数据集不支持创建要素。
URI 中的参数如下：

名称类型含义
isUseBatchboolean【可选参数】 是否使用批量添加要素功能，要素添加时有效。 批量添加能够提高要素编辑效率。true 表示批量添加；false 表示不使用批量添加。默认不传时为 false。
returnContentboolean【可选参数】 要素添加时，isUseBatch 不传或传为 false 的情况下有效。 true 表示直接返回新创建的要素的 ID 数组;false 表示返回创建的 featureResult 资源的 URI。默认不传时为 false。
_methodStringPOST 请求应实现的功能。 可能的值有：GET、PUT、POST、DELETE、HEAD，分别表示实现对应 HTTP 请求的功能。这里，_method 可取 DELETE 或 PUT，分别表示删除要素或修改要素。

对 features 资源执行 POST 请求，对要素进行添加（无 _method 参数）或修改（_method=PUT）时，需要在请求体中包含添加/修改的要素信息集合，其中单个要素信息的结构如下：

名称类型含义
fieldNamesString[]要素的属性字段名集合。其中，系统字段是创建数据集和要素时系统默认生成的字段，用户不能进行编辑，字段内容除了 SMUSERID 外都是不能修改的。
fieldValuesString[]要素的属性字段值集合。
geometryGeometry要素对应的几何对象。暂不支持Elasticsearch数据源中既有Geo_Point类型，又有Geo_Shape类型的数据。

对要素进行删除时（_method=DELETE），需要在请求体中包含欲删除要素的 ID 数组或SQL查询条件，这时，请求体结构如下：

名称类型含义
IDsint[]以ID 数组方式删除要素时，需传入要素的 ID 数组。 对于字符串和数值类型的数据，是否加引号均可。
attributeFilterString以SQL条件方式删除要素时，需传入 SQL查询条件。对于Elasticsearch数据，当字段值包含大写时，查询条件不加引号。例如：MAPTN = G12 ；对于Elasticsearch数据，查询条件暂不支持区分大小写。

2.2 响应结构

对 features 资源执行 POST 请求，对要素集中的要素进行添加、修改或删除，返回操作结果的表述结构如下：

字段类型说明
succeedboolean操作是否成功。
newResourceIDString创建的 featureResult 资源的 ID。
newResourceLocationString创建的 featureResult 资源的 URI。isUseBatch为 true 时无效。
errorHttpError出错信息，如果操作成功，则没有本字段。

三、请求示例

请求示例均以示例服务World的Countries数据集为例

3.1删除要素

3.1.1 通过ID数组删除要素

对 URI：http://ip:端口号/iserver/services/data-World/rest/data/datasources/World/datasets/Countries/features.rjson?_method=DELETE&deleteMode=IDS执行 POST 请求，在请求体中包含如下参数，删除 ID 为1、2的参数：

[1,2]

删除成功，返回 rjson 格式的操作结果表述如下：

{"succeed": true}

在这里插入图片描述

3.1.2通过 SQL 查询条件删除要素

对 URI：http://ip:端口号/iserver/services/data-World/rest/data/datasources/World/datasets/Countries/features.rjson?_method=DELETE&deleteMode=SQL执行 POST 请求，在请求体中包含如下参数，删除 SmID<10 的参数：

{"attributeFilter":"SmID < 10"}

删除成功，得到 rjson 格式的操作结果表述如下：

{"succeed": true}

在这里插入图片描述

3.2添加要素

3.2.1添加JSON格式的几何对象

对 URI：http://ip:端口号/iserver/services/data-World/rest/data/datasources/World/datasets/Countries/features.rjson 执行 POST 请求，在请求体中包含如下参数：

[

    {

        "fieldNames": [

            "SMID",

            "SMSDRIW",

            "SMSDRIN",

            "SMSDRIE",

            "SMSDRIS",

            "SMUSERID",

            "SMAREA",

            "SMPERIMETER",

            "SMGEOMETRYSIZE",

            "SQKM",

            "SQMI",

            "COLOR_MAP",

            "CAPITAL",

            "COUNTRY",

            "POP_1994",

            "CONTINENT"

        ],

        "fieldValues": [

            "22",

            "-7.433472633361816",

            "62.35749816894531",

            "-6.38972282409668",

            "61.388328552246094",

            "6",

            "0.25430895154659083",

            "5.743731026651685",

            "4500",

            "1474.69",

            "569.38",

            "5",

            "示例首都",

            "示例国家",

            "47067.0",

            "亚洲"

        ],

        "geometry": {

            "id": 22,

            "parts": [

                3

            ],

            "points": [

                {

                    "x": -40,

                    "y": 60

                },

                {

                    "x": -45,

                    "y": 62

                },

                {

                    "x": -40,

                    "y": 55

                },

                {

                    "x": -40,

                    "y": 60

                }

            ],

            "style": null,

            "type": "REGION",

            "prjCoordSys":null

        }

    }

]

创建成功的情况下，得到 rjson 格式的操作结果表述如下：

{
    "postResultType": "CreateChild",
    "newResourceID": "9df3b263e93140a4ad55483e1f8f796e_2cf958dc059843a89225e499dcf150cf",
    "succeed": true,
    "newResourceLocation": "http://localhost:8091/iserver/services/data-World/rest/data/featureResults/9df3b263e93140a4ad55483e1f8f796e_2cf958dc059843a89225e499dcf150cf.rjson"
}

在这里插入图片描述

3.2.2添加GeoJSON格式的几何对象

对示例 features 资源执行 POST 请求：http://ip:端口号/iserver/services/data-World/rest/data/datasources/World/datasets/Countries/features.rjson。需要添加请求头：X-RequestEntity-ContentType 为 application/geojson，在请求体中包含如下参数：

[

        {

            "geometry": {

                "coordinates": [

                    [

                        [

                            [

                                10.781665802002,

                                79.6502685546875

                            ],

                            [

                                10.7558326721191,

                                79.6597137451172

                            ],

                            [

                                10.7383308410645,

                                79.6794281005859

                            ],

                            [

                                10.7122192382813,

                                79.7136077880859

                            ],

                            [

                                10.7263870239258,

                                79.7177581787109

                            ],

                            [

                                10.760555267334,

                                79.7188720703125

                            ],

                            [

                                10.8866653442383,

                                79.7222137451172

                            ],

                            [

                                10.9177761077881,

                                79.7210998535156

                            ],

                            [

                                10.945276260376,

                                79.7191467285156

                            ],

                            [

                                10.9819412231445,

                                79.7119293212891

                            ],

                            [

                                11.0349979400635,

                                79.7008209228516

                            ],

                            [

                                11.0716648101807,

                                79.6727600097656

                            ],

                            [

                                11.0761089324951,

                                79.6627655029297

                            ],

                            [

                                10.9527759552002,

                                79.6527709960938

                            ],

                            [

                                10.9227752685547,

                                79.6510925292969

                            ],

                            [

                                10.781665802002,

                                79.6502685546875

                            ]

                        ]

                    ]

                ],

                "type": "MultiPolygon"

            },

            "properties": {

                "SQKM": "61909.1",

                "SMSDRIW": "10.487914",

                "SMSDRIS": "74.34305",

                "POP_1994": "3148.0",

                "SMSDRIN": "80.76416",

                "SMID": "1",

                "COUNTRY": "",

                "CONTINENT": "欧洲1",

                "SMAREA": "6.243427603572511E10",

                "SMGEOPOSITION": "290488320",

                "COLORID": "1",

                "SMPERIMETER": "5196430.901327391",

                "SQMI": "23903.1",

                "SMGEOMETRYSIZE": "35816",

                "CAPITAL": "",

                "COLOR_MAP": "1",

                "SMSDRIE": "33.637497",

                "SMUSERID": "0"

            },

            "type": "Feature"

        }

    ]

创建成功的情况下，得到 rjson 格式的操作结果表述如下：

{
    "postResultType": "CreateChild",
    "newResourceID": "9df3b263e93140a4ad55483e1f8f796e_62c9f50b14864e479436a519ffa14d98",
    "succeed": true,
    "newResourceLocation": "http://localhost:8091/iserver/services/data-World/rest/data/featureResults/9df3b263e93140a4ad55483e1f8f796e_62c9f50b14864e479436a519ffa14d98.rjson"
}

在这里插入图片描述

3.3修改要素

对 URI：http://ip:端口号/iserver/services/data-World/rest/data/datasources/World/datasets/Countries/features.rjson?_method=PUT 执行POST 请求，修改几何对象，在请求体中包含如下参数：

  [

    {

        "fieldNames": [

            "SMID",

            "SMSDRIW",

            "SMSDRIN",

            "SMSDRIE",

            "SMSDRIS",

            "SMUSERID",

            "SMAREA",

            "SMPERIMETER",

            "SMGEOMETRYSIZE",

            "SQKM",

            "SQMI",

            "COLOR_MAP",

            "CAPITAL",

            "COUNTRY",

            "POP_1994",

            "CONTINENT"

        ],

        "fieldValues": [

            "22",

            "-7.433472633361816",

            "62.35749816894531",

            "-6.38972282409668",

            "61.388328552246094",

            "6",

            "0.25430895154659083",

            "5.743731026651685",

            "4500",

            "1474.69",

            "569.38",

            "5",

            "示例首都",

            "示例国家",

            "47067.0",

            "欧洲"

        ],

        "geometry": {

            "id": 22,

            "parts": [

                3

            ],

            "points": [

                {

                    "x": -40,

                    "y": 60

                },

                {

                    "x": -45,

                    "y": 70

                },

                {

                    "x": -40,

                    "y": 55

                },

                {

                    "x": -40,

                    "y": 60

                }

            ],

            "style": null,

            "type": "REGION",

            "prjCoordSys":null

        }

    }

]

修改成功的情况下，得到 rjson 格式的操作结果表述如下：

{"succeed": true}

在这里插入图片描述

kk_ramble
关注
  • 21
    点赞
  • 踩
  • 20
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
Rest API --如何设计好一个Delete方法的API
圆师傅的博客
11-09 284
由于Rest API的设计风格，我们是对resource进行CRUD，与之相对应的HTTP方法，也就有GET、POST、PUT、DELETE。 使用DELETE方法，表明对一个资源进行删除操作。
“一把梭：REST API 全用 POST” restful api post、get 、put 、delete选择
qq_31686241的博客
09-11 2679
restful api post、get 、put 、delete选择
REST统一接口 GET PUT DELETE POST
孤竹的博客
04-19 5786
幂等性：idempotence 指外系统对同一REST接口的多次访问，得到的资源状态是相同的。 1、GET 方法 REST使用HTTP的GET方法获取服务提供的资源。GET方法是只读的。他是幂等和安全的。 @GET方法注释对资源方法定义，使得该方法用于处理GET请求。
Java RestTemplate中几种常见的请求方式
hudeyong926的专栏
03-11 1万+
在REST接口的设计中，利用RestTemplate进行接口测试是种常见的方法。本文主要从以下四个方面来看RestTemplate的使用： GET请求 POST请求 PUT请求 DELETE请求 OK，开始吧。 1. 用exchange方法提交 exchange既可以执行POST方法，还可以执行GET，设置header，所以应用最为广泛。 String url = "http://localhost/mirana-ee/app/login"; RestTemplate client = ne
RESTful API GET，DELETE，PUT和POST的典型用法
Daioo 随笔
07-02 7879
GET 安全且幂等 获取表示 变更时获取表示（缓存） 200（OK） - 表示已在响应中发出 204（无内容） - 资源有空表示 301（Moved Permanently） - 资源的URI已被更新 303（See Other） - 其他（如，负载均衡） 304（not modified）- 资源未更改（缓存） 400 （bad request）- 指代坏请求（如，参数错误） 404 （...
Geoserver+openlayer+postGis要素增删改查
02-18
"Geoserver+openlayer+postGis要素增删改查"是一个综合性的项目，它结合了三个关键组件：PostGIS、GeoServer和OpenLayers，来实现这一目标。下面将详细介绍这三个组件及其相互作用。 1. **PostGIS**： PostGIS 是 ...
esri2sf:从 ArcGIS Server REST API 抓取要素并创建简单的要素数据框
05-29
该软件包使用户能够通过服务器的 REST API 从 R 中抓取 ArcGIS Server 中的矢量数据。 它从 ArcGIS Server 下载地理并将其保存为 。这个怎么运作该程序向 ArcGIS Server 发送请求，并获取 json 响应，其中包含格式...
REST API_02.docx
09-15
REST API，全称为Representational State Transfer，是一种设计Web服务的应用架构风格，旨在提供轻量级、高效且可扩展的接口。REST API的核心理念是将互联网上的资源作为独立的实体，并通过HTTP协议中的方法来操作...
ArcGIS 10.1 SOE 图形增删改查
09-11
在"MetaDataRestSOE"这个文件中，很可能包含了一个实现元数据REST服务的SOE示例，它可能提供了通过RESTful API对图形元数据进行增删改查的能力。元数据是描述地理数据的重要信息，包括数据的来源、用途、精度等，...
Http协议的Delete和Put方法是做什么的？怎么用？
热门推荐
碧荷故乡_胡奇的专栏
01-08 10万+
一般来说，Web服务器默认的只支持Post和Get这两种“只读”的请求方法。但是随着Ajax XMLHttpRequest 和 REST风格应用的深入，我们发现Http 1.1协议还支持如下请求方法（Request Method）：OPTIONSHEADDELETEPUTTRACECONNECTGet是最常用的，就
Restful风格API接口开发springMVC篇
weixin_30897079的博客
09-12 4703
Restful风格的API是一种软件架构风格，设计风格而不是标准，只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。 在Restful风格中，用户请求的url使用同一个url而用请求方式：get，post，delete，put...等方式对请求的处理方法进行区分，这样可以在前后台分离式的开发中使得前...
WebApi(1) 4大方法初探 get、post、put、delete
weixin_33724659的博客
02-10 291
1.新建一个webapi项目 2.新建一个 "webapi 控制器类" 3.修改 Web API 路由 routeTemplate: "api/{controller}/{id}" 修改为:routeTemplate: "api/{controller}/{action}/{id}" webapi控制器代码 public class ApiDemoControl...
RESTful Web 服务四种操作POST/DELETE/PUT/GET
john548的专栏
08-25 3万+
关于REST及RESTful的概念，已有不少文章介绍，这里整理几篇我觉得不错的参考: 维基百科的定义: REST什么是REST跟RESTful? REST理论的中文详述，其中你可以了解到WCF Restful属于RPC 样式的 Web 服务，ASP.NET Web API属于RESTful Web 服务。深入浅出REST InfoQ的专文介绍，文中甚至有Roy T. Fielding当年RE
Restful web 服务四种操作post/delete/put/get 区别
Jam_T的博客
09-13 6046
Http请求主要由以下几种请求方式 post,get,put,delete post：请求体在body里面 get：请求在链接后面 put：请求方式和post一样 delete：请求方式和post一样 但是，既然请求方式一样，为什么还要区分post和put呢？ 原因： 后端接收到post请求还可以转发请求到其他地址，而put请求不允许转发! 学术上讲就是： ...
为什么要用Put/Delete接口：Restful API简介
风流倜傥唐伯虎的博客
01-28 2259
博客文章 Articles 嗖嗖搜 Dwg 友链 Friends 一枚萌新 About 文章目录 前言HTTP/1.1的八种方法Rest和Restful API1、资源和表述2、资源的链接3、状态和转移4、状态码 为什么要用Put/Delete接口：Restful API简介 最后更新于2018年11月15日 /7198次浏览 /2次点赞 /0条评论 PATCH，Restful API 前言 最近发现小伙伴们写的API不仅仅有Get/Post，还有大量的Put...
REST方式配置put，delete请求方式
sdzhangshulong的博客
03-21 1963
1.配置HiddenHttpMethodFilter <!-- 配置org.springframework.web.filter.HiddenHttpMethodFilter，可以把POST请求转为DELETE或post请求 --> <filter> <filter-name>HiddenHttpMethodFilter</filter-name...
RESTful接口规范之GET/POST/PUT/DELETE
weixin_42545256的博客
11-25 4990
REST 是Representational State Transfer的缩写，翻译是”表现层状态转化”. 面向资源是REST最明显的特征，对于同一个资源的一组不同的操作。资源是服务器 上一个可命名的抽象概念，资源是以名词为核心来组织的，首先关注的是名词。REST要求，必须通过统一的接口来对资源执行各种操作。对于每个资源只能执行一组有限的操 作。 7个HTTP方法:GET/POST/PUT/DE...
arcgis rest api详解
最新发布
06-03
ArcGIS REST API是Esri公司提供的一种基于HTTP/HTTPS协议的Web API，用于访问和管理ArcGIS Server和ArcGIS Online等GIS服务和资源。ArcGIS REST API支持多种编程语言和平台，例如Java、Python、JavaScript、.NET、iOS和Android等。以下是ArcGIS REST API的一些主要特点和功能： 1. 支持多种HTTP操作：ArcGIS REST API支持多种HTTP操作，例如GET、POST、PUT和DELETE等，可以用于从GIS服务中获取或修改数据。 2. 支持多种数据格式：ArcGIS REST API支持多种数据格式，包括JSON、XML、HTML和二进制等，可以根据需要选择合适的数据格式。 3. 支持多种GIS服务和资源：ArcGIS REST API支持多种GIS服务和资源，例如地图服务、要素服务、空间分析服务、地理编码服务、地理处理服务、Web地图和Web应用程序等。 4. 支持数据查询和过滤：ArcGIS REST API支持对GIS服务中的数据进行查询和过滤，可以根据要求返回符合条件的数据。 5. 支持安全认证和授权：ArcGIS REST API支持多种安全认证和授权方式，例如基本认证、令牌认证和OAuth2.0认证等，可以保证GIS服务和资源的安全性和可靠性。 6. 支持跨域访问：ArcGIS REST API支持跨域访问，可以在不同的域名和网站之间进行数据交互和共享。 7. 支持自定义扩展：ArcGIS REST API支持自定义扩展，可以根据需要扩展和定制GIS服务和资源的功能和特性。 总之，ArcGIS REST API是Esri公司提供的一种基于HTTP/HTTPS协议的Web API，用于访问和管理ArcGIS Server和ArcGIS Online等GIS服务和资源，具有多种特点和功能，可以满足不同用户的需求和要求。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值