介绍

MapGIS Boot

基于Spring Boot、Spring Cloud & Alibaba的前后端分离微服务极速后台开发框架

MapGIS Boot 是一个 Java EE 企业级快速开发平台，基于经典技术组合（Spring Boot、Spring Cloud & Alibaba、Ant Design Vue），内置模块如：部门管理、角色用户、菜单及按钮授权、数据权限、系统参数、日志管理、代码生成、在线定时任务、路由监控等。

系统需求

• JDK >= 1.8
• MySQL >= 5.7
• Maven >= 3.0
• Node >= 12

快速了解

项目简介

MapGIS Boot 是一款基于 Spring Boot、Spring Cloud & Alibaba、MyBatis、Jwt、Ant Design Vue 的前后端分离微服务极速后台开发框架。

主要特性

• 支持单体和微服务自由切换
• 支持按钮及数据权限，可自定义部门数据权限
• 支持菜单动态路由
• 支持多主题动态切换
• 完善的 XSS 防范及脚本过滤，彻底杜绝 XSS 攻击
• Maven 多项目依赖，模块及插件分项目，尽量松耦合，方便模块升级、增减模块
• 完善的日志记录体系简单注解即可实现
• 强大的一键生成功能（包括控制器、模型、视图、菜单等）
• 支持后端微服务路由和前端微应用路由配置
• 支持第三方用户系统接入（包括CAS、OAuth2、LDAP等）

技术选型

开发环境

• 语言：Java 8+ (小于17)

• IDE(JAVA)： IDEA (必须安装lombok插件 )

• IDE(前端)： VSCode

• 依赖管理：Maven

• 缓存：Redis

• 数据库脚本：MySQL5.7+

后端

• 基础框架：Spring Boot 2.7.7

• 微服务框架： Spring Cloud Alibaba 2021.0.4.0

• 持久层框架：Mybatis-Plus 3.5.3

• 安全框架：Spring Security，Jwt

• 微服务技术栈：Spring Cloud Alibaba、Nacos、Gateway、Sentinel

• 数据库连接池：阿里巴巴 Druid 1.2.15

• 缓存框架：Redis

• 日志打印：Logback

• 其他：Poi，Swagge UI，Quartz, Lombok（简化代码）等

前端

• Vue 2.x,Vuex,Vue Router
• Axios
• ant-design-vue
• webpack,yarn
• eslint，@vue/cli

内置功能

├─总览
├─监控管理
│  ├─在线用户
│  ├─服务器监控
│  ├─服务器性能监控
├─日志管理
│  ├─登录日志
│  ├─操作日志
│  ├─系统日志
│  ├─服务访问日志
│  ├─日志配置
├─安全管理
│  ├─安全配置
│  ├─用户管理
│  ├─用户组管理
│  ├─角色管理
│  ├─菜单管理
│  ├─部门管理
│  ├─岗位管理
│  ├─第三方登录配置
│  ├─CAS登录配置
│  ├─LDAP登录配置
├─文件管理
├─计划任务
│  ├─定时任务
├─消息中心
│  ├─通知公告
├─开发扩展
│  ├─接口文档
│  ├─数据字典
│  ├─代码生成
│  ├─微应用路由配置
│  ├─微服务路由配置（微服务）
├─系统配置
│  ├─基本配置
│  ├─主题配置

在线体验

文档地址：https://mapgis.github.io/mapgis-boot-docs/

演示图

环境部署

准备工作

JDK >= 1.8 (推荐1.8版本)
Mysql >= 5.7.0 (推荐5.7版本)
Redis >= 3.0
Maven >= 3.0
Node >= 12
nacos >= 2.x.x
sentinel >= 1.6.0

运行系统

后端运行

后端项目导入

后端工程mapgis-boot，将其导入到IDEA，通过右侧 maven 窗口下载依赖，单体模式下选择Maven Profiles为local，微服务模式下选择Maven Profile为cloud

后端项目启动（单体模式）

请确保Maven Profiles为local

1、初始化 MySQL 数据库（采用本地数据库 Sqlite 可跳过此步骤、采用PostgreSQL数据库同MySQL数据库）

创建数据库mapgis-xxx（必须） 创建数据库mapgis-xxx-access-log（必须） 创建数据库mapgis-xxx-hardware-monitor（必须）

这里 mapgis-xxx 请与产品标识保持一致 字符集：utf8mb4、排序规则：utf8mb4_general_ci

2、修改项目配置 (采用 MySQL 数据库需要修改 xxx.storeType 为 mysql)

mapgis-boot/home/config/application.properties

复制 application.example.properties 为 application.properties，可参考application.example.properties中变量。

将上述配置文件设置到启动类mapgis-boot/mapgis-server/src/main/java/com/zondy/mapgis/MapApplication的程序参数中：

Edit Configurations->Configuration->Environment->Program arguments：

# 数据源类型（支持`mysql`、`sqlite`、`postgresql`，不设置默认为`sqlite`）
xxx.storeType=mysql

--spring.config.additional-location=file:home/config/

3、运行 mapgis-boot/mapgis-server/src/main/java/com/zondy/mapgis/MapApplication.java，出现如下图表示启动成功

__  __              _____ _____  _____    _____
|  \/  |            / ____|_   _|/ ____|  / ____|
| \  / | __ _ _ __ | |  __  | | | (___   | (___   ___ _ ____   _____ _ __
| |\/| |/ _` | '_ \| | |_ | | |  \___ \   \___ \ / _ \ '__\ \ / / _ \ '__|
| |  | | (_| | |_) | |__| |_| |_ ____) |  ____) |  __/ |   \ V /  __/ |
|_|  |_|\__,_| .__/ \_____|_____|_____/  |_____/ \___|_|    \_/ \___|_|
             | |
             |_|

提示

后端运行成功后可以继续参考下面步骤部署 mapgis-manager 前端，然后通过前端地址来访问

后端项目启动（微服务模式）

请确保Maven Profiles为cloud

1、配置本地hosts

如何快速修改本地hosts，SwitchHosts

127.0.0.1 mapgis-xxx-mysql
127.0.0.1 mapgis-xxx-redis
127.0.0.1 mapgis-xxx-nacos
127.0.0.1 mapgis-xxx-sentinel
127.0.0.1 mapgis-xxx-gateway

2、初始化 MySQL 数据库

创建数据库mapgis-cloud-xxx并导入 cloud-script/sql下数据脚本mapgis-cloud-xxx-yyyymmdd.sql（必须），quartz.sql（可选）

导入数据脚本mapgis-cloud-config-yyyymmdd.sql（必须，会自动创建数据库mapgis-cloud-config）

导入数据脚本mapgis-cloud-xxx-access-log-yyyymmdd.sql（必须，会自动创建数据库mapgis-cloud-xxx-access-log）

导入数据脚本mapgis-cloud-xxx-hardware-monitor-yyyymmdd.sql（必须，会自动创建数据库mapgis-cloud-xxx-hardware-monitor）

这里 mapgis-cloud-xxx 请与产品标识保持一致 字符集：utf8mb4、排序规则：utf8mb4_general_ci

3、配置nacos持久化，修改conf/application.properties文件，增加支持mysql数据源配置

# db mysql
spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://mapgis-xxx-mysql:3306/mapgis-cloud-config?characterEncoding=utf8&connectTimeout=30000&socketTimeout=60000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user=root
db.password=cloud123.mapgis

提示

配置文件application.properties是在下载的nacos-server包conf目录下 需要下载的nacos-server必须>=2.x.x版本 默认配置单机模式，nacos集群/多集群部署模式参考 (Nacos 支持三种部署模式)

4、运行 Nacos 修改项目配置 (数据库、redis 等)

访问http://localhost:8848/nacos，修改跟mapgis-xxx相关的配置文件

-dev 为开发环境下的配置，-prod 为生产环境下的配置

5、运行 Redis

6、运行各模块（启动没有先后顺序）

• MapGatewayApplication （网关模块 必须）
• MapAuthApplication （认证模块 必须）
• MapSystemApplication （系统模块 必须）
• MapMonitorApplication （监控中心 可选）
• MapJobApplication （定时任务 可选）
• MapFileApplication （文件服务 可选）
• MapGenApplication （代码生成 可选）

提示

运行前需要先启动nacos和redis，后端运行成功后可以继续参考下面步骤部署 mapgis-manager 前端，然后通过前端地址来访问

前端运行

# 进入项目目录
cd mapgis-manager

# 安装依赖
npm install

# 强烈建议不要用直接使用 cnpm 安装，会有各种诡异的 bug，可以通过重新指定 registry 来解决 npm 安装速度慢的问题。
npm install --registry=https://registry.npmmirror.com

# 本地开发 启动项目
npm run serve

打开浏览器，输入：http://localhost:8000，默认账号/密码 admin/cloud123.mapgis 若能正确展示登录页面，并能成功登录，菜单及页面展示正常，则表明环境搭建成功

提示

因为本项目是前后端完全分离的，所以需要前后端都单独启动好，才能进行访问 前端安装完 node 后，最好设置下淘宝的镜像源，不建议使用 cnpm（可能会出现奇怪的问题）

项目结构

后端结构

com.zondy.mapgis
├── mapgis-common                                       // 通用模块
│   ├── mapgis-common-accesslog                         // 访问日志记录
│       ├── mapgis-common-base-accesslog                // 基础访问日志记录
│       ├── mapgis-common-cloud-accesslog               // 微服务访问日志记录
│       ├── mapgis-common-local-accesslog               // 单体访问日志记录
│   ├── mapgis-common-cache                             // 缓存模块
│       ├── mapgis-common-base-cache                    // 基础缓存模块
│       ├── mapgis-common-cloud-cache                   // 微服务缓存模块
│       ├── mapgis-common-local-cache                   // 单体缓存模块
│   ├── mapgis-common-captcha                           // 验证码生成和校验
│   ├── mapgis-common-controllerprefix                  // 控制器前缀
│   ├── mapgis-common-core                              // 核心模块
│   ├── mapgis-common-datascope                         // 权限范围
│   ├── mapgis-common-datasource                        // 多数据源
│   ├── mapgis-common-har                               // HTTP归档文件模块
│   ├── mapgis-common-ldap                              // LDAP模块
│   ├── mapgis-common-log                               // 日志记录
│       ├── mapgis-common-base-log                      // 基础日志记录
│       ├── mapgis-common-cloud-log                     // 微服务日志记录
│       ├── mapgis-common-cross-log                     // 跨架构日志记录
│       ├── mapgis-common-local-log                     // 单体日志记录
│   ├── mapgis-common-meter                             // 指标记录
│       ├── mapgis-common-base-meter                    // 基础指标记录
│       ├── mapgis-common-cloud-meter                   // 微服务指标记录
│       ├── mapgis-common-local-meter                   // 单体指标记录
│   ├── mapgis-common-mybatis                           // Mybatis模块
│   ├── mapgis-common-objectserializer                  // 对象序列化模块
│   ├── mapgis-common-ratelimiter                       // 接口限流
│   ├── mapgis-common-repeatsubmit                      // 防重复提交
│   ├── mapgis-common-resttemplate                      // Rest请求工具
│   ├── mapgis-common-schedule                          // 定时任务
│   ├── mapgis-common-security                          // 安全模块
│       ├── mapgis-common-base-security                 // 基础安全模块
│       ├── mapgis-common-cloud-security                // 微服务安全模块
│       ├── mapgis-common-local-security                // 单体安全模块
│   ├── mapgis-common-service                           // 服务模块
│   ├── mapgis-common-swagger                           // 系统接口
│   ├── mapgis-common-systemlog                         // 系统日志记录
│       ├── mapgis-common-base-systemlog                // 基础系统日志记录
│       ├── mapgis-common-cloud-systemlog               // 微服务系统日志记录
│       ├── mapgis-common-local-systemlog               // 单体系统日志记录
│   ├── mapgis-common-webserver                         // Web服务器模块
├── mapgis-module-auth                                  // 授权模块
│   ├── mapgis-module-auth-api                          // 授权API
│       ├── mapgis-module-auth-base-api                 // 基础授权API
│       ├── mapgis-module-auth-cloud-api                // 微服务授权API
│       ├── mapgis-module-auth-cross-api                // 跨架构授权API
│       ├── mapgis-module-auth-local-api                // 单体授权API
│   ├── mapgis-module-auth-biz                          // 授权业务
│   ├── mapgis-module-auth-server                       // 授权服务器 [10000]
├── mapgis-module-system                                // 系统模块
│   ├── mapgis-module-system-api                        // 系统API
│       ├── mapgis-module-system-base-api               // 基础系统API
│       ├── mapgis-module-system-cloud-api              // 微服务系统API
│       ├── mapgis-module-system-local-api              // 单体系统API
│   ├── mapgis-module-system-biz                        // 系统业务
│   ├── mapgis-module-system-server                     // 系统服务器 [11000]
├── mapgis-module-file                                  // 文件模块
│   ├── mapgis-module-file-api                          // 文件API
│       ├── mapgis-module-file-base-api                 // 基础文件API
│       ├── mapgis-module-file-cloud-api                // 微服务文件API
│       ├── mapgis-module-file-local-api                // 单体文件API
│   ├── mapgis-module-file-biz                          // 文件业务
│   ├── mapgis-module-file-server                       // 文件服务器 [12000]
├── mapgis-module-job                                   // 定时任务模块
│   ├── mapgis-module-job-biz                           // 定时任务业务
│   ├── mapgis-module-job-server                        // 定时任务服务器 [13000]
├── mapgis-module-gen                                   // 代码生成模块
│   ├── mapgis-module-gen-biz                           // 代码生成业务
│   ├── mapgis-module-gen-server                        // 代码生成服务器 [14000]
├── mapgis-server                                       // 单体服务器 [8080]
├── mapgis-cloud-module                                 // 微服务模块
│   ├── mapgis-cloud-module-gateway                     // 网关模块 [8080]
│   ├── mapgis-cloud-module-monitor                     // 监控中心 [9200]
├── pom.xml                                             // 公共依赖

前端结构

├── build                      // 构建相关
├── bin                        // 执行脚本
├── public                     // 公共文件
│   ├── favicon.ico            // favicon图标
│   ├── index.html             // html模板
├── src                        // 源代码
│   ├── api                    // 所有请求
│   ├── assets                 // 主题 字体等静态资源
│   ├── components             // 全局公用组件
│   ├── directive              // 全局指令
│   ├── layout                 // 布局
│   ├── locales                // 国际化资源
│   ├── qiankun                // 微应用注册
│   ├── router                 // 路由
│   ├── store                  // 全局 store管理
│   ├── utils                  // 全局公用方法
│   ├── views                  // view
│   ├── App.vue                // 入口页面
│   ├── main.js                // 入口 加载组件 初始化等
│   ├── permission.js          // 权限管理
│   ├── settings.js            // 系统配置
├── .editorconfig              // 编码格式
├── .env.development           // 开发环境配置
├── .env.production            // 生产环境配置
├── .env.staging               // 测试环境配置
├── .eslintignore              // 忽略语法检查
├── .eslintrc.js               // eslint 配置项
├── .gitignore                 // git 忽略项
├── babel.config.js            // babel.config.js
├── package.json               // package.json
├── vue.config.js              // vue.config.js

特别鸣谢

• 感谢 y_project 提供的权限管理系统
• 感谢 fuzui 提供的基于Ant Design Vue的前端版本
• 感谢 iczer 提供的主题切换功能
• 感谢 vueComponent 提供的前端框架