myData


URI

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

支持的方法

GETPUTDELETEHEAD

父资源

myDatas

子资源

fileUploadfileDownloaduploadProgessfileDigestservicedataShareSettingpublishStatusdataDatasetSimpleDatahdfsVerifydataUpdate

介绍

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

支持的方法:

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

资源层次

HTTP 请求方法

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

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

GET 请求

获取由数据项 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"

}

 PUT 请求

更新由数据项 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

}

DELETE 请求

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

响应结构

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

字段

类型 说明

succeed

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

响应示例

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

{ "succeed": true}

HEAD 请求

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

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

请参见