serviceStorage

URI

<managerRoot_uri>/serviceStorage[.<format>]

<managerRoot_uri>/servicestorage[.<format>]

支持的方法

GET、PUT、HEAD

父资源

managerRoot

介绍

服务配置存储。通过 GET 操作可获取当前服务配置存储的信息， PUT 操作可更新服务配置存储的信息。在 iServer 页面进行配置信息存储设置请详见服务配置信息存储。

支持的方法：

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

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/manager/serviceStorage.rjson

GET 请求

获取服务配置存储设置的信息。

请求参数

无

响应结构

通过对 serviceStorage 执行GET请求，响应参数如下：

字段 类型 说明

connInfo

 DataSourceConnectionPoolInfo 数据库连接信息

schemaName

 String 服务配置信息存储的模式名，仅当 type 为 PostgreSQL 才有效

type

 ServiceStorageType 存储类型，包含 XML、Oracle、PostgreSQL 三种类型

tableName

 String

服务存储表名，默认为 iserver_V1_SERVICES。

version

 String 存储版本，当前仅支持 1.0 版本

metaTableName

 String 服务存储元数据表表名，默认为 iserver_V1_METAINFOS。

响应示例

对 serviceStorage 资源：http://supermapiserver:8090/iserver/manager/serviceStorage.rjson 执行 GET 请求，返回的服务配置存储信息如下：

{

    "connInfo": {

        "password": "SuperMap",

        "minPoolSize": "5",

        "driverClass": "oracle.jdbc.driver.OracleDriver",

        "jdbcUrl": "jdbc:oracle:thin:@192.168.17.219:1521/orcl",

        "maxWait": "3000",

        "dbType": "ORACLE",

        "maxIdleTime": "600",

        "maxPoolSize": "30",

        "initialPoolSize": "5",

        "username": "scott"

    },

    "metaTableName": "iserver_V1_METAINFOS",

    "type": "ORACLE",

    "version": "1.0",

    "tableName": "iserver_V1_SERVICES"

}

PUT 请求

更新服务配置存储的信息。

请求参数

名称 类型 含义

connInfo

 DataSourceConnectionPoolInfo 数据库连接信息

type

 ServiceStorageType 【必填】存储类型，包含 XML、Oracle、PostgreSQL 三种类型

version

 String 存储版本

响应结构

通过对 globalSettings 执行 PUT 请求，响应参数如下：

 

字段 类型 说明
succeed Boolean 更新服务配置存储信息是否成功

响应示例

对 serviceStorage 资源 http://localhost:8090/iserver/manager/serviceStorage.rjson，执行 PUT 请求，传递请求体如下：

{

    "connInfo": {

        "password": "tangx",

        "minPoolSize": "5",

        "driverClass": "oracle.jdbc.driver.OracleDriver",

        "jdbcUrl": "jdbc:oracle:thin:@192.168.17.219:1521/orcl",

        "maxWait": "3000",

        "dbType": "ORACLE",

        "maxIdleTime": "600",

        "maxPoolSize": "30",

        "initialPoolSize": "5",

        "username": "scott"

    },

    "metaTableName": "iserver_V1_METAINFOS",

    "type": "ORACLE",

    "version":"1.0",

    "tableName": "iserver_V1_SERVICES"

}

返回的 rjson 格式响应结果如下：

{“succeed”:"True"}

HEAD 请求

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

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

请参见