<dataset_uri>/domain[.<format>]
domain资源描述了字段的值域信息。domain资源中包含当前数据集下所有设置了值域的字段,以及这些字段的值域信息(即取值范围),包括字段的名称、字段类型、值域类型和值域等。
值域类型包括CODE和RANGE两种类型。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/data-jingjin/rest/data/datasources/Jingjin/datasets/Landuse_R/domain.rjson
获取字段的值域信息。通过GET请求可获取到字段的名称、字段类型、值域类型以及值域等信息。
无
返回当前数据集中所有字段的值域信息,是由各字段值域信息组成的一个数组。其中每个字段值域信息的响应结构如下:
字段 | 类型 | 说明 |
discription | String | 值域的描述信息 |
name | String | 值域的名称 |
FieldName | String | 字段的名称 |
Type | DomainType | 值域类型 |
ValueType | FieldType | 值域的数据类型 |
codeCount | int | 枚举的元素个数。当值域类型为CODE类型时,将返回该字段。 |
codeInfo | CodeInfo[] | 枚举的内容描述。当值域类型为CODE类型时,将返回该字段。 |
rangeCount | int | 范围域的个数。当值域类型为RANGE类型时,将返回该字段。 |
rangeInfos | RangeInfo[] | 范围域内容的描述。当值域类型为RANGE类型时,将返回该字段。 |
其中, codeInfo 字段表示具体的枚举内容,结构可参见 CodeInfo 类,具体参数如下:
字段 | 类型 | 说明 |
value | String | 枚举值,即字段的取值仅限在枚举范围内的几个值。 |
valueType | FieldType | 枚举值的字段类型。 |
rangeInfo 字段表示指定的取值范围,结构可参见 RangeInfo 类,具体参数如下:
字段 | 类型 | 说明 |
max | String | 指定的取值范围的最大值。 |
min | String | 指定的取值范围的最小值。 |
type | RangeType | 取值范围的区间类型。例如:
CLOSE_CLOSE,表示闭区间,形如:[min,max],即大于等于最小值,小于等于最大值; CLOSE_OPEN,左闭右开区间,形如:[min,max),即大于等于最小值,小于最大值。 |
valueType | FieldType | 枚举值的字段类型。 |
对domain资源执GET请求:
http://localhost:8090/iserver/services/data-jingjin/rest/data/datasources/Jingjin/datasets/Landuse_R/domain.rjson
则返回的结果如下:
[
{
"codeCount": 11,
"codeInfos": [
{
"value": "城市",
"valueType": "TEXT"
},
{
"value": "旱地",
"valueType": "TEXT"
},
{
"value": "水浇地",
"valueType": "TEXT"
},
{
"value": "水田",
"valueType": "TEXT"
},
{
"value": "沙漠",
"valueType": "TEXT"
},
{
"value": "沼泽",
"valueType": "TEXT"
},
{
"value": "湖泊水库",
"valueType": "TEXT"
},
{
"value": "灌丛",
"valueType": "TEXT"
},
{
"value": "用材林",
"valueType": "TEXT"
},
{
"value": "经济林",
"valueType": "TEXT"
},
{
"value": "草地",
"valueType": "TEXT"
}
],
"description": "",
"fieldName": "LANDTYPE",
"name": "LANDTYPE",
"type": "CODE",
"valueType": "TEXT"
},
{
"description": "",
"fieldName": "Area",
"name": "Area",
"rangeCount": 1,
"rangeInfos": [{
"max": "999999.0",
"min": "0.0",
"type": "CLOSE_OPEN",
"valueType": "SINGLE"
}],
"type": "RANGE",
"valueType": "SINGLE"
}
]
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断domain资源是否存在,或者客户端是否有权限访问domain资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断domain资源是否支持<format>格式的表述。