<myDatas_uri>/{id}[.<format>]
fileUpload、fileDownload、uploadProgess、fileDigest、service、dataShareSetting
myData 具体数据资源。支持查看、修改和删除操作。
支持的方法:
支持的表述格式:RJSON、JSON、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiportal 是服务器名。
http://supermapiportal:8090/iportal/web/mycontent/datas/{id}.rjson
获取由数据项 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"
}
更新由数据项 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"
}
删除由数据项 id 指定的数据信息,包括数据项和数据文件。
响应结构
返回的资源表述结构如下:
字段 |
类型 | 说明 |
succeed |
boolean | 是否成功删除数据,true 代表删除成功,反之,则代表删除失败。 |
响应示例
对 myData 资源:http://localhost:8090/iportal/web/mycontent/datas/1.rjson 执行 DELETE 请求,返回的 rjson 格式响应结果如下:
{ "succeed": true}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 myData 资源是否存在,或者客户端是否有权限访问 myData 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 myData 资源是否支持<format>格式的表述。