作者：MR

    SuperMap iServer （以下简称iServer）的 JAVA API严格来说就是iServer JAVA类库提供的开发接口，为了区别于扩展iServer，我们说的JAVA API都是指：在其他应用中，引用iServer相关jar包进行开发的API(方式)。

    在 SuperMap iServer 中，一个完整的 GIS 服务的发布流程如下图所示：

SuperMap iObjects Java 二次开发 supermap api_api

1. 通过服务提供者设置，可以构建服务提供者；
2. 通过服务提供者和服务组件设置，可以构建服务组件上下文，服务组件由服务组件上下文构建而成；
3. 通过服务组件和服务接口设置，可以构建服务接口上下文，服务接口由服务接口上下文构建而成。

    SuperMap iServer 提供了基于 REST 的应用编程接口——SuperMap iServer REST API，这些接口封装了大部分的 GIS 功能，包括基本的地图功能，数据编辑功能，分析功能等。SuperMap iServer 将这些 GIS 功能通过 SuperMap iServer REST API 提供给客户端，客户端使用这些 API，能够获取到相应的 GIS 能力。

    **iServer Java API开发主要用于后端(java语言，其他语言请使用iServer REST API或SuperMap iClient)向iServer发送HTTP请求，得到iServer响应。**当然，自己使用java.net.*相关包使用iServer REST API也能达到相同效果，使用iServer Java API的好处是，不需要自己构造请求体以及解析iServer返回内容、并且不存在浏览器的跨域限制等。

###使用服务提供者

    服务提供者对象可以使用对应的服务提供者设置对象来构造，在iServer帮助文档 JAVAdoc 里可以看到各种服务提供者类和其对应的设置类，请对照iServer发布的各种服务1来确定应该使用哪一个，同时也注意下各服务提供者类之间的继承关系。

    最常用的是使用各种服务接口类型服务提供者，比如RestMapProvider、RestDataProvider等，其次是具体各种类型的服务提供者。比如，具体的地图服务提供者则是com.supermap.services.components.spi.MapProvider的子类，接近30个之多。
    前者(服务接口类型服务提供者，不依赖SuperMap iObjects Java环境，下面简称组件)的设置类可以简单得只需要设置一个访问地址即可（若服务设置授权访问就需要设置token或者用户名密码），构造出对应服务提供者对象就可以使用服务提供者对象的方法了。例如，构建一个 RestDataProvider 的代码如下：

// 服务提供者设置
RestDataProviderSetting RDPS = new RestDataProviderSetting();
RDPS.restServiceRootURL = "http://support.supermap.com.cn:8090/iserver/services/data-world/rest";
// 创建服务提供者
dataProvider = new RestDataProvider(RDPS);
// TODO
// 获取数据源 "World" 里所有数据集名，其他请参考RestDataProvider类参考
//List< String > dtnms = dataProvider.getDatasetNames( "World" );
//for ( String s : dtnms )
//{
//	System.out.println( s );
//}

    后者的设置类视情况定（参见对应设置类的类参考），数据来源为本地的几乎都需要工作空间信息、缓存来源信息等，这种方式依赖组件环境且不再是向目标URL发请求，而是可以直接对本地数据进行操作(转发服务的除外，看类参考)。一般在特殊应用场景才会这么使用，打开操作本地数据等更多的应用场景应该是扩展iServer和使用组件。iServer帮助文档提供了一个示例。

###使用服务组件

    通过服务提供者和服务组件设置，可以构建服务组件上下文，服务组件由服务组件上下文构建而成。前面已经介绍了怎么构建一个服务提供者，以数据服务组件为例，创建一个数据服务组件 DataImpl 对象代码如下：

// 服务提供者设置
RestDataProviderSetting RDPS = new RestDataProviderSetting();
RDPS.restServiceRootURL = "http://support.supermap.com.cn:8090/iserver/services/data-world/rest";
// 创建服务提供者集合
List< DataProvider > dataProviders = new ArrayList<>( );
dataProviders.add( new RestDataProvider(RDPS));
// 服务组件上下文
DataContext dataContext = new DataContext( );
dataContext.setProviders( dataProviders );
// data服务组件实现类
DataImpl dataImpl;
try
{
	dataImpl = new DataImpl( dataContext );
	// TODO
	// 获取数据源 "World" 里所有数据集名，其它使用参见DataImpl类参考
	//List< String > dtnms = dataImpl.getDatasetNames( "World" );
	//for ( String s : dtnms )
	//{
	//	System.out.println( s );
	//}
} catch ( DataException e )
{
	e.printStackTrace( );
}

###使用服务接口

    JAVA API服务接口的使用主要用于获取服务的元数据、地图瓦片、要素等。iServer的帮助文档已经提供了一个使用的完整示例，参照示例和Java doc即可。使用场景不多。

  1. 可以访问iServer服务管理页面，通过添加服务提供者(http://{IP}:{端口}/iserver/manager/spsAndspsets)、添加服务组件并绑定服务接口(http://{IP}:{端口}/iserver/manager/scsAndscsets)来发布服务加深对三层结构的了解，帮助文档点此 。通过iServer JAVA API创建服务提供者的过程和在iServer管理页面添加服务提供者一致。 ↩︎