myData


URI

<myDatas_uri>/{id}[.<format>]

支持的方法

GETPUTDELETEHEAD

父资源

myDatas

子资源

fileUploadfileDownloaduploadProgessfileDigestservicedataShareSetting

介绍

myData 具体数据资源。支持查看、修改和删除操作。

支持的方法:

支持的表述格式:RJSON、JSON、XML。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiportal 是服务器名。

http://supermapiportal:8090/iportal/web/mycontent/datas/{id}.rjson

GET 请求

获取由数据项 id 指定的数据信息。

响应结构

对 myData 资源执行 GET 请求,返回的资源表述结构如下:

字段

类型 说明

userName

String 数据上传者名称。
type DataItemType 文件类型。可以为 AUDIO(音频文件)、MBTILES、PHOTOS(照片)、SMTILES、SVTILES、TPK、UDB、UGCV5、VIDEO(视频文件)、WORKSPACE(工作空间,即由文件后缀名为 *. sxwu、*. smwu、*.  sxw 或 *.  smw 的工作空间数据压缩而成的 zip 包)或 UNKNOWN(除前面列举的文件类型外,其它所有文件类型)。
fileName String 文件名称。
size int 文件大小,单位为 B 。
serviceStatuses ServiceStatus[] 服务发布状态。
serviceId String 服务 id 。
id Integer 数据项 id 。
lastModfiedTime Date 最后修改时间。
status Status 文件状态。
storageId String 数据文件存储 id 。
publishInfo DataPublishInfo 数据的发布信息。
authorizeSetting List<IportalDataAuthorizeEntity> 数据的权限信息。
nickname String 用户的昵称。
tags List<String> 数据的标签。
description String 数据的描述信息。
dataItemServices List<DataServiceInfo> 数据发布的服务信息集合。
coordType DataCoordType 数据坐标类型。
thumbnail String 数据的缩略图路径。

响应示例

对 myData 资源:http://localhost:8090/iportal/web/mycontent/datas/3.rjson 执行 GET 请求,返回的 rjson 格式的资源表述如下:

{

    "authorizeSetting": [

        {

            "aliasName": "admin",

            "dataPermissionType": "DELETE",

            "entityId": null,

            "entityName": "admin",

            "entityType": "USER"

        }

    ],

    "coordType": null,

    "dataItemServices": [

        {

            "accessCount": 0,

            "address": "http://192.168.112.217:8090/iserver/services/map_ChengShi04072/rest",

            "createTime": null,

            "dataID": 3,

            "serviceID": "map_ChengShi04072",

            "serviceName": null,

            "serviceNode": "ps379vhe",

            "serviceStatus": "PUBLISHED",

            "serviceType": "RESTMAP",

            "updateTime": null

        },

        {

            "accessCount": 0,

            "address": "http://192.168.112.217:8090/iserver/services/data_ChengShi04072/rest",

            "createTime": null,

            "dataID": 3,

            "serviceID": "data_ChengShi04072",

            "serviceName": null,

            "serviceNode": "ps379vhe",

            "serviceStatus": "PUBLISHED",

            "serviceType": "RESTDATA",

            "updateTime": null

        }

    ],

    "description": null,

    "fileName": "城市0407.zip",

    "id": 3,

    "lastModfiedTime": 1461224737624,

    "nickname": "admin",

    "publishInfo": null,

    "serviceId": null,

    "serviceStatus": "PUBLISHED",

    "size": 19604468,

    "status": "OK",

    "storageId": "Aiportal_g5mbqjsv_0e01875b_9b4e_4aeb_8419_71e3af586807",

    "tags": [],

    "thumbnail": null,

    "type": "WORKSPACE",

    "userName": "admin"

}

 PUT 请求

更新由数据项 id 指定的数据信息。

请求参数

发送请求时,需要在请求体中传递如下参数:

名称 类型 含义
fileName String 文件名。
type DataItemType 文件类型。可以为 AUDIO(音频文件)、MBTILES、PHOTOS(照片)、SMTILES、SVTILES、TPK、UDB、UGCV5、VIDEO(视频文件)、WORKSPACE(工作空间,即由文件后缀名为 *. sxwu、*. smwu、*.  sxw 或 *.  smw 的工作空间数据压缩而成的 zip 包)或 UNKNOWN(除前面列举的文件类型外,其它所有文件类型)。
tags List<String> 数据的标签。
description String 数据的描述信息。

响应结构

返回的资源表述结构如下:

字段

类型 说明

succeed

boolean 是否成功修改数据。true 代表修改成功,反之,则代表修改失败。
newResourceID Integer 新创建数据资源 id ,值与请求中的数据项 id 相同。

响应示例

修改指定的已上传数据的名称,对 myData 资源:http://localhost:8090/iportal/web/mycontent/datas/1.rjson 执行 PUT 请求,发送请求体如下:

{

    "fileName": "China400_1.zip",

    "type": "WORKSPACE",

    "tags":[],

    "description":null

}

则返回的 rjson 格式响应结果如下:

{

    "succeed": true,

    "newResourceID": "1"

}

DELETE 请求

删除由数据项 id 指定的数据信息,包括数据项和数据文件。

响应结构

返回的资源表述结构如下:

字段

类型 说明

succeed

boolean 是否成功删除数据,true 代表删除成功,反之,则代表删除失败。

响应示例

对 myData 资源:http://localhost:8090/iportal/web/mycontent/datas/1.rjson 执行 DELETE 请求,返回的 rjson 格式响应结果如下:

{ "succeed": true}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。

HEAD 请求可以用来判断 myData 资源是否存在,或者客户端是否有权限访问 myData 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 myData 资源是否支持<format>格式的表述。

请参见