data


URI

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

支持的方法

GETHEAD

父资源

datas

子资源

fileDownloaddataAttributesdataDatasetsdataContent

介绍

data 资源是单个数据资源信息。

支持的方法:

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

资源层次

HTTP 请求方法

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

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

GET 请求

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

响应结构

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

字段 类型 说明
MD5 String 数据的 MD5 值。
authorizeSetting List<IportalDataAuthorizeEntity> 数据的权限信息。
coordType DataCoordType 数据的坐标类型。
createTime Long 数据的创建时间,即上传时间。
dataCheckResult DataCheckResult 数据以及对应的服务的检测结果。
dataItemServices List<DataServiceInfo> 数据发布的服务信息集合。
dataMetaInfo DataMetaInfo 数据的元信息。
description String 数据的描述信息。
fileName String 数据的文件名称。
id Integer 数据项的 id。
lastModfiedTime Long 数据的最后修改时间。
nickname String 数据上传者的昵称。
publishInfo DataPublishInfo 该参数已过期,数据的发布信息。
serviceId String 该参数已过期,建议使用 dataItemServices 属性逐个获取服务 id 信息。
serviceStatus ServiceStatus 该参数已过期,建议使用 dataItemServices 逐个获取服务状态信息。
size long 数据文件的大小。
status Status 数据的状态。
storageId String 数据文件的存储 id。
tags List<String> 数据的标签。
thumbnail String 数据的缩略图路径。
type DataItemType 数据的类型。
userName String 数据上传者的名称。

响应示例

对 data 资源:http://localhost:8190/iportal/web/datas/1.rjson 执行 GET 请求,返回 rjson 格式的资源表述如下:

{

    "MD5": "4c3abec6c3c6e6c4d1f9604ae7dca661",

    "authorizeSetting": [],

    "coordType": null,

    "createTime": 1494913645957,

    "dataCheckResult": {

        "dataCheckInfo": null,

        "serviceCheckInfos": []

    },

    "dataItemServices": [],

    "dataMetaInfo": null,

    "description": null,

    "fileName": "osgb0805.zip",

    "id": 1,

    "lastModfiedTime": 1494913645957,

    "nickname": "admin",

    "publishInfo": null,

    "serviceId": null,

    "serviceStatus": "UNPUBLISHED",

    "size": 63594049,

    "status": "OK",

    "storageId": "s670412d_f17ak8go_b512d612_5838_45c3_bd89_e3763c7a2c76",

    "tags": [],

    "thumbnail": null,

    "type": "WORKSPACE",

    "userName": "admin"

}

HEAD 请求

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

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

请参见