execute

URI

<tool_uri>/execute

支持的方法

GET、HEAD

父资源

tool

介绍

通过传递处理自动化工具ID以及相关参数同步执行处理自动化工具，返回值为工具执行结果。

支持的方法：

支持的表述格式：JSON。

资源层次

HTTP 请求方法

对如下URI执行HTTP请求，以自定义工具TownCluster为例加以说明，其中，supermapiserver是服务器名。

http://localhost:8090/iserver/services/geoprocessing/restjsr/gp/v2/sps.WorkflowProcessFactory.models:towncluster/execute?parameter={"densitycluster-savedFields":"['M_unite','place_name']","densitycluster-eps":"15.0 Kilometer"}&environments=[{"type":"BDT_Spark_Environment","master":"local[*]","appName":"Geoprocessing","settings":["spark.cores.max=2","spark.driver.host=192.168.17.43","spark.executor.memory=4g"]}]

GET 请求

根据URI中传入的参数同步执行处理自动化，返回工具执行结果。

请求参数

以下为同步执行处理自动化工具的GET请求中参数的结构解析：

名称 类型 含义
parameter JSON 执行处理自动化工具时的参数设置，形式为{”ParameterID1”:”value1”,”ParameterID2”:”value2”,……}，其中ParameterID为工具的参数ID，由对应的处理自动化工具描述可以确定，value为参数的值。
environments Object[]

执行处理自动化工具的环境参数设置，包含以下字段：

    • type：处理自动化工具的环境参数类型，目前只支持对分布式处理自动化工具设置环境参数，即"type":"BDT_Spark_Environment"。
    • master：集群master地址，如："master":"spark://172.16.16.8:7077"。
    • settings：集群配置的参数设置，为数组格式，支持多个配置参数设置，使用逗号“,”分隔开，如："settings":["spark.cores.max=8","spark.driver.host=192.168.17.43","spark.executor.memory=32g"]

响应结构

使用GET请求同步执行的处理自动化工具，响应消息的实体主体即为JSON格式的工具执行结果。

响应示例

使用GET请求同步执行处理自动化密度聚类工具，返回JSON格式的工具执行结果如下：

{“saveas-isSuccessful”:”--providerType=dsf --path=/home/dsfdata”}

HEAD 请求

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

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

请参见