<datasets_uri>/{datasetName}[.<format>]
dataset 资源表示一个数据集,通过对 dataset 资源执行 GET 请求可以获得该数据集({datasetName})的描述信息。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/spatiotemporal/datasets/{datasetName}.rjson
获取某个数据集的描述信息。
无
对 dataset 资源执行 GET 请求,返回的资源表述的结构如下:
字段 | 类型 | 说明 |
datasetInfo | DatasetInfo | 数据集详细信息。 |
childUriList | List<String> | 子资源列表。 |
supportAttachments | boolean | 是否支持附件功能。 |
supportFeatureMetadatas | boolean | 是否支持获取元信息功能。 |
其中数据集详细信息,即 DatasetInfo 的结构如下:
字段 | 类型 | 说明 |
name | String | 数据集名称,数据集的唯一标识。 该标识不区分大小写。 |
description | String | 数据集的描述信息。 |
type | DatasetType | 数据集类型。
目前版本支持的数据集类型包括纯属性表数据集、点数据集、EPS点数据集、线数据集、EPS线数据集、面数据集、EPS面数据集、文本数据集、EPS文本数据集、复合数据集(CAD 数据集)等矢量数据集(DatasetVector),格网数据集(DatasetGrid),影像数据集(DatasetImage),以及网络数据集(DatasetNetwork)。 |
bounds | Rectangle2D | 数据集范围。
对于矢量数据集来说,bounds 为数据集中所有对象的最小外接矩形;对于栅格,bounds 为当前格网或影像的地理范围。 |
dataSourceName | String | 该数据集对象所属的数据源名称。 |
encodeType | EncodeType | 数据集存储时的压缩编码方式。 |
isReadOnly | boolean | 数据集是否为只读。 |
prjCoordSys | PrjCoordSys | 数据集的投影信息。 |
tableName | String | 表名。
对数据库型数据源,指此数据集在数据库中所对应的数据表名称;对文件型数据源,指此数据集存储属性的表名称(文件型数据源文件用.sdb 文件存储空间数据,.sdd 文件存储属性数据)。 |
charset | Charset | 矢量数据集的字符集。仅当 dataset 资源标识的是矢量数据集时存在。 |
isFileCache | boolean | 是否使用文件形式的缓存。仅对数据库型数据源中的矢量数据集有效。 |
recordCount | int | 矢量数据集中的记录数。 仅当 dataset 资源标识的是矢量数据集时存在。 |
对示例 dataset 资源:http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/spatiotemporal/datasets/tuit.rjson 执行 GET 请求,返回 表述如下:
{
"childUriList": [],
"datasetInfo": {
"bounds": {
"bottom": 0,
"left": 0,
"leftBottom": {
"x": 0,
"y": 0
},
"right": 0,
"rightTop": {
"x": 0,
"y": 0
},
"top": 0
},
"charset": "DEFAULT",
"dataSourceName": "supermap_es",
"datasourceConnectionInfo": {
"alias": "supermap_es",
"connect": true,
"dataBase": "",
"driver": "Elasticsearch ANSI",
"engineType": "ES",
"exclusive": false,
"openLinkTable": false,
"password": "",
"readOnly": false,
"server": "192.168.112.100:9200",
"user": ""
},
"description": "",
"encodeType": "NONE",
"isFileCache": false,
"isReadOnly": false,
"name": "tuit",
"prjCoordSys": {
"coordSystem": null,
"coordUnit": "METER",
"distanceUnit": "METER",
"epsgCode": -1000,
"name": "Planar Coordinate System---m",
"projection": null,
"projectionParam": null,
"type": "PCS_NON_EARTH"
},
"recordCount": 0,
"tableName": "",
"type": "POINT"
},
"supportAttachments": false,
"supportFeatureMetadatas": false
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 dataset 资源是否存在,或者客户端是否有权限访问 dataset 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 dataset 资源是否支持<format>格式的表述。