<buildCacheJobs_uri>/{jobID}[.<format>]
buildCacheJob 资源表示一个地图缓存作业。通过对buildCacheJob 资源执行 GET 请求,可以查看任务配置信息,如缓存的源数据地址、输出地址、地图缓存信息等。buildCacheJob 资源 可以通过 ID 号({jobID}) 来获取。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/processing/rest/v1/jobs/mapping/buildCache/{jobID}.rjson
获取一个地图缓存作业信息。
对 buildCacheJob 资源执行 GET 请求,返回操作结果的结构如下:
字段 | 类型 | 说明 |
id | String | 应用ID。 |
state | String | 该任务的状态。包括执行状态、起止时间、耗时等。 |
setting | String | setting中包含任务信息。如地图出图类型,源数据地址,缓存范围等 |
对 buildCacheJob 资源 http://supermapiserver:8090/iserver/services/processing/rest/v1/jobs/mapping/buildCache/app-20170110074431-0004.rjson执行 GET 请求,返回操作结果如下:
{
"id": "app-20170110074431-0004",
"setting": {
"DEFAULT_MASTER_ADRESS": "local[*] ",
"appName": "buildCache",
"args": [
"BuildCache",
"--input",
"/home/supermap/supermap.csv",
"--bounds",
"-74.050,40.650,-73.850,40.850",
"--level",
"5",
"--type",
"Heatmap",
"--output",
"192.168.120.41:27017,smtiles,cache,V1"
],
"contextSetting": {
"DEFAULT_DRIVER_MEMORY": "1g",
"DEFAULT_EXECUTOR_CORES": 1,
"DEFAULT_EXECUTOR_MEMORY": "1g",
"driver_memory": "1g",
"executor_cores": 1,
"executor_memory": "1g"
},
"drawing": {
"bounds": "-74.050,40.650,-73.850,40.850",
"imageType": "Heatmap",
"level": 5
},
"input": {"filePath": "/home/supermap/supermap.csv"},
"mainClass": "com.supermap.spark.main.Main",
"output": {
"cacheName": "cache",
"cacheType": "MongoDB",
"database": "smtiles",
"serverAdresses": ["192.168.120.41:27017"],
"version": "V1"
},
"serviceInfo": [{
"serviceAddress": "mongodb-145296865/rest",
"serviceType": "RESTMAP"
}],
"serviceRoot": "http://192.168.112.156:8090/iserver/services/"
},
"state": {
"elapsedTime": 10853,
"endTime": 1484063074559,
"errorMsg": null,
"errorStackTrace": null,
"publisherelapsedTime": 0,
"runState": "FINISHED",
"startTime": 1484063071864
}
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 buildCacheJob 资源是否存在,或者客户端是否有权限访问 buildCacheJob 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 buildCacheJob 资源是否支持<format>格式的表述。