setting

URI

<processingserver_uri>/setting[.<format>]

支持的方法

GET、PUT、HEAD

父资源

processingserver

介绍

该资源为分布式分析服务的环境配置资源。通过对该资源执行GET请求，可以获取分布式分析服务环境配置的信息。执行PUT请求，可以配置分布式分析服务环境，用于大数据分析。

支持的方法：

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

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/manager/processingserver/setting.rjson

GET 请求

获取分布式分析服务环境配置的信息。

响应结构

对 setting 资源执行 GET 请求，响应参数如下：

字段 类型 说明
connectstate boolean spark连接状态
processingSetting DistributeAnalysisSetting

分布式空间处理服务设置

响应示例

对 setting 资源：http://supermapiserver:8090/iserver/manager/processingserver/setting.rjson执行 GET 请求，返回 rjson 格式的资源描述如下：

{

    "connectstate": false,

    "processingSetting": {

        "DEFAULT_OUTPUTTYPE": "UDB",

        "DEFAULT_RDDCOUNT": 10,

        "DEFAULT_WOEKER_PORT": 6765,

        "DEFAULT_XMX": "1024m",

        "defaultOutputType": "UDB",

        "enabled": true,

        "iobjectSparkJarName": null,

        "localServiceAddress": null,

        "rddStorageCount": 10,

        "referServicesAddress": "",

        "referToken": "UFpWFx6i8NaIlkvO0JEJ5cp9PH6u6bd8hfj7fxYFEpxQ2-RVhzkYuubxAMFBN0NpSCCMYE5szl1-0rhRuWajPg..",

        "workerPort": 6765,

        "publishService":true,

        "xmx": "1024m"

    }

}

PUT 请求

通过执行PUT请求，可以配置分布式分析服务环境。

请求参数

对 setting 资源执行 PUT请求，请求体需包含参数如下：

响应结构

名称 类型 含义
enabled boolean 是否启用分布式空间处理服务
otherSparkEnabled boolean 是否使用本地spark服务
referServicesAddress String 发布分布式分析的结果为iServer服务时，可选择的iserver服务地址。默认：http://localhost:8090/iserver
referToken String 所设定的referServicesAddress服务的token
xmx String jvm最大堆内存。默认：1024m

workerPort

 int 分布式分析服务进程的端口。 默认：6765

defaultOutputType

 OutputType 分布式分析结果默认存储类型，本地或内存中。默认：本地磁盘

buildPyramid

 boolean 是否开启矢量金字塔。默认：false

rddStorageCount

 int 分布式分析结果默认存储类型设置为内存时，分布式分析结果最多保留个数。 默认：10

对 setting 资源执行 PUT 请求，响应参数如下：

字段 类型 说明
succeed boolean 请求是否成功

响应示例

启动分布式分析服务前，需先开启Spark集群，首先需向setting 资源：http://supermapiserver:8090/iserver/manager/sparkserver/setting.json执行 PUT 请求，请求体格式的资源描述如下：

{

    "enabled": true,

    "otherSparkEnabled": false

}

返回 rjson 格式的资源描述如下：

{

    "succeed": True

}

然后再对 setting 资源：http://supermapiserver:8090/iserver/manager/processingserver/setting.rjson执行 PUT 请求，请求体格式的资源描述如下：

{

    "enabled": true,

    "referToken": "FNhwL_qxJ8V6wbfuZKtPN5Lob0U7Welheb7uKJ6i45K71zT3msJfFPMICv2vV1nepFlGy_HuvnQo-XPwpW29kQ..",

    "referServicesAddress": "http://localhost:8090/iserver",

    "xmx": "1024m",

    "workerPort": "6765",

   "defaultOutputType":"UDB",

   "rddStorageCount":"10",

   "buildPyramid":false

}

返回 rjson 格式的资源描述如下：

{

    "succeed": True

}

HEAD 请求

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

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

请参见