x

MapGIS IGServer九州-驾驭国产化环境下的拓展服务开发

发布时间:2022-06-29 阅读量:30

在《当GIS遇上国产化,跨平台终端GIS开发应用初体验》中,我们为大家介绍了面对国产化环境如何基于MapGIS Objects Java SDK开发跨平台桌面GIS应用。伴随着互联网技术的发展和国产化信创进程的不断深入,越来越多的WebGIS应用要求国产化的生产环境,在此背景下,国产化GIS服务器——MapGIS IGServer九州便可以大显身手了。凭借MapGIS统一的跨平台GIS内核,IGServer九州支持目录服务、地图服务、要素服务和分析服务的高性能发布、管理与聚合,与MapGIS Client for JavaScript前端二次开发SDK相结合全面支撑国产化WebGIS应用开发和部署。

值得一提的是,GIS在为各行业应用提供底层服务时,其基础通用功能却往往不能满足复杂多变的应用需求,基于此痛点,MapGIS IGServer九州提供服务扩展机制,从服务层实现需求功能。

使用什么技术开发?

运行于GIS服务器上的拓展服务其本质上就是“服务”,也就是大家在Web开发过程中经常接触到的WebService,所以在进行IGServer拓展服务开发时只不过是在通常的Web服务基础上添加了一些GIS功能,我们需要注意的仅仅是使用什么框架来编写服务。

了解MapGIS产品的朋友可能都知道,运行于Windows平台的MapGIS产品基本上是基于.NET框架开发的,所以对应的IGServer for Windows服务器在进行服务拓展时使用的是.NET框架下的WCF技术,而国产化环境下的IGServer九州则有所不同,由于是基于Java语言开发的跨平台产品,所以在进行服务拓展时使用的是Java中的Apache CXF框架。

如何开发拓展服务?

编写拓展服务本身比较简单,只要将所需的功能代码封装到对应的接口中即可,难点在于需要对CXF框架和服务中使用的第三方库有基础的掌握,所以存在一定的开发门槛。

image.png

首先,服务推荐使用Maven进行项目构建和依赖管理,包括完成服务代码编写后的打包都需要用到Maven工具。

其次,需要引入一些必要的依赖,如插件框架pf4j、Java Rest Service标准jakarta.ws.rs、日志框架slf4j等。此外,为了在IGServer中实现服务的管理和调用,还需引入IGServer的拓展接口server-api。

image.png

图 2 拓展服务必须的依赖

IGServer中使用的依赖版本以及上面提到的server-api可将IGServer文件夹lib目录下的igserver-webapp.jar解压,见目录BOOT-INF/lib下的jar包及其对应版本。

image.png

image.png

接下来,便是编写拓展服务功能代码的过程,主要有以下三个步骤:

◆创建plugin类,继承org.pf4j中的Plugin。IGServer拓展服务中的功能模块是以插件的形式加载和使用的,示例如下

image.png

◆创建Rest扩展服务接口,按照Java Rest Service标准注解@Path、@GET、@QueryParam,示例如下

image.png

◆创建Rest扩展服务实现类,必须添加注解@Extension,必须实现Rest扩展服务接口RestServiceExtension,该接口在前面提到的server-api中,示例如下

image.png

最后,完成代码编写后即可将服务打包成jar包,用于后续的服务发布。推荐使用打包工具maven-assembly-plugin,在Maven项目的pom.xml中添加如下配置即可:

image.png

图 5  打包插件配置

其中必须指定插件的属性,注意插件id保证唯一性,class为Plugin实现类,如上面的例子中是“DemoPlugin”,示例如下:

image.png

服务发布与测试

1-发布服务

拓展服务打包完成后,会生成插件jar包,针对MapGIS IGServer九州的版本不同会有不同的加载方式:

◆在10.5.4.xx版本IGS九州中,可通过Server Manager发布拓展服务,并设置服务前缀等信息,与.NET版本IGS发布拓展服务类似;

◆在10.5.6.xx新版本中,可通过将拓展服务jar包直接放入IGServer安装目录下的plugins文件夹内,在IGS启动时服务会自动加载。

image.png

2-调用服务

发布完成后,服务的调用在不同的IGServer版本环境中也略有不同:

◆在10.5.4.xx版本中,因为可以在Server Manager中设置服务前缀等信息,所以调用时的请求需要在端口之后添加服务前缀,如下:

“https://ip:port/服务前缀/路径名/方法名?参数”

◆在10.5.6.xx版本中,由于服务是通过放入文件夹中自动加载的,所以相对于上面的请求方式少了设置的服务前缀,可直接通过path调用,如:

“https://ip:port/Path/method?param=”

image.png

其中,以上URL中的“路径名”、“Path”等均为代码编写过程中在第二步创建服务接口时设置的内容。

以上,我们为大家详细介绍了关于MapGIS IGServer九州的拓展服务开发指南,更多二次开发产品技术介绍将在后续逐一展开。

随着GIS产品的不断创新发展,GIS平台二次开发技能需求愈发凸显。未来,中地数码将始终践行以“GIS平台+生态发展”的融合创新战略打造GIS生态圈,积极拥抱业内合作伙伴,聚焦二次开发服务,为用户带来更加高效的二次开发技能培训及实战演练,满足用户“简便、易用、高效”的二次开发诉求。

联系我们

武汉中地

400-880-9970

武汉市东湖新技术开发区关山大道598号

北京中地

010-51652066

北京市朝阳区东二环北路内2号天元港中心B座1205

深圳中地

0755-26551638

深圳市南山区高新区科苑南路中地数码大楼A1001

西部基地

028-85230200

成都市锦江区复地金融岛湾流锦宫506

苏州中地

0512-65831998

苏州市姑苏区世界贸易中心A座22层2205室

热线电话

电话咨询

400 880 9970

点击咨询