buildCacheJob


URI

<buildCacheJobs_uri>/{jobID}[.<format>]

支持的方法

GETHEAD

父资源

buildCacheJobs

介绍

buildCacheJob 资源表示一个地图缓存作业。通过对buildCacheJob 资源执行 GET 请求,可以查看任务配置信息,如缓存的源数据地址、输出地址、地图缓存信息等。buildCacheJob 资源 可以通过 ID 号({jobID}) 来获取。

支持的方法:

支持的表述格式:RJSON、JSON、HTML、XML。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/processing/rest/v1/jobs/mapping/buildCache/{jobID}.rjson

GET 请求

获取一个地图缓存作业信息。

响应结构

对 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

  }

}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。

HEAD 请求可以用来判断 buildCacheJob 资源是否存在,或者客户端是否有权限访问 buildCacheJob 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 buildCacheJob 资源是否支持<format>格式的表述。

请参见