REST服务组成元素


SuperMap iServer的REST服务内部工作主要分为验证、解析HTTP、请求处理以及结果编排返回几个过程,这些过程分别由REST服务内部的认证管理器、资源、参数解析器、资源HTTP处理器、表述生成器完成,客户端向REST服务提交的请求分别经由这些组成部分处理,最终形成处理结果返回给客户端。

资源

资源是REST服务核心的部分,SuperMap iServer的REST服务中每一个资源都有唯一的URI地址,用户访问资源的URI,并通过HTTP的五种动作(GET、PUT、POST、DELETE、HEAD)对资源进行操作,来获取各种GIS功能的操作结果。如对layer资源执行put操作表示创建或修改一个图层。

资源作为服务的核心元素,主要负责对HTTP请求内容进行处理。具体工作内容如下:

  • 对参数对象的内容进行判断,对于非法参数直接返回异常的响应码。
  • 通过SuperMap iServer服务内核-GIS组件处理请求内容。
  • 返回处理结果,包括当前地图状态参数等。

认证器

REST服务是基于网络的,任何客户端通过URI都可以访问REST服务的各种类型的资源,甚至有些资源支持客户端对GIS数据进行编辑操作,因此必须在REST服务器端设置安全机制,用于保护GIS数据、保证REST服务不被恶意破坏。

SuperMap iServer REST服务在安全机制环节专门设置了认证器,认证器是客户端请求到达 REST 服务后首先执行的程序,认证器主要作用是对客户端的身份进行合法性验证,只有通过身份验证的客户端请求才能够与REST服务进行交互,对于非法身份的客户端将其提交的请求驳回,认证器能够有效保证REST服务的安全。

参数解析器

参数解析器是用来解析包含在资源请求中的地图参数,将参数反序列化,转换为参数对象,以便 REST 服务根据参数对象执行对应的GIS处理。

HTTP处理器

HTTP处理器是REST资源用于处理HTTP请求的入口与出口。客户端的请求经过认证器的校验后被分配给相应的资源,此时HTTP处理器获取HTTP请求,对HTTP请求进行判读与处理,最后将最终资源表述返回给客户端。该处理器主要为SuperMap iServer的地图资源、数据资源、空间分析资源以及三维资源提供HTTP请求的处理工作。它主要负责如下工作内容:

  • 取得客户端HTTP请求。
  • 判读HTTP请求的资源是否存在。如果HTTP请求的资源不存在,将资源不存在的响应码返回给客户端。
  • 判读HTTP请求的动作REST资源是否支持。在SuperMap iServer中每个资源都有其能够处理的动作,如果HTTP请求的动作资源无法处理,HTTP处理器会给客户端返回无法处理动作的响应码。
  • 判断HTTP请求返回的表述类型REST资源是否支持。通常REST资源支持多种表述格式,包括json、xml、html、rjson、png、bmp、gif、jpg等。如果HTTP请求返回的表述类型资源无法支持,那么HTTP处理器会给客户端返回不支持表述类型的响应码。
  • 调用参数解析器解析HTTP请求的参数,转换为资源需要的参数对象。
  • 向资源提交参数对象并获取资源处理的结果。
  • 调用表述生成器,将处理结果生成所需的表述格式。
  • 将表述返回客户端。

表述生成器

表述生成器是将资源的处理结果生成指定类型的表述的一类程序。

在REST服务模式中,资源将客户端请求的响应结果以表述的形式返回给客户端。客户端执行GET请求,将会获得对资源的表述;客户端执行PUT、POST、DELETE请求,将获得操作结果的表述。目前SuperMap iServer的资源支持的表述有多种格式,如html、xml、json、rjson、png、bmp、gif 、jpg或jpeg等,其中png、bmp、gif、jpg或jpeg是图片资源特有的表述格式。

results matching ""

    No results matching ""