<datasets_uri>/{datasetName}[.<format>]
dataset 资源表示一个数据集,通过对 dataset 资源执行 GET 请求可以获得该数据集({datasetName})的描述信息,通过 DELETE 请求可以删除该数据集。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/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/relationship/datasets/test.rjson 执行 GET 请求,返回 表述如下:
{
"childUriList": [],
"datasetInfo": {
"bounds": {
"bottom": 0,
"left": 0,
"leftBottom": {
"x": 0,
"y": 0
},
"right": 0,
"rightTop": {
"x": 0,
"y": 0
},
"top": 0
},
"charset": "UTF8",
"dataSourceName": "supermap1_pg",
"datasourceConnectionInfo": {
"alias": "supermap1_pg",
"connect": false,
"dataBase": "supermap1",
"driver": "PostgreSQL ANSI",
"engineType": "POSTGRESQL",
"exclusive": false,
"openLinkTable": false,
"password": "supermap",
"readOnly": false,
"server": "169.254.51.25",
"user": "postgres"
},
"description": "",
"encodeType": "NONE",
"isFileCache": false,
"isReadOnly": false,
"name": "test",
"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": "SMDTV_1",
"type": "POINT"
},
"supportAttachments": false,
"supportFeatureMetadatas": false
}
删除某个数据集。
对 dataset 资源执行 DELETE 请求,删除该数据集,返回的操作结果的表述如下:
字段 | 类型 | 说明 |
succeed | boolean | 删除数据集是否成功 |
error | HttpError | 出错信息,如果操作成功,则没有本字段。 |
对示例 dataset 资源:http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datasets/test.rjson 执行 DELETE 请求,删除 test 数据集,在操作成功的情况下,返回 rjson 格式的表述如下:
{"succeed": true}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 dataset 资源是否存在,或者客户端是否有权限访问 dataset 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 dataset 资源是否支持<format>格式的表述。