Erupt簡介

Erupt 是一個低代碼 全棧類 框架，它使用 Java 注解 動態(tài)生成頁面以及增、刪、改、查、權限控制等后臺功能。

零前端代碼、零 CURD、自動建表，僅需 一個類文件 簡潔的注解配置，快速開發(fā)出企業(yè)級 Admin 管理后臺。

提供企業(yè)級中后臺管理系統的全棧解決方案，大幅壓縮研發(fā)周期，專注核心業(yè)務。

完美取代 代碼生成器，開發(fā)后臺管理系統更優(yōu)解！

特性

• 易于上手：會簡單的 Spring Boot 基礎知識即可
• 使用簡單：僅需了解 @Erupt 與 @EruptField 兩個注解即可上手開發(fā)
• 代碼簡潔：前端零代碼，后端 template、controller、service、dao 都不需要，僅需一個類文件即可
• 敏捷開發(fā)：僅單個.java文件即可實現后臺管理功能，專注業(yè)務與核心功能的研發(fā)
• 快速迭代：需求變更僅需修改或添加注解配置即可，迭代速度比需求討論速度還快
• 功能強大：動態(tài)條件處理，支持增刪改查等功能代理接口，Session存儲機制選擇，行為日志記錄等
• 自動建表：依托于JPA可自動幫你完成數據庫建表相關工作
• 低侵入性：幾乎所有功能都圍繞注解而展開，不影響Spring Boot其他功能或三方庫庫的使用
• 多數據源：支持：MySql、Oracle、SQL Server、PostgreSQL、H2，甚至支持 MongoDB
• 大量組件：滑動輸入、時間選擇、一對多、圖片上傳、代碼編輯器、自動完成、樹、多對多、地圖等23類組件
• 豐富展示：普通文本、二維碼、鏈接、圖片、HTML、代碼段、iframe、swf等
• 代碼生成：erupt代碼已經足夠簡潔，代碼生成器可進一步提升開發(fā)效率
• 高擴展性：支持自定義數據源實現、自定義頁面、動態(tài)權限管理、生命周期函數、自定義OSS等
• 界面美觀：每個交互都精心設計，產品思維打磨，只為了更好的操作體驗
• 權限管理：用戶管理、角色管理、組織管理、菜單管理、登錄日志、操作日志等
• 高安全性：可靠的安全機制，登錄白名單，權限驗證，注解項檢查，細顆粒度權限控制，為你的數據保駕護航
• 響應式布局：支持PC端手機端等各種規(guī)格的設備中使用
• 無需二次開發(fā)：僅需引用 jar 包即可 ！
• 支持擴展頁面：可開發(fā)自定義頁面，自定義彈出層，且支持：原生H5 / Freemarker / Thymeleaf等方式渲染

環(huán)境搭建

環(huán)境依賴

• Java 版本 1.8.0 及以上
• Spring Boot 版本 2.0 及其以上
• 數據庫默認MySql，可使用MySql5.7
• 前端：Node.js 10.9.0 或更高版本
• 瀏覽器：主流瀏覽器即可

代碼示例

采用前后端分離的方式開發(fā)，可對前后端分別進行部署。

后端部署

這里采用下載源碼，導入IDE編譯運行的方式進行。

1.使用git下載erupt示例源碼

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

2.編譯運行

使用IntelliJ IDEA開發(fā)工具打開源碼并修改配置文件。

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: truespring: datasource: url: jdbc:mysql://localhost:3306/erupt-example?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai username: root password: 123456

如上代碼段所示，根據本地環(huán)境，修改附件上傳存儲路徑uploadPath為本地實際存儲路徑；

修改數據庫連接字符串：spring:datasource:url，賬戶密碼根據自己本地數據庫信息進行填寫，修改完成后編譯程序。

初始化數據庫

首先手動創(chuàng)建數據庫"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 協議，源代碼完全開源，無商業(yè)限制。 開源不易如果喜歡請給作者 Star 鼓勵