datasets

URI

<relationship_uri>/datasets[.<format>]

支持的方法

GET、POST、HEAD

父资源

relationship

子资源

dataset

介绍

datasets 资源表示一个数据源中的所有数据集的集合。

支持的方法：

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

资源层次

HTTP 请求方法

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

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

GET 请求

获取数据源中所有数据集的信息。

响应结构

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

字段 类型 说明

childUriList

 List<String> 数据集名称对应的URL，即其子资源(dataset 资源)的访问路径。
datasetCount int 数据集的个数

datasetNames

 String 数据集名称

响应示例

对datasets资源：http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datasets.rjson 执行 GET 请求，返回 rjson 格式的资源描述如下：

{

  "childUriList": "http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datasets/newyorkZone_R_816363505,   http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datasets/singleRegion_R_1623065691",

  "datasetCount":" 2",

  "datasetNames": "newyorkZone_R_816363505, singleRegion_R_1623065691",

}

POST 请求

创建数据集。

请求参数

在请求体中需要包含如下参数：

名称 类型 含义
name String 数据集名称（必填）
type String 数据集类型（必填）
charset String 数据集字符格式

isFileCache

 boolean 是否是使用文件形式的缓存

description

 String 对数据集描述信息

prjCoordSys

 String 坐标系信息

响应结构

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

字段 类型 说明
newResourceID String 新创建的数据集资源的 ID。

newResourceLocation

 String 新创建的数据集资源的 URI。

postResultType

 String 表示子资源。

succeed

 boolean 创建数据集是否成功。

响应示例

对datasets资源：http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datasets.rjson 执行 POST 请求，请求体参数如下：

{   

     "prjCoordSys":

               {

                "distanceUnit":"METER",

                "projectionParam":null,

                "epsgCode":4326,

                "coordUnit":"DEGREE",

                "name":"Longitude / Latitude Coordinate System---GCS_WGS_1984",

                "projection":null,

                "type":"PCS_EARTH_LONGITUDE_LATITUDE",

                "coordSystem":

                      {"datum":

                            {

                             "name":"D_WGS_1984",

                             "type":"DATUM_WGS_1984",

                             "spheroid":

                                    {"flatten":0.00335281066474748,

                                     "name":"WGS_1984", "axis":6378137,

                                     "type":"SPHEROID_WGS_1984"

                                    }

                              },

                        "unit":"DEGREE",

                        "spatialRefType":"SPATIALREF_EARTH_LONGITUDE_LATITUDE",

                        "name":"GCS_WGS_1984", "type":"GCS_WGS_1984",

                        "primeMeridian":

                            {

                              "longitudeValue":0,

                              "name":"Greenwich",

                              "type":"PRIMEMERIDIAN_GREENWICH"

                            }

                       }

                  },

     "name":"test1",

     "type":"POINT",

     "charset":"",

      "isFileCache":"",

      "description":""

}

返回 rjson 格式的操作结果表述如下：

{

    "newResourceID": "/test1",

    "newResourceLocation": "http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datasets/test1.json",

    "postResultType": "CreateChild",

    "succeed": True

}

HEAD 请求

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

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

请参见