开源软件名称：

开源软件地址：

开源软件介绍：

一、项目简介

一直都想按照自己的想法去开发一个基于SpringBoot的javaWeb快速开发平台(基础开发框架)，利用业余时间，从0到1，终于按照自己的想法去实现了一个基于SpringBoot的java快速开发平台，我将其命名为【magic4j】，寓意【神奇的、魔法般的Java开发平台】。

magic4j是一个【前后端分离】快速开发平台，支持【多租户】，基于 Spring Boot、mybatisPlus 和 Vue 开发，可以用于所有的Web应用程序，内置了许多通用性的功能模块，如用户管理、角色管理、资源管理等。magic4j旨在帮助中小型企业及个人实现项目的快速开发和交付。

二、主要特性

• 采用业界主流的【前后端分离】的开发模式，前端开源框架采用【vue-element-admin】 (基于 Vue、Element-UI)
• 后端采用【Springboot+Mybatis-Plus+jwt+redis】等主流的技术栈实现，并对其基础的【缓存组件】、【文件存储组件】做了高度的封装，提供了多种实现，做到开箱即用，多种实现方式灵活切换。
• 基于Mybatis-Plus实现的功能强大的【代码生成器】、根据自定义模板生成Entity、Mapper、Mppper.xml、DTO、Service、Controller代码，生成的文件直接到相应的业务模块，省去文件拷贝步骤，灵活可控。
• 采用全新的思路自主实现了基于【RBAC模型的权限管理】，实现了【菜单权限】、【功能权限】、【数据权限】的细致化访问权限控制。
• 支持【多租户】，租户数据隔离方案为：【共享数据库、Schema、数据表】，通过在表中增加【tenant_id】字段+【多租户SQL解析器】优雅地实现租户数据隔离。同时支持【一键开启或者关闭】多租户模式
• 使用【Mybatis拦截器】优雅的实现了数据权限，根据角色所拥有的数据权限范围在执行SQL查询过程中动态拼接过滤条件，实现数据过滤。同时支持【一键开启或者关闭】数据权限控制
• 支持【jwt和自定义Token】两种用户登录Token认证，系统默认使用的Jwt进行ToKen认证，可以通过修改application.yml配置文件切换Token的认证方式，根据情况自由选择。
• 自带了【缓存组件】，提供基于注解和API两种使用方式，基于【Redis和caffeine】两种实现方式，可以通过修改application.yml配置文件切换缓存的实现，Redis的方式又支持【单机和集群】两种模式。这样可以做到开发阶段使用caffeine、测试阶段使用Redis单机，生产使用Redis集群三种方式自由切换。
• 支持【本地】、【sftp】、【FastDFS】、【minio】以及第三方【阿里云OSS】、【腾讯云COS】、【七牛云存储】多种文件存储服务，可动态任意切换。
• 注重【数据安全】传输，提供了【RSA和AES】两种加密方式，客户端通过调用RestFul API获取到RSA加密公钥和AES加密密钥，将客户端的敏感数据加密后传输。同时提供了通用的数据解密过滤器，在请求到达业务处理接口之前，将数据解密成明文，免去了接口手动处理解密步骤，专注业务实现逻辑。
• 注重【密码安全】传输，对于登录、修改密码、重置密码这些涉及到密码传输的操作都使用了RSA加密后再传输到服务端，避免了密码直接明文暴露传输。
• 支持【自定义密码验证规则】，可以灵活设置【密码长度】、至少包含的【大小写字母】、【数字】、【特殊字符】等组成规则，增加密码的复杂度
• 使用【ThreadLocal管理登录用户信息】实现随用随取，可以在任何方法中很方便的获取用户信息
• 注重日志信息收集，系统日志细分为【登录日志】和【操作日志】，详细记录的了用户的操作行为和登录行为，通过系统日志可以很清新地知道用户对系统进行的相关操作。
• 整合Quartz做【分布式定时任务】，并记录了任务【执行日志】，任务执行情况一目了然。
• 使用【拦截器实现防止重复提交】，保证一些关键性操作的幂等性。
• 完善的【用户】、【角色】、【菜单】、【组织机构】、【岗位】、【数据字典】、【系统配置】等基础功能。
• 接口访问统一采用标准的restful方式，集成swagger-ui在线接口文档，支持跨域请求调用，服务端采用主流的cros作为跨域解决方案。
• 支持【MySQL】和【Postgresql】两种主流数据库，其他主流的数据库Oracle和SQLServer理论上也都支持。
• 强大的底层封装，提供了自定义注解Auth、AutoIdempotent、Encrypt、Log、DataScope，优雅地实现了访问权限验证、方法幂等性校验，数据统一解密处理、AOP日志记录，数据权限控制。
• 自定义了【cloudStorage-spring-boot-starter】、【minio-spring-boot-starter】、【fastdfs-spring-boot-starter】、【jsch-spring-boot-starter】，方便以starter快速集成oss、cos、kodo、minio、fastdfs、jsch。
• 自定义【mqttClient-spring-boot-starter】，方便以starter快速集成mqtt客户端进行消息订阅和发布，starter底层已经做好mqtt-broker通信连接，掉线重连，topic订阅，业务层只需要专注于业务消息接收和发布。
• 大部分基础功能模块都支持Excel导入导出功能，导出到Excel支持自定义选择需要导出列，支持按选择的行进行导出。
• 基于spring-boot-starter-websocket实现【websocket消息推送】功能，支持【一键开启或者关闭】websocket功能，支持集群部署，集群节点之间的消息通信有redis和rocketMQ两种模式，可以自由切换任意一种。
• 集成了【阿里云短信】功能
• 基于Maven构建的多模块项目，支持分环境(stage、prod)打包，预设了大量的环境变量，便于运维人员部署时动态替换相关配置(如DB连接地址、用户名、密码)

三、内置功能

1. 用户管理：管理系统用户，实现对用户增删改查、批量禁用和启用，重置密码，Excel导入导出
2. 部门管理：管理系统组织机构（公司、部门），树结构展现，支持数据权限。
3. 岗位管理：管理系统用户所属担任职务。
4. 菜单管理：管理系统菜单，树结构展现。
5. 角色管理：角色菜单权限、操作权限分配、设置角色按部门进行数据范围权限划分。
6. 租户管理：管理合作的租户信息
7. 字典管理：对系统中经常使用的一些较为固定的数据进行维护。
8. 安全设置：用于帐号锁定设置和配置密码验证规则。
9. 平台设置：用于设置系统的Logo和系统名称
10. 配置管理：对系统动态配置常用参数进行维护。
11. 操作日志：记录用户对系统进行的增删改行为，支持按操作用户、业务模块、操作结果、操作时间多维度组合的数据查询。
12. 登录日志：记录用户的登录操作，支持按登录用户、登录结果、登录时间多维度组合的数据查询。
13. 定时任务：在线添加、修改、删除、执行、暂停、恢复调度任务。
14. 调度日志：记录调度任务的执行情况。
15. 文件管理：普通文件上传、下载、管理上传文件。
16. 表单构建器：拖动表单元素生成相应的HTML代码。
17. 二维码管理：基于google的zxing实现的生成二维码功能。
18. 区域管理：对中国省市县行政区域基础数据进行管理
19. 用户访问地图：基于地图的方式统计来自各个省份城市的访问次数
20. 实用案例：百度地图集成案例

四、技术选型

4.1、开发环境

• JDK：JDK 1.8
• IDE： IntelliJ IDEA，安装lombok插件、MybatisX快速开发插件。MybatisX 是一款基于 IDEA 的快速开发插件，为效率而生。 安装方法：打开 IDEA，进入 File -> Settings -> Plugins -> Browse Repositories，输入 mybatisx 搜索并安装。
• 依赖管理：Maven3.x
• 数据库：MySQL5.7或者MySQL8
• 缓存：如果使用的是Redis缓存，则需要安装Redis
• 文件服务器：如果将文件上传到FastDFS，则需要搭建FastDFS文件服务器
• Nginx：负载均衡以及静态资源访问服务器，部署magic-ui前端项目需要使用到nginx

4.2、后端

• 基础框架：Spring Boot 2.2.6.RELEASE
• 持久化框架：Mybatis-Plus_3.4.0
• 数据库：MySQL
• 安全框架：权限拦截器+自定义注解实现类似Shiro的细粒度权限控制
• JwtToken生成与解析：jjwt_0.9.0
• 数据库连接池：Hikari，一款非常强大,高效,并且号称“史上最快连接池”。在SpringBoot2.0之后,采用的默认数据库连接池就是Hikari
• 缓存框架：redis+caffeine
• 文件存储：oss、cos、kodo、fastdfs、sftp
• 定时任务：quartz
• 日志框架：logback
• 工具包：hutool
• excel导入导出：easyexcel
• 二维码生成：zxing
• 自定义密码验证规则：passay
• 其他：fastjson，jsch, lombok等。

4.3、前端

• Vue2.6.10
• Vuex
• Vue Router
• Axios
• ElementUI2.13.0
• vue-element-admin(UI框架)
• jsencrypt(Rsa加密)
• crypto-js(Aes加密、sha256加密、md5加密、base64编码)

五、项目结构

5.1、magic4j服务端

5.2、magic4j前端

六、在线体验

6.1、演示

地址：http://magic4j.itgacl.com
演示账号：admin(系统管理员) 密码：123456

6.2、演示效果

6.2.1、用户访问地理位置分布图

6.2.2、用户管理

6.2.3、资源管理

6.2.4、角色管理

6.2.5、菜单管理

6.2.6、系统配置

6.2.7、数据字典

6.2.8、安全设置

6.2.9、平台设置

6.2.10、区域管理

6.2.11、租户信息

6.2.12、租户用户

6.2.13、组织机构

6.2.14、岗位管理

6.2.15、文件管理

6.2.16、登录日志

6.2.17、操作日志

6.2.18、任务管理

6.2.19、调度日志

6.2.20、接口文档

6.2.21、二维码管理

6.2.22、地图集成案例

七、成功案例

7.1、接龙小程序

7.2、共享雨伞小程序

7.3、物联网应用平台

八、二次开发

1、获取服务端项目地址： https://gitee.com/gacl/magic4j
2、获取前端UI项目地址：https://gitee.com/gacl/magic4j-ui
3、magic4j技术文档：https://www.yuque.com/guaocanglang/ckv3h8

九、项目合作

9.1、关于我

本人有9年的软件开发经验，先后担任过技术主管，java高级工程师、技术负责人、java架构师，擅长架构设计，有多年的架构设计经验，现在是担任软件研发总监，擅长分布式JavaWeb应用，物联网应用，微信公众号、微信小程序的应用开发，擅长JavaEE开发中常用的SpringBoot、SpringCloud、Netty、JFinal、motan、shiro、MyBatis、MyBatisPlus、Spring-data-jpa、casandra、mongodb等框架，有基于motan和SpringCloud实现的微服务化的项目实战经验。有基于SpringBoot+Netty的物联网项目开发实战经验。掌握Vue.js、webpack、node.js、element-ui、vue-element-admin等主流前端技术的使用

9.2、联系我

如有项目合作，或者使用magic4j的过程中遇到了问题，可以通过以下方式与我联系！

十、关注我