REST 中 HTTP 请求示例

使用 URI 查询参数：

以 distance 资源为例，根据 REST API，distance 资源的 GET 请求的所有参数都是 URI 查询参数，参数说明如下：

名称 类型 含义
point2Ds Point2D[] 用于量算的点集。
unit Unit 期望返回结果的单位。

则对 distance 资源执行 GET 请求，完整的 HTTP 请求应为：

GET /iserver/services/components-rest/rest/maps/World/distance.rjson?point2Ds=[{"y":26,"x":101},{"y":21,"x":97},{"y":16,"x":103}]&unit=METER HTTP/1.1

Host: supermapiserver:8090

使用请求体参数：

以 datasource 资源为例，根据 REST API，datasource 资源的 PUT 请求的所有参数都是请求体参数，参数说明如下：

名称 类型 含义
description String 数据源描述信息。
coordUnit Unit 坐标单位。
distanceUnit Unit 距离单位。

则对 datasource 资源执行 PUT 请求，完整的 HTTP 请求应为：

PUT /iserver/services/components-rest/rest/data/datasources/name/world.rjson HTTP/1.1

Host: supermapiserver:8090

Content-Length: 84

 

{"coordUnit":"MILE","description":"This is a new description","distanceUnit":"MILE"}

如果以 XML 格式传输请求体，则完整的 HTTP 请求应为：

PUT /iserver/services/components-rest/rest/data/datasources/name/world.rjson HTTP/1.1

Host: supermapiserver:8090

Content-Length: 84

X-RequestEntity-ContentType: application/xml

 

<Object>

        <description>This is a new description</description>

        <coordUnit>MILE</coordUnit>

        <distanceUnit>MILE</distanceUnit>

</Object>

请参见