services

URI

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

Supported methods

Child resources

root, login, logout, tokens, profile, proxyservers

Introduction

The services is the service list resource. Users can get GIS Service List and Metadata provided by current server through accessing the services resource. The CSW representation of the services resource is the catalog service of OGC-compliant CSW 2.0.2 provided by SuperMap iServer.

While service security has been enabled, logging or Token authentication are needed to access protected services. Authentication information needs to be carried while accessing resource in the REST method. For example, Cookie information generated while logging in HTTP Form-based Authentication can be carried in the HTTP request head, or you can Access Protected REST Service Resources based on Token. Cookie information can be acquired whiling logging and Token can acquired through the token resource.

Supported Methods:

GET: Gets the service list.
HEAD: Checks whether the services resource exists or whether it has permission to access the resource.

Supported output formats: rjson, json, html, xml, csw.

Resource hierarchy

HTTP request methods

Implement the HTTP request on the following URI, where supermapiserver is the server name, with rjson being the output format.

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

GET request

Gets the list of all services on the server.

Response structure

Returns service list, including the basic information osf services, which should inlcude the following fields:

Field	Type	Description
componentType	String	Service component type, for example, the type of the data component is "com.supermap.services.components.impl.DataImpl".
interfaceType	String	Service interface type, for example, the type of restlet interface is "com.supermap.services.rest.RestServlet".
name	String	The service name, "data-world/rest" for instance.
url	String	The service URL, "http://localhost:8090/iserver/services/data-world/rest" for instance.

Response example

The returned rjson format resource representation after implementing the GET request on the services resource http://localhost:8090/iserver/services.rjson is as follows:

[ { "componentType": "componetSetType", "interfaceType": "com.supermap.services.handler.HandlerServlet", "name": "components-handler/handler", "url": "http://localhost:8090/iserver/services/components-handler/handler" }, { "componentType": "componetSetType", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "components-rest/rest", "url": "http://localhost:8090/iserver/services/components-rest/rest" }, { "componentType": "com.supermap.services.components.impl.DataImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "data-changchun/rest", "url": "http://localhost:8090/iserver/services/data-changchun/rest" }, { "componentType": "com.supermap.services.components.impl.DataImpl", "interfaceType": "com.supermap.services.wcs.WCSServlet", "name": "data-jingjin/wcs112", "url": "http://localhost:8090/iserver/services/data-jingjin/wcs112" }, { "componentType": "com.supermap.services.components.impl.DataImpl", "interfaceType": "com.supermap.services.wcs.WCSServlet", "name": "data-jingjin/wcs111", "url": "http://localhost:8090/iserver/services/data-jingjin/wcs111" }, { "componentType": "com.supermap.services.components.impl.DataImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "data-jingjin/rest", "url": "http://localhost:8090/iserver/services/data-jingjin/rest" }, { "componentType": "com.supermap.services.components.impl.DataImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "data-3D/rest", "url": "http://localhost:8090/iserver/services/data-3D/rest" }, { "componentType": "com.supermap.services.components.impl.DataImpl", "interfaceType": "com.supermap.services.wfs.WFSServlet", "name": "data-world/wfs100", "url": "http://localhost:8090/iserver/services/data-world/wfs100" }, { "componentType": "com.supermap.services.components.impl.DataImpl", "interfaceType": "com.supermap.services.wcs.WCSServlet", "name": "data-world/wcs112", "url": "http://localhost:8090/iserver/services/data-world/wcs112" }, { "componentType": "com.supermap.services.components.impl.DataImpl", "interfaceType": "com.supermap.services.wcs.WCSServlet", "name": "data-world/wcs111", "url": "http://localhost:8090/iserver/services/data-world/wcs111" }, { "componentType": "com.supermap.services.components.impl.DataImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "data-world/rest", "url": "http://localhost:8090/iserver/services/data-world/rest" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-changchun/rest", "url": "http://localhost:8090/iserver/services/map-changchun/rest" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-china400/rest", "url": "http://localhost:8090/iserver/services/map-china400/rest" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wmts.WMTSServlet", "name": "map-china400/wmts100", "url": "http://localhost:8090/iserver/services/map-china400/wmts100" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wmts.WMTSServlet", "name": "map-china400/wmts-china", "url": "http://localhost:8090/iserver/services/map-china400/wmts-china" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "map-china400/wms111", "url": "http://localhost:8090/iserver/services/map-china400/wms111" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "map-china400/wms130", "url": "http://localhost:8090/iserver/services/map-china400/wms130" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-jingjin/rest", "url": "http://localhost:8090/iserver/services/map-jingjin/rest" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-temperature/rest", "url": "http://localhost:8090/iserver/services/map-temperature/rest" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wmts.WMTSServlet", "name": "map-world/wmts100", "url": "http://localhost:8090/iserver/services/map-world/wmts100" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "map-world/wms111", "url": "http://localhost:8090/iserver/services/map-world/wms111" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-world/rest", "url": "http://localhost:8090/iserver/services/map-world/rest" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "map-world/wms130", "url": "http://localhost:8090/iserver/services/map-world/wms130" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wmts.WMTSServlet", "name": "map-world/wmts-china", "url": "http://localhost:8090/iserver/services/map-world/wmts-china" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "maps/wms130", "url": "http://localhost:8090/iserver/services/maps/wms130" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "maps/wms111", "url": "http://localhost:8090/iserver/services/maps/wms111" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.wmts.WMTSServlet", "name": "maps/wmts100", "url": "http://localhost:8090/iserver/services/maps/wmts100" }, { "componentType": "com.supermap.services.components.impl.MapImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "maps/rest", "url": "http://localhost:8090/iserver/services/maps/rest" }, { "componentType": "com.supermap.services.components.impl.RealspaceImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "3D-sample/rest", "url": "http://localhost:8090/iserver/services/3D-sample/rest" }, { "componentType": "com.supermap.services.components.impl.SpatialAnalystImpl", "interfaceType": "com.supermap.services.rest.JaxrsServletForJersey", "name": "spatialanalyst-changchun/restjsr", "url": "http://localhost:8090/iserver/services/spatialanalyst-changchun/restjsr" }, { "componentType": "com.supermap.services.components.impl.SpatialAnalystImpl", "interfaceType": "com.supermap.services.wps.WPSServlet", "name": "spatialanalyst-changchun/wps100", "url": "http://localhost:8090/iserver/services/spatialanalyst-changchun/wps100" }, { "componentType": "com.supermap.services.components.impl.SpatialAnalystImpl", "interfaceType": "com.supermap.services.rest.JaxrsServletForJersey", "name": "spatialanalyst-sample/restjsr", "url": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr" }, { "componentType": "com.supermap.services.components.impl.TrafficTransferAnalystImpl", "interfaceType": "com.supermap.services.rest.JaxrsServletForJersey", "name": "traffictransferanalyst-sample/restjsr", "url": "http://localhost:8090/iserver/services/traffictransferanalyst-sample/restjsr" }, { "componentType": "com.supermap.services.components.impl.TrafficTransferAnalystImpl", "interfaceType": "com.supermap.services.wps.WPSServlet", "name": "traffictransferanalyst-sample/wps100", "url": "http://localhost:8090/iserver/services/traffictransferanalyst-sample/wps100" }, { "componentType": "com.supermap.services.components.impl.TransportationAnalystImpl", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "transportationanalyst-sample/rest", "url": "http://localhost:8090/iserver/services/transportationanalyst-sample/rest" }, { "componentType": "com.supermap.services.components.impl.TransportationAnalystImpl", "interfaceType": "com.supermap.services.wps.WPSServlet", "name": "transportationanalyst-sample/wps100", "url": "http://localhost:8090/iserver/services/transportationanalyst-sample/wps100" } ]

HEAD request

Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.

HEAD request can be used to check if the services resource exists, or if the services resource can be accessed by clients. It can also determine if the services resource supports an output format <format> if performed on a URI with .<format> included.