dataset


URI

<datasets_uri>/{datasetName}[.<format>]

支持的方法

GETDELETEHEAD

父资源

datasets

子资源

fields

介绍

dataset 资源表示一个数据集,通过对 dataset 资源执行 GET 请求可以获得该数据集({datasetName})的描述信息,通过  DELETE 请求可以删除该数据集。

支持的方法:

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

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datasets/{datasetName}.rjson

GET 请求

获取数据集的详细信息。

响应结构

对 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

}

DELETE 请求

删除某个数据集。

响应结构

对 dataset 资源执行 DELETE 请求,删除该数据集,返回的操作结果的表述如下:

字段 类型 说明
succeed boolean 删除数据集是否成功
error HttpError 出错信息,如果操作成功,则没有本字段。

示例

对示例 dataset 资源:http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datasets/test.rjson 执行 DELETE 请求,删除 test 数据集,在操作成功的情况下,返回 rjson 格式的表述如下:

{"succeed": true}

HEAD 请求

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

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

请参见