SuperMap iServer REST API介绍

2024-02-25 10:48
文章标签 介绍 api rest supermap iserver

本文主要是介绍SuperMap iServer REST API介绍,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

作者:MR

    SuperMap iServer (以下简称iServer)采用 REST 架构,提供了基于标准 HTTP 协议的应用编程接口——iServer REST API,这些接口封装了大部分的 GIS 功能,包括地图功能、数据功能、分析功能、三维功能等。SuperMap iServer 将这些 GIS 功能以资源的形式提供给客户端,客户端使用 iServer REST API 对资源进行操作,能够获取到相应的 GIS 能力。

    使用 iServer REST API 大致要分为以下三个步骤:

  1. 查询 SuperMap iServer REST API 帮助,确定应用所需的 REST 资源,确定每个所需传递的参数和资源的响应结构;
  2. 按照资源的 URI 和所需传递的参数构建 HTTP 请求访问资源。
  3. 参照资源的响应结构,解析服务器响应,提取所需的信息。

    已知的iServer REST API主要应用:各种版本的iClientiServer管理页面(浏览器访问 http://{IP}:{端口}/iserver/manager 开头的页面)、iServer JAVA API(部分)等,帮助文档示例位置在 开始 > iServer 开发与扩展指南 > 使用 iServer API > 使用 REST API 目录下。

    主要应用场景:

  1. iServer服务管理资源(需要安全认证),比如不通过iServer管理页对服务进行管理,包括发布、修改、删除服务;切图任务;监控;服务器配置(不包括重启)等等。
  2. 现有iClient不能满足开发需求的,比如其他后端语言使用REST API、对接现有或扩展的iServer服务等。

    iServer REST API访问被保护资源点此。

    iServer REST API分为服务资源管理资源

###一、服务资源
    服务资源即iServer发布的各种服务,iClient对接的就是这个资源。服务资源层次结构点此,服务资源根节点点此。
    除了使用iClient来访问iServer服务资源,也可以使用iServer JAVA API。

    这里简单举一个例子,比如,在浏览器直接访问以下地址:

http://support.supermap.com.cn:8090/iserver/services.rjson

    会返回support.supermap.com.cn:8090/iserver这个iServer发布的所有服务的RJSON表述(缩进的JSON字符串,便于查看,支持HTML、JSON等表述,iServer支持的表述格式点此),而上述URL末尾不写 .rjson 则默认返回html表述,也就是我们平常看到的服务列表页。
    参考services服务资源的帮助,可以知道,该资源支持HTTP GET、HEAD方法,GET方法没有需要设置的参数。其他资源以此类推,基本每个资源在帮助文档中都有请求示例。
###二、管理资源
    管理资源即对iServer进行管理的服务资源,代表应用就是iServer管理页面。管理资源层次结构点此,管理资源根节点点此
    前面的服务资源根据设置可能需要安全认证也可能不需要,但是管理资源时一定需要安全认证的,并且需要设置的认证用户有对应的权限,比如, PUBLISHER 角色的用户只能发布服务,无权创建切图任务等。
    安全认证的方式有两种,一种是token(使用iServer用户名密码生成),另一种是先使用登陆服务,再设置请求头,多为后端进行,因为浏览器有限制。

    使用JAVA访问iServer管理资源设置请求头通过安全验证的代码如下:

	/*** 登陆iServer* * @param ipport*            iServer服务根目录,比如:"http://localhost:8090"* @param username*            登陆iServer的用户名* @param passwor*            登陆iServer的密码* @return String cookie*/private String login( String ipport, String username, String passwor ){try{String json = "{\"username\": \"" + username + "\",\"password\": \"" + passwor+ "\",\"rememberme\": \"true\"}";URL url = new URL( ipport + "/iserver/services/security/login.json" );HttpURLConnection connection = (HttpURLConnection) url.openConnection( );connection.setDoInput( true );connection.setDoOutput( true );connection.setRequestMethod( "POST" );connection.setUseCaches( false );connection.setInstanceFollowRedirects( true );connection.setRequestProperty( "Content-Type", "application/x-www-form-urlencoded; charset=UTF-8" );connection.connect( );DataOutputStream out = new DataOutputStream( connection.getOutputStream( ) );out.writeBytes( json );out.flush( );out.close( );BufferedReader reader = new BufferedReader( new InputStreamReader( connection.getInputStream( ) ) );String lines;StringBuffer sbf = new StringBuffer( );while ( ( lines = reader.readLine( ) ) != null ){lines = new String( lines.getBytes( ), "utf-8" );sbf.append( lines );}System.out.println( "//" + sbf + "//" );String cookie = connection.getHeaderField( "set-cookie" );reader.close( );connection.disconnect( );return cookie;} catch ( MalformedURLException e ){e.printStackTrace( );} catch ( IOException e ){e.printStackTrace( );}return "";}

    拿到cookie后,使用别的iServer管理资源时设置请求头"cookie"(connection.setRequestProperty("cookie", cookie);)为拿到的cookie就可以正常使用iServer管理资源了。当然,使用token也是可以的。
    其他,某些REST API没有列出的iServer管理资源可以在iServer管理页对应页面抓网络请求获取。

这篇关于SuperMap iServer REST API介绍的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/745239

相关文章

C#使用StackExchange.Redis实现分布式锁的两种方式介绍

《C#使用StackExchange.Redis实现分布式锁的两种方式介绍》分布式锁在集群的架构中发挥着重要的作用,:本文主要介绍C#使用StackExchange.Redis实现分布式锁的... 目录自定义分布式锁获取锁释放锁自动续期StackExchange.Redis分布式锁获取锁释放锁自动续期分布式

redis过期key的删除策略介绍

《redis过期key的删除策略介绍》:本文主要介绍redis过期key的删除策略,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录第一种策略:被动删除第二种策略:定期删除第三种策略:强制删除关于big key的清理UNLINK命令FLUSHALL/FLUSHDB命

springboot项目中常用的工具类和api详解

《springboot项目中常用的工具类和api详解》在SpringBoot项目中,开发者通常会依赖一些工具类和API来简化开发、提高效率,以下是一些常用的工具类及其典型应用场景,涵盖Spring原生... 目录1. Spring Framework 自带工具类(1) StringUtils(2) Coll

Pytest多环境切换的常见方法介绍

《Pytest多环境切换的常见方法介绍》Pytest作为自动化测试的主力框架,如何实现本地、测试、预发、生产环境的灵活切换,本文总结了通过pytest框架实现自由环境切换的几种方法,大家可以根据需要进... 目录1.pytest-base-url2.hooks函数3.yml和fixture结论你是否也遇到过

基于Flask框架添加多个AI模型的API并进行交互

《基于Flask框架添加多个AI模型的API并进行交互》:本文主要介绍如何基于Flask框架开发AI模型API管理系统,允许用户添加、删除不同AI模型的API密钥,感兴趣的可以了解下... 目录1. 概述2. 后端代码说明2.1 依赖库导入2.2 应用初始化2.3 API 存储字典2.4 路由函数2.5 应

MySQL中慢SQL优化的不同方式介绍

《MySQL中慢SQL优化的不同方式介绍》慢SQL的优化,主要从两个方面考虑,SQL语句本身的优化,以及数据库设计的优化,下面小编就来给大家介绍一下有哪些方式可以优化慢SQL吧... 目录避免不必要的列分页优化索引优化JOIN 的优化排序优化UNION 优化慢 SQL 的优化,主要从两个方面考虑,SQL 语

C++中函数模板与类模板的简单使用及区别介绍

《C++中函数模板与类模板的简单使用及区别介绍》这篇文章介绍了C++中的模板机制,包括函数模板和类模板的概念、语法和实际应用,函数模板通过类型参数实现泛型操作,而类模板允许创建可处理多种数据类型的类,... 目录一、函数模板定义语法真实示例二、类模板三、关键区别四、注意事项 ‌在C++中,模板是实现泛型编程

Python实现html转png的完美方案介绍

《Python实现html转png的完美方案介绍》这篇文章主要为大家详细介绍了如何使用Python实现html转png功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 1.增强稳定性与错误处理建议使用三层异常捕获结构:try: with sync_playwright(

Java使用多线程处理未知任务数的方案介绍

《Java使用多线程处理未知任务数的方案介绍》这篇文章主要为大家详细介绍了Java如何使用多线程实现处理未知任务数,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 知道任务个数,你可以定义好线程数规则,生成线程数去跑代码说明:1.虚拟线程池:使用 Executors.newVir

JAVA SE包装类和泛型详细介绍及说明方法

《JAVASE包装类和泛型详细介绍及说明方法》:本文主要介绍JAVASE包装类和泛型的相关资料,包括基本数据类型与包装类的对应关系,以及装箱和拆箱的概念,并重点讲解了自动装箱和自动拆箱的机制,文... 目录1. 包装类1.1 基本数据类型和对应的包装类1.2 装箱和拆箱1.3 自动装箱和自动拆箱2. 泛型2