dataContent

URI

/content[.<format>]

支持的方法

GET、HEAD

父资源

data

介绍

dataContent 资源是单个数据的内容信息。

支持的方法：

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

资源层次

 

HTTP 请求方法

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

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

GET 请求

获取由数据项 id 指定的数据内容。

请求参数

如果参数未设置，则 Shpfile 类型的数据默认以 GBK 编码格式返回数据内容，GeoJSON 和 CSV 类型的数据默认以 UTF-8 编码格式返回数据内容。设置参数后，会根据用户指定编码格式返回数据的内容信息，请求参数必须包含在 URI 中。

名称 类型 含义
fileEncoding String 【可选参数】
数据的编码格式，目前支持填入"GBK" 、"UTF-8"。

响应结构

对 dataContent 资源执行 GET 请求，返回的资源表述结构如下：

字段 类型 说明
content String 数据内容，目前支持解析 excel、geojson、csv、shp 格式的文件内容。
fileName String 数据的文件名称。
lineNumber Integer

数据表内容的行数，目前支持返回 Excel、CSV 数据表行数。
type DataItemType 数据的类型。

响应示例

对 dataContent 资源：http://127.0.0.1:8190/iportal/web/datas/1823350379/content.json 执行 GET 请求，返回 rjson 格式的资源表述如下：

{

    "fileName": "部分省会.xlsx",

    "type": "EXCEL",

    "lineNumber": 4,

    "content": {

        "colTitles": [

            "省",

            "省会"

        ],

        "rows": [

            [

                "新疆",

                "乌鲁木齐"

            ],

            [

                "西藏",

                "拉萨"

            ],

            [

                "青海",

                "西宁"

            ],

            [

                "甘肃",

                "兰州"

            ]

        ]

    }

}

注意：该示例仅展示了 Excel 数据类型的响应结构，不同数据格式解析的内容结构不同，即 "content" 字段下的内容结构存在差异。

HEAD 请求

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

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

请参见