<mappingJobs_uri>/buildCache[.<format>]
buildCacheJobs 资源表示地图缓存作业资源。通过对 buildCacheJobs 执行GET 请求，可获取当前系统的地图缓存作业列表。通过 POST 请求可创建一个缓存作业。
支持的方法：
支持的表述格式：RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/processing/rest/v1/jobs/mapping/buildCache.rjson
获取当前系统的地图缓存作业列表。
对 buildCacheJobs 资源执行 GET 请求，在响应消息的实体主体里是一个地图缓存作用资源描述集，其中单个资源描述的结构如下：
| 字段 | 类型 | 说明 |
| id | String | 应用ID。 |
| state | String | 该任务的状态。包括执行状态、起止时间、耗时等。 |
| setting | String | setting中包含任务信息。 |
对 buildCahceJobs 资源执行 GET 请求，返回 rjson 格式的资源描述如下：
[
{
"id": "app-20170110063645-0003",
"setting": {
"DEFAULT_MASTER_ADRESS": "local[*] ",
"appName": "buildCache",
"args": [
"BuildCache",
"--input",
"hdfs://192.168.120.235:9000/test1/2013-01-01-0-12.csv",
"--bounds",
"-74.050,40.650,-73.850,40.850",
"--level",
"1",
"--type",
"Heatmap",
"--output",
"192.168.120.44:27010,dongxj,test1_heat,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": 1
},
"input": {"filePath": "hdfs://192.168.120.235:9000/test1/2013-01-01-0-12.csv"},
"mainClass": "com.supermap.spark.main.Main",
"output": {
"cacheName": "test1_heat",
"cacheType": "MongoDB",
"database": "dongxj",
"serverAdresses": ["192.168.120.44:27010"],
"version": "V1"
},
"serviceInfo": [{
"serviceAddress": "http://192.168.112.156:8090/iserver/services/mongodb--1487159395/rest",
"serviceType": "RESTMAP"
}],
"serviceRoot": "http://192.168.112.156:8090/iserver/services/"
},
"state": {
"elapsedTime": 3766,
"endTime": 1484059008352,
"errorMsg": null,
"errorStackTrace": null,
"publisherelapsedTime": 1093,
"runState": "FINISHED",
"startTime": 1484059004586
}
}
]
创建一个地图缓存任务。
对 buildCacheJobs 资源执行 POST 请求，创建一个 地图缓存作业任务，请求体需包含参数如下：
| 名称 | 类型 | 含义 |
| input | String | 【必填参数】
源数据路径（filePath）。目前支持 csv 数据。支持 iServer 本地数据，和 HDFS 分布式文件系统中的数据。 |
| output | String | 【必填参数】
缓存输出配置。传入时，需指定：
|
| drawing | String | 【必填参数】
用于指定： 缓存范围（bounds） 缓存类型（imageType） 缓存比例尺级别。（level） |
对示例 buildCacheJobs 资源：http://supermapiserver:8090/iserver/services/processing/rest/v1/jobs/mapping/buildCache.rjson 执行 POST 请求，创建一个地图缓存作业任务。请求体中的参数如下：
{
"input":{"filePath":"/home/supermap/supermap.csv"},
"output":{"cacheName":"cache",
"cacheType":"MongoDB",
"serverAdresses":["192.168.120.41:27017"],
"database":"smtiles", "version":"V1"},
"drawing":{
"imageType":"Heatmap",
"bounds":"-74.050,40.650,-73.850,40.850",
"level":"5"
}
}
返回 rjson 格式的操作结果表述如下：
{
"newResourceID": "app-20170110074431-0004",
"newResourceLocation": "http://192.168.112.156:8090/iserver/services/processing/rest/v1/jobs/mapping/buildCache/app-20170110074431-0004",
"postResultType": "CreateChild",
"succeed": true
}
返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。
HEAD 请求可以用来判断 buildCacheJobs 资源是否存在，或者客户端是否有权限访问 buildCacheJobs 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 buildCacheJobs 资源是否支持<format>格式的表述。