services


URI

http://<server>:<port>/iserver/services[.<format>]

支持的方法

GETHEAD

子资源

rootloginlogouttokensprofileproxyServers

介绍

services 是服务列表资源。通过访问服务列表资源可以获取当前服务器提供的所有GIS 服务的列表和元信息。其中,services 资源的 CSW 表述是指 SuperMap iServer 支持的 OGC 标准的 CSW 2.0.2 目录服务。

当系统开启了服务安全时,访问受保护的服务需要登录或者基于 Token 认证。通过 REST 方式访问服务资源时,需要携带验证信息,比如可以在 http 请求头中携带基于 HTTP Form 认证登录时生成的 Cookie 信息,或者可以基于 Token 访问受保护的 REST 服务资源。其中 Cookie 信息可以在登录时获取,而 Token 可以通过 token 资源获取

支持的方法:

支持的表述格式:rjson、json、html、xml、csw。

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services.rjson

GET 请求

获取当前服务器中的所有服务的列表。

字段 类型 说明

status

String[]

返回指定状态的服务,当前支持的状态有 OK 、Created。Created 表示延迟初始化的服务,OK 表示成功初始化的服务。支持一次返回多种状态的服务,例如需要返回成功初始化的服务和延迟初始化的服务,则需要设置为:status=OK,Created

如不设置此参数表示返回所有状态的服务。

 

响应结构

返回服务列表,其中包含了服务的基本信息,由以下字段组成:

字段 类型 说明
componentType String

服务组件类型,如 data 组建的类型为“com.supermap.services.components.impl.DataImpl”。

interfaceType String

服务的接口类型,如 restlet 接口的类型为“com.supermap.services.rest.RestServlet”。

name String 服务名称,如“data-world/rest”。
url String 服务地址,如“http://localhost:8090/iserver/services/data-world/rest”。
status String 服务的状态,Created 表示延迟初始化的服务,OK 表示成功初始化的服务

响应示例

对 services 资源执行 GET 请求:http://localhost:8090/iserver/services.rjson,返回 rjson 格式的资源描述如下:

HEAD 请求

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

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

请参见