Erupt简介

Erupt 是一个低代码 全栈类 框架，它使用 Java 注解 动态生成页面以及增、删、改、查、权限控制等后台功能。

零前端代码、零 CURD、自动建表，仅需 一个类文件 + 简洁的注解配置，快速开发出企业级 Admin 管理后台。

提供企业级中后台管理系统的全栈解决方案，大幅压缩研发周期，专注核心业务。

完美取代 代码生成器，开发后台管理系统更优解！

特性

• 易于上手：会简单的 Spring Boot 基础知识即可
• 使用简单：仅需了解 @Erupt 与 @EruptField 两个注解即可上手开发
• 代码简洁：前端零代码，后端 template、controller、service、dao 都不需要，仅需一个类文件即可
• 敏捷开发：仅单个.java文件即可实现后台管理功能，专注业务与核心功能的研发
• 快速迭代：需求变更仅需修改或添加注解配置即可，迭代速度比需求讨论速度还快
• 功能强大：动态条件处理，支持增删改查等功能代理接口，Session存储机制选择，行为日志记录等
• 自动建表：依托于JPA可自动帮你完成数据库建表相关工作
• 低侵入性：几乎所有功能都围绕注解而展开，不影响Spring Boot其他功能或三方库库的使用
• 多数据源：支持：MySQL、Oracle、SQL Server、PostgreSQL、H2，甚至支持 MongoDB
• 大量组件：滑动输入、时间选择、一对多、图片上传、代码编辑器、自动完成、树、多对多、地图等23类组件
• 丰富展示：普通文本、二维码、链接、图片、HTML、代码段、iframe、swf等
• 代码生成：erupt代码已经足够简洁，代码生成器可进一步提升开发效率
• 高扩展性：支持自定义数据源实现、自定义页面、动态权限管理、生命周期函数、自定义OSS等
• 界面美观：每个交互都精心设计，产品思维打磨，只为了更好的操作体验
• 权限管理：用户管理、角色管理、组织管理、菜单管理、登录日志、操作日志等
• 高安全性：可靠的安全机制，登录白名单，权限验证，注解项检查，细颗粒度权限控制，为你的数据保驾护航
• 响应式布局：支持PC端手机端等各种规格的设备中使用
• 无需二次开发：仅需引用 jar 包即可 ！
• 支持扩展页面：可开发自定义页面，自定义弹出层，且支持：原生H5 / Freemarker / Thymeleaf等方式渲染

环境搭建

环境依赖

• Java 版本 1.8.0 及以上
• Spring Boot 版本 2.0 及其以上
• 数据库默认MySql，可使用MySql5.7
• 前端：Node.js 10.9.0 或更高版本
• 浏览器：主流浏览器即可

代码示例

采用前后端分离的方式开发，可对前后端分别进行部署。

后端部署

这里采用下载源码，导入IDE编译运行的方式进行。

1.使用git下载erupt示例源码

git clone https://gitee.com/erupt/erupt-example.git

2.编译运行

使用IntelliJ IDEA开发工具打开源码并修改配置文件。

erupt:
  # 是否开启csrf防御
  csrfInspect: true
  # 是否开启redis方式存储session，默认false，开启后需在配置文件中添加redis配置（同 spring boot）
  redisSession: false
  # 附件上传存储路径, 默认路径为：/opt/erupt-attachment
  uploadPath: D:/erupt/attachment
  # 是否保留上传文件原始名称
  keepUploadFileName: false
  # 登录session时长（redisSession为true时有效）
  upms.expireTimeByLogin: 60
  # 是否记录操作日志，默认true，该功能开启后可在【系统管理 → 操作日志】中查看操作日志
  security.recordOperateLog: true
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/erupt-example?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
    username: root
    password: 123456

如上代码段所示，根据本地环境，修改附件上传存储路径uploadPath为本地实际存储路径；

修改数据库连接字符串：spring:datasource:url，账户密码根据自己本地数据库信息进行填写，修改完成后编译程序。

初始化数据库

首先手动创建数据库"erupt-example"，然后运行ExampleApplication，程序启动后会自动初始化数据库。

前端部署

1.使用git下载erupt前端源码erupt-web

git clone https://gitee.com/erupt/erupt-web.git

2.安装依赖并启动前端

安装依赖

yarn install

修改接口url：在根目录打开proxy.config.json文件，并修改key值为target的值为服务端对应的url地址，修改完成后启动即可。

proxy.config.json

{
  "/": {
    "target":"http://localhost:8080",
    "secure":false,
    "logLevel":"info",
    "changeOrigin":true
  }
}

yarn run start

简单使用

默认用户名：erupt 默认密码：erupt

输入http://127.0.0.1:4400/（我本地设置的前端端口为4400），进入登录页面，并输入密码，首次登录成功会提示修改密码，登录成功如下图所示。

Erupt 使用 Apache License 2.0 协议，源代码完全开源，无商业限制。 开源不易如果喜欢请给作者 Star 鼓励