portal


URI

http://<server>:<port>/iportal/web[.<format>]

支持的方法

GETHEAD

子资源

loginusersmapsservicesscenesappsdatasdirectoriesgroupstagsmyContentimageFileUploadapplicationadministrativeDivRegionhighestPermissionconfiguiConfignotebooksfeedbackInfosnewsInfoswebPrinting

介绍

portal 资源是 SuperMap iPortal 提供的各个 REST 服务的根节点,是访问各个门户服务的入口。portal 资源及其子资源仅在 iPortal 产品中使用。

用户在 SuperMap iPortal 中访问注册服务、群组管理等操作以及访问我的资源、服务管理器等受保护的页面,需要登录或者基于 Token 认证。通过 REST 方式访问时需要携带验证信息,比如可以在 http 请求头中携带基于 HTTP Form 认证登录时生成的 Cookie 信息,或者可以基于 Token 访问受保护的 REST 服务资源。其中 Cookie 信息可以在登录时获取,而 Token 可以通过 token 资源获取

支持的方法:

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

资源层次

HTTP 请求方法

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

http://supermapiportal:8190/iportal/web.rjson

GET 请求

获取 portal 资源的表述,即获取当前服务的入口。

请求参数

对 portal 资源执行 GET 请求,在响应消息的实体主体里是一个资源描述集,其中单个资源描述的结构如下:

字段 类型 说明
name String 资源名称。
path String 资源的访问路径。
resourceConfigID String 资源配置项 ID。
resourceType String 资源类型。
supportedMediaTypes String[] 支持的表述的媒体类型。

响应示例

对 portal 资源:http://localhost:8190/iportal/web.rjson 执行 GET 请求,返回 rjson 格式的资源描述如下:

[

    {

        "name": "login",

        "path": "http://localhost:8190/iportal/web/login",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null

    },

    {

        "name": "users",

        "path": "http://localhost:8190/iportal/web/users",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null

    },

    {

        "name": "tags",

        "path": "http://localhost:8190/iportal/web/tags",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null

    },

    {

        "name": "maps",

        "path": "http://localhost:8190/iportal/web/maps",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null

    },

    {

        "name": "services",

        "path": "http://localhost:8190/iportal/web/services",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null

    },

    {

        "name": "datas",

        "path": "http://localhost:8190/iportal/web/datas",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null

    },

    {

        "name": "mycontent",

        "path": "http://localhost:8190/iportal/web/mycontent",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null

    },

    {

        "name": "groups",

        "path": "http://localhost:8190/iportal/web/groups",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null

    }

]

HEAD 请求

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

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

请参见