<summaryRegion_uri>/{JobID}[.<format>]
summaryRegionJob 资源表示一个区域汇总作业。通过对 summaryRegionJob 资源执行 GET 请求,可以获取一个区域汇总作业详细配置信息,可通过 ID 号({jobID}) 来获取。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/spatialanalyst/summaryregion/{jobID}.rjson
获取一个区域汇总作业详细配置信息。
对 summaryRegionJob 资源执行 GET 请求,返回操作结果的结构如下:
字段 | 类型 | 说明 |
id | String | 应用ID。 |
state | SparkJobState | 任务状态。包括执行状态、起止时间、耗时等。 |
setting | SparkJobSetting | 列举当前区域汇总分析任务的详细信息。 |
对 summaryRegionJob 资源执行 GET 请求:http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/spatialanalyst/summaryregion/48508e0b_d4b5_4278_bbde_9e092fe85618.rjson ,则返回的rjson表述结果如下:
{
"id": "48508e0b_d4b5_4278_bbde_9e092fe85618",
"setting": {
"DEFAULT_MASTER_ADRESS": "local[*] ",
"analyst": {
"bounds": "-74.050,40.650,-73.850,40.850",
"fieldResultName": "Sum_LocationIDStandard",
"fields": "LocationID",
"meshSize": "10",
"meshSizeUnit": "Meter",
"meshType": "0",
"standardSummaryFields": "true",
"statisticModes": "Sum",
"sumShape": "true",
"weightedSummaryFields": "false"
},
"appName": "summaryWithinMesh",
"args": [
"--input",
"{\"sliceNum\":20,\"type\":\"udb\",\"info\":[{\"server\":\"E:\\\\data\\\\test\\\\processing.udb\",\"datasetNames\":[\"singleRegion_R\"]}]}",
"--meshType",
"square",
"--meshSize",
"10",
"--sumShape",
"true",
"--bounds",
"-74.050,40.650,-73.850,40.850",
"--meshSizeUnit",
"Meter",
"--standardSummaryFields",
"[LocationID,Sum,Sum_LocationIDStandard]",
"--output",
"{\"server\":\"F:\\\\iserver-code\\\\iserver\\\\etc\\\\iserver-debug\\\\src\\\\test\\\\resources\\\\iserver\\\\processingResultData\\\\Analyst\\\\udbs\\\\14ec67de-c7a5-42e0-9fae-0b9f65b7bf38\",\"datasetName\":\"analystResult\",\"type\":\"udb\"}"
],
"contextSetting": null,
"input": {
"datasetInfo": {
"available": true,
"bounds": "Left=-74.0012189965531,Bottom=40.691422739248694,Right=-73.84588071508979,Top=40.84578668020041",
"datasetName": "singleRegion_R",
"datasetType": "REGION",
"epsgCode": 4326,
"name": "test_processing_singleRegion_R",
"readOnly": false,
"type": "UDB",
"url": "E:\\data\\test\\processing.udb"
},
"datasetName": "test_processing_singleRegion_R",
"numSlices": 0
},
"mainClass": "com.supermap.bsp.main.SummaryWithinMeshMain",
"output": {
"datasetName": "analystResult",
"outputPath": "F:\\iserver-code\\iserver\\etc\\iserver-debug\\src\\test\\resources\\iserver\\processingResultData\\Analyst\\udbs\\14ec67de-c7a5-42e0-9fae-0b9f65b7bf38"
},
"serviceInfo": {
"targetDataPath": "F:\\iserver-code\\iserver\\etc\\iserver-debug\\src\\test\\resources\\iserver\\processingResultData\\Analyst\\48508e0b_d4b5_4278_bbde_9e092fe85618",
"targetServiceInfos": [
{
"serviceAddress": "http://supermapiserver:8090/iserver/services/data-summaryRegion73/rest",
"serviceType": "RESTDATA"
},
{
"serviceAddress": "http://supermapiserver:8090/iserver/services/map-summaryRegion64/rest",
"serviceType": "RESTMAP"
}
]
},
"serviceRoot": "http://supermapiserver:8090/iserver/services/",
"type": "SUMMARYMESH"
},
"state": {
"elapsedTime": 48120,
"endState": true,
"endTime": 1499671184678,
"errorMsg": null,
"errorStackTrace": null,
"publisherelapsedTime": 4970,
"runState": "FINISHED",
"startTime": 1499671126724
}
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 summaryRegionJob资源是否存在,或者客户端是否有权限访问 summaryRegionJob资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 summaryRegionJob资源是否支持<format>格式的表述。