<relationship_uri>/datasets[.<format>]
datasets 资源表示一个数据源中的所有数据集的集合。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datasets.rjson
获取数据源中所有数据集的信息。
对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",
}
创建数据集。
在请求体中需要包含如下参数:
名称 | 类型 | 含义 |
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
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断datasets 资源是否存在,或者客户端是否有权限访问datasets 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断datasets 资源是否支持<format>格式的表述。