URI

<workspaces_uri>/workspacereload[.<format>]

支持的方法

POST、HEAD

父资源

workspaces

介绍

workspaceReload 资源，通过POST操作可刷新指定工作空间的内容。

支持的方法：

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

资源层次

HTTP 请求方法

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

localhost:8090/iserver/manager/workspaces/workspacereload.rjson

POST 请求

刷新指定工作空间的内容。

请求参数

请求体中传递如下参数：

名称 类型 含义
workspaceConnectionInfo String 【必选参数】
该参数表示数据库的连接信息，数据库型工作空间表示如：
"workspaceConnectionInfo": "server=orcl203;type=ORACLE;database=;name=testWorkSpace"
文件型工作空间表示如：
"workspaceConnectionInfo": "D:/supermap/soft/supermap_iserver_1010_18929_5692_win64_zip/supermap_iserver_1010_18929_5692_win64_zip/samples/data/AddressMatch/BeijingAddress.smwu"
datasets Map<String, List<String>> key 值为需刷新的数据源名称，list 类型的 value 值代表需要被重新计算 bounds 的数据集名称集合，但只对矢量数据集才会做重新计算 bounds 操作。
注意：
1.只有当工作空间持有的数据源类型是以下类型时，该参数才支持刷新：
   EngineType.SQLPLUS, EngineType.ORACLEPLUS, EngineType.DB2, EngineType.MYSQL, EngineType.PGGIS, EngineType.POSTGRESQL, EngineType.YUKON；
2.如 datasets 为空，则刷新工作空间下的所有数据源，但不会重新计算任何数据集的 bounds；
3.如果 value 值为空，则只会刷新当前 key 指代的数据源而不会重新计算任何数据集的 bounds；
4.如果传入错误的数据源或者数据集，则不做相应的刷新和重新计算 bounds 的操作。
isForce boolean 表示是否强制刷新。如果为 false 则只有当数据源发生变化时才刷新，数据源没有变化时不进行刷新；为 true 时，不论数据源是否变化，均会强制刷新。

响应结构

响应结果是刷新成功的数据源集合：

字段 类型 说明

customResult

 WorkspaceRefreshResult

刷新成功的数据源集合

postResultType

 PostResultType

POST 请求的结果类型

succeed

 boolean

表示是否刷新成功

响应示例

对 workspaceReload 资源：http://localhost:8090/iserver/manager/workspaces/workspacereload.rjson?token=u-PmqKkKJLeU50U_wFLQwcNIpi-J-dvOZjKCyTa0I9R5jm9a4vrhzKGMLg1Yn4J-eG-vbzGi45YawqecGbVaIA.. 发送 POST 请求，刷新指定工作空间下的某一数据源：

{"workspaceConnectionInfo":"type=PGSQL;server=192.168.17.226:5432;database=beijingPG;name=beijingPG;driver=pgSQL Server","isForce":true,"datasets":{"beijingPG":["hospital"]}}

上述 POST 请求发送后，则返回的 rjson 格式的响应结果如下：

{

    "customResult": {"datasources": ["test"]},

    "postResultType": "CreateChild",

    "succeed": true

}

HEAD 请求

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

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

请参见