<sharefile_uri>/{datasetName}[.<format>]
dataset 资源表示一个数据集,通过对 dataset 资源执行 GET 请求可以获得该数据集的描述信息。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/sharefile/d2_World_Capitals.rjson
获取数据集详细信息。
对 dataset 资源执行 GET 请求,返回的资源表述的结构如下:
字段 | 类型 | 说明 |
bounds | String | 数据集范围。当数据文件类型为“UDB” 时返回此参数。 |
datasetName | String | 数据集名称。当数据文件类型为“UDB” 时返回此参数。 |
datasetType | DatasetType | 数据集类型。当数据文件类型为“UDB” 时返回此参数。 |
epsgCode | int | 数据集投影。当数据文件类型为“UDB” 时返回此参数。 |
name | String | 数据名称。数据注册到 iServer 时,iServer 将为注册成功的数据集重新命名,名称结构为“存储ID_数据源名_数据集名”。 |
readOnly | boolean | 数据集是否为只读。当数据文件类型为“UDB” 时返回此参数。 |
type | BigDataFileShareDatasetInfoType | 数据文件的类型。包括 CSV 和 UDB 数据。 |
url | String | 数据文件的存放路径。 |
xIndex | int | X索引。iServer 将根据索引获取 x 方向上的所有数据。当数据文件类型为“CSV” 时返回此参数。 |
yIndex |
int | Y索引。iServer 将根据索引获取 y 方向上的所有数据。当数据文件类型为“CSV” 时返回此参数。 |
separator |
String | CSV 文件的分隔符。当数据文件类型为“CSV” 时返回此参数。 |
对 dataset 资源:http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/sharefile/d2_World_Capitals.rjson 执行 GET 请求,返回 World_Capitals 数据集的表述如下(World_Capitals 数据集是矢量数据集):
{
"bounds": "Left=-175.24565064968198,Bottom=-41.33484005165742,Right=179.22188736363634,Top=64.13499891788544",
"datasetName": "Capitals",
"datasetType": "POINT",
"epsgCode": 4326,
"name": "d2_World_Capitals",
"readOnly": false,
"type": "UDB",
"url": "E:\\supermap_packages\\data\\World\\World.udb"
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 dataset 资源是否存在,或者客户端是否有权限访问 dataset 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 dataset 资源是否支持<format>格式的表述。