SuperMap iObjects Java 之 SpringBoot 部署 GIS 服务

原创

已于 2023-06-30 14:24:00 修改 · 1k 阅读

12 ·

CC 4.0 BY-SA版权

文章标签：

#java #spring boot #后端 #intellij-idea #spring

于 2023-06-30 14:08:13 首次发布

本文介绍了如何利用SuperMapiObjectsJava组件和SpringBoot框架搭建GIS后台服务。首先，详细列出了系统和开发环境的要求，包括对Windows和Linux平台的硬件配置。接着，阐述了技术栈，包括SuperMapiObjectsJava的GIS功能，SpringBoot的快速开发优势，以及Swagger用于文档和接口测试的作用。然后，逐步指导读者新建SpringBoot项目，配置Swagger和SuperMapiObjectsJava，特别提到了配置环境变量以解决C++依赖问题。最后，给出了简单的GIS功能实现示例，如打开工作空间、获取数据源和数据集等操作。

1. 背景

SuperMap iObjects Java 是面向 GIS 应用系统开发者的组件式 GIS 开发平台，具有强大的地理数据管理、编辑、显示、分析等功能，并且其具有极强的易用性和丰富的帮助资源，适宜快速开发大型 GIS 应用系统。

本文主要介绍如何以 SuperMap iObjects Java 组件为功能基础，结合 SpringBoot 开源框架快速搭建 GIS 后台服务。

2. 环境准备

2.1. 系统环境

操作系统	支持	说明
Windows	✔	Windows 平台推荐硬件配置要求：处理器： 2.00 GHz以上内存要求： 2 GB硬盘容量： 100 GB
Linux	✔	Linux平台最低硬件配置要求：CPU： 1.00 GHz （x86 架构）内存： 512 MB硬盘空间： 40 GB

2.2. 开发环境

软件	版本	下载地址	说明
iObjects Java	10i 及其以上版本	iObjects Java 下载地址	SuperMap 官方提供了 iObjects Java 组件 Maven 仓库，可直接使用
IDEA	2020.3.4 及其以上版本	IDEA 下载地址
SpringBoot	2.7.x	*	IDEA 新建 SpringBoot 项目时可直接选择需要的版本
Swagger	3.0.0	*	在 SpringBoot 项目的 pom.xml 文件中配置

3. 技术栈

3.1. SuperMap iObjects Java

SuperMap iObjects Java 组件为后台服务提供专业的 GIS 功能。

3.2. SpringBoot

SpringBoot 为框架，可供开发人员快速开发 Java 后台服务。

3.3. Swagger

Swagger 是一款 RESTFUL 接口的文档在线自动生成+功能测试功能软件，SpringBoot 集成 Swagger 后可供开发人员和服务使用人员学习测试服务接口。

4. 新建 SpringBoot 项目

IDEA 新建 SpringBoot 项目
配置 Maven 和项目 Java 版本
配置 SpringBoot 依赖模块

5. 配置 Swagger 模块

springfox-boot-starter 是一个 SpringBoot 库，它为 Spring 应用程序提供了快速、轻松地创建 Swagger 文档的能力。Swagger 文档可以帮助开发人员更好地理解和使用 RESTful API。

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

修改 application.properties 文件配置

由于 SpringBoot 2.7.x 版本的默认路径匹配策略是 path-pattern-matcher，当前 SpringBoot 项目集成 Swagger 3.0.0 后，若直接运行服务程序则会抛 “Failed to start bean ‘ documentationPluginsBootstrapper ‘ ; nested exception…” 的异常，因此需要在 application.properties 文件中添加以下配置修改路径匹配策略:
```
spring.mvc.pathmatch.matching-strategy=ant_path_matcher
```

6. 配置 SuperMap iObjects Java 组件

SuperMap 官方提供了 supermap-maven 仓库 (https://maven.supermap.io)，仓库包含 SuperMap iServer、SuperMap iObjects 等相关 Jar 和依赖的第三方库，通过在 pom 文件中添加 SuperMap 官方库，用户可以将开发使用到的库及其依赖直接添加到 maven 项目中，方便用户解决使用 SuperMap 官方库时遇到的依赖缺失等问题。

添加 SuperMap Maven 远程仓库

在 SpringBoot 项目的 pom.xml 中添加 SuperMap Maven 仓库节点。

<repositories>
  <repository>
    <id>supermap</id>
    <url>https://maven.supermap.io/</url>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
    <releases>
      <enabled>true</enabled>
    </releases>
  </repository>
</repositories