<myDatas_uri>/{id}[.<format>]
fileUpload、fileDownload、uploadProgess、fileDigest、service、dataShareSetting、publishStatus、dataDatasetSimpleData、hdfsVerify、dataUpdate
myData 具体数据资源。支持查看、修改和删除操作。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiportal 是服务器名。
http://supermapiportal:8190/iportal/web/mycontent/datas/{id}.rjson
获取由数据项 id 指定的数据信息。
对 myData 资源执行 GET 请求,返回的资源表述结构如下:
字段 |
类型 | 说明 |
userName |
String | 数据上传者名称。 |
type | DataItemType | 文件类型。可以为 WORKSPACE(工作空间,即由文件后缀名为 *. sxwu、*. smwu、*. sxw 或 *. smw 的工作空间数据压缩而成的 zip 包)、SMTILES、SVTILES、MBTiles、TPK、UDB、UGCV5、Excel 数据、CSV 数据等类型。 |
fileName | String | 文件名称。 |
size | int | 文件大小,单位为 B 。 |
id | Integer | 数据项 id 。 |
lastModfiedTime | Date | 最后修改时间。 |
status | Status | 文件状态。 |
storageId | String | 数据文件存储 id 。 |
authorizeSetting | List<IportalDataAuthorizeEntity> | 数据的权限信息。 |
nickname | String | 用户的昵称。 |
tags | List<String> | 数据的标签。 |
description | String | 数据的描述信息。 |
dataItemServices | List<DataServiceInfo> | 数据发布的服务信息集合。 |
coordType | DataCoordType | 数据坐标类型。 |
thumbnail | String | 数据的缩略图路径。 |
createTime | Long | 数据的创建时间,即上传时间。 |
dataMetaInfo | DataMetaInfo | 数据的元信息。 |
downloadCount | Long | 数据的下载次数统计信息。 |
MD5 | String | 数据的 MD5 值。 |
dataCheckResult | DataCheckResult | 数据以及对应服务的检测结果。 |
对 myData 资源:http://localhost:8190/iportal/web/mycontent/datas/672142608.rjson 执行 GET 请求,返回的 rjson 格式的资源表述如下:
{
"MD5": "c71d848955786c54cb072c2bfad6dc64",
"authorizeSetting": [
{
"aliasName": "admin",
"dataPermissionType": "DELETE",
"entityId": null,
"entityName": "admin",
"entityRoles": null,
"entityType": "USER"
},
{
"aliasName": "GUEST",
"dataPermissionType": "DOWNLOAD",
"entityId": null,
"entityName": "GUEST",
"entityRoles": null,
"entityType": "USER"
}
],
"coordType": "WGS84",
"createTime": 1514860737401,
"dataCheckResult": {
"dataCheckInfo": null,
"serviceCheckInfos": []
},
"dataItemServices": [],
"dataMetaInfo": {
"baseLayerType": null,
"bounds": "",
"epsgCode": 0,
"fileEncoding": null,
"previewURL": "",
"providers": "",
"proxiedServiceType": null,
"proxiedServiceUrl": null,
"realspaceType": null,
"releaseTimeMilli": 0,
"xField": "纬度",
"yField": "纬度"
},
"description": "",
"downloadCount": 0,
"fileName": "中国5A级景区数据.xlsx",
"id": 672142608,
"lastModfiedTime": 1514860786733,
"nickname": "admin",
"publishInfo": null,
"serviceId": null,
"serviceStatus": "UNPUBLISHED",
"size": 26639,
"status": "OK",
"storageId": "uwwj74jj_ejka135u_ec4bd16f_0f3b_41b1_b107_c07fe03c2b25",
"tags": [
"旅游"
],
"thumbnail": "${iportalDirectoryServicesRootUrl}/../services/../web/static/portal/img/map/cloud.png",
"type": "EXCEL",
"userName": "admin"
}
更新由数据项 id 指定的数据信息。
请求参数
发送请求时,需要在请求体中传递如下参数:
名称 | 类型 | 含义 |
fileName | String | 文件名。 |
type | DataItemType | 文件类型。可以为 WORKSPACE(工作空间,即由文件后缀名为 *. sxwu、*. smwu、*. sxw 或 *. smw 的工作空间数据压缩而成的 zip 包)、SMTILES、SVTILES、MBTiles、TPK、UDB、UGCV5、Excel 数据、CSV 数据等类型。 |
tags | List<String> | 数据的标签。 |
description | String | 数据的描述信息。 |
thumbnail | String | 数据的缩略图。 |
dataMetaInfo | DataMetaInfo | 数据的元信息。 |
authorizeSetting | List<IportalDataAuthorizeEntity> | 数据的权限信息。 |
响应结构
返回的资源表述结构如下:
字段 |
类型 | 说明 |
succeed |
boolean | 是否成功修改数据。true 代表修改成功,反之,则代表修改失败。 |
newResourceID | Integer | 新创建数据资源 id ,值与请求中的数据项 id 相同。 |
响应示例
修改指定的已上传数据的描述信息,对 myData 资源:http://localhost:8190/iportal/web/mycontent/datas/672142608.rjson 执行 PUT 请求,发送请求体如下:
{
"fileName": "中国5A级景区数据.xlsx",
"type": "EXCEL",
"tags":[
"旅游"
],
"authorizeSetting": [],
"thumbnail": "",
"dataMetaInfo": {
"baseLayerType": null,
"bounds": "",
"epsgCode": 0,
"fileEncoding": null,
"previewURL": "",
"providers": "",
"proxiedServiceType": null,
"proxiedServiceUrl": null,
"realspaceType": null,
"releaseTimeMilli": 0,
"xField": "纬度",
"yField": "纬度"
},
"description":"旅游数据"
}
则返回的 rjson 格式响应结果如下:
{
"newResourceID": "672142608",
"succeed": true
}
删除由数据项 id 指定的数据信息,包括数据项和数据文件。
响应结构
返回的资源表述结构如下:
字段 |
类型 | 说明 |
succeed |
boolean | 是否成功删除数据,true 代表删除成功,反之,则代表删除失败。 |
响应示例
对 myData 资源:http://localhost:8190/iportal/web/mycontent/datas/672142608.rjson 执行 DELETE 请求,返回的 rjson 格式响应结果如下:
{ "succeed": true}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 myData 资源是否存在,或者客户端是否有权限访问 myData 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 myData 资源是否支持<format>格式的表述。