干掉前端！3分钟纯 Java 注解搭个管理系统，我直接好家伙-51CTO.COM

本文转载自微信公众号「程序员内点事」，作者程序员内点事。转载本文请联系程序员内点事公众号。

大家好，我是小富~

最近接触到个新项目，发现它用了一个比较有意思的框架，可以说实现了我刚入行时候的梦想，所以这里马不停蹄的和大家分享下。

我刚开始工作接触的项目都还没做前后端分离，经常需要后端来维护页面，有时候觉得自己好像天生不适合干前端，你要是让我研究研究后端的技术，看个中间件源码啊，分析分析什么框架底层原理啊，这都问题不大，偶尔搞一下JS也可以。你要是让我写个css样式，那简直要命了，一点也提不起兴趣，不知道有没有跟我一样的。

今天要介绍的框架直接不用写页面了，话不多说，下边咱们直奔主题

Erupt一个通用后台管理框架，据说有超低代码量、零前端代码、零 CURD操作、无需建表，纯Java注解开发等特色，号称三分钟就可以搭建一个完整的后台管理系统。

额~ 听着好像还挺流批的，到底是不是有这么魔幻，咱们一起用起来感受下。

首先来搭建一下环境，目前Erupt支持Java版本1.8.0及以上、Spring Boot版本2.0及其以上。

搭建easy

pom.xml引入必要的jar包

<dependencies> 
    <dependency> 
        <groupId>org.springframework.boot</groupId> 
        <artifactId>spring-boot-starter</artifactId> 
    </dependency> 
    <dependency> 
        <groupId>mysql</groupId> 
        <artifactId>mysql-connector-java</artifactId> 
    </dependency> 
    <!--用户权限管理--> 
    <dependency> 
        <groupId>xyz.erupt</groupId> 
        <artifactId>erupt-upms</artifactId> 
        <version>1.6.7</version> 
    </dependency> 
    <!--接口数据安全--> 
    <dependency> 
        <groupId>xyz.erupt</groupId> 
        <artifactId>erupt-security</artifactId> 
        <version>1.6.7</version> 
    </dependency> 
    <!--后台WEB界面--> 
    <dependency> 
        <groupId>xyz.erupt</groupId> 
        <artifactId>erupt-web</artifactId> 
        <version>1.6.7</version> 
    </dependency> 
    <dependency> 
        <groupId>org.springframework.boot</groupId> 
        <artifactId>spring-boot-starter-tomcat</artifactId> 
        <scope>compile</scope> 
    </dependency> 
</dependencies>

application.yml 文件只要简单配置数据源就好，提前准备个数据库，说到数据库这里我说个小插曲。

我之前在Github 提交案例代码的时候(https://github.com/chengxy-nds/Springboot-Notebook )，由于没太注意没屏蔽敏感信息，导致云数据库账号泄露了，最近我发现已经有小伙伴在数据库上跑项目了，仔细看了看里边的数据结构，发现像是个毕设项目。

本身这个库就是我跑demo案例的一个测试库，为的就是让小伙伴能把更多时间放在研究案例的技术点上，减少搭建环境这种没技术含量的琐碎事。

发现归发现，这里我没改密码，也没删他们的库，如果你要用就继续用着，但玩归玩，闹归闹，你不能乱动不是你的数据!影响其他人学习就不好了。

spring: 
  datasource: 
    url: jdbc:mysql://47.93.6.5:3306/erupt2?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai 
    username: root 
    password: 123456 
  jpa: 
    show-sql: true 
    generate-ddl: true 
    database-platform: org.hibernate.dialect.MySQL5InnoDBDialect 
    database: mysql 
  profiles: 
    active: dev 
  mail: 
    username: xxxx@qq.com 
    password: xxxxxxx 
    host: smtp.qq.com 
    properties: 
      mail.smtp.ssl.auth: true 
      mail.smtp.ssl.enable: true 
      mail.smtp.ssl.required: true 
server: 
  port: 8888

说了点题外话，我们继续搞起~

其实到这Erupt的环境就搭建完了，额~ ，这就完了?

咱们什么也没干，项目是个空壳子，一行代码也没写，好像连个表也没建啊!

别着急咱们先启动下项目，看到控制台打印出很多建表语句和插入语句，这是因为Erupt框架底层应用JPA持久化，预置创建了一些系统表和数据。

注意：Erupt预置表只会随项目第一次启动构建一次，如果想重新创建，需删除.Erupt文件(一般在项目的工作空间内)，获取文件位置方式

System.getProperty("user.dir")

再看数据库里创建了16张系统表，其中e_upms_user表是用户表，默认只有一个管理员账号，用户名、密码都是erupt。

紧接着我们访问http://127.0.0.1:8888/，看一下是个什么效果，竟然有个完整的登录页面。

用上边的用户名、密码直接登录，erupt已经预先实现了完整的权限控等功能，而到这我们几乎是没写过什么代码的，都是框架封装好了的，菜单类数据全部从数据库动态获取，一个基础的后台管理系统就搭建完了，有点哇塞。

有趣的页面

那么问题来了?想要自定义页面怎么办?

开篇我们就说过erupt是零前端代码，全部基于Java注解开发的，接下来用Java注解写个简单页面体验下。

erupt有两个核心注解@Erupt，@EruptField
@Erupt注解修饰类，代表定义一个页面
@EruptField注解修饰字段，代表页面上显示的字段名
@Power注解控制是否操作按钮，增、删、改、查、导入、导出等
@Search注解表示字段为搜索条件
@Table注解表示页面取数据对应的表，如果不设置，页面第一次初始化的时候，会根据类字段值自动创建一张和类名一致的表名。

注解类型比较多，不一一列举了，更多的自己到官网瞅：https://www.erupt.xyz

下边我们定义一个Student类，加上@Erupt，@EruptField注解，这样页面和元素就算写完了，是不是有点颠覆认知。

/* 
 *  @Erupt注解修饰在类上，@EruptField注解修饰在字段上 
 *  其他注解均为Jpa注解 
 */ 
@Getter 
@Setter 
@Erupt(name = "学生表", 
        power = @Power(importable = true, export = true) 
) 
@Entity 
//@Table(name = "t_student") 
public class Student extends BaseModel { 
 
    @EruptField( 
            views = @View(title = "学生姓名"), 
            edit = @Edit(title = "学生姓名", notNull = true, search = @Search(vague = true)) 
    ) 
    private String studentName; 
 
    @EruptField( 
            views = @View(title = "所属班级"), 
            edit = @Edit(title = "所属班级", notNull = true) 
    ) 
    private String studentClass; 
 
    @EruptField( 
            views = @View(title = "学生年龄"), 
            edit = @Edit(title = "学生年龄", notNull = true) 
    ) 
    private String studentAge; 
 
    @Lob 
    @EruptField( 
            views = @View(title = "学生性别"), 
            edit = @Edit(title = "学生性别", notNull = true) 
    ) 
    private String studentSex; 
 
    @EruptField( 
            views = @View(title = "考核状态"), 
            edit = @Edit(title = "考核状态", notNull = true, boolType = @BoolType(trueText = "通过", falseText = "挂科"), search = @Search) 
    ) 
    private Boolean status; 
}

但此时新创建的页面不会显示出来，还需要我们手动做一个映射关系，在菜单维护中自定义个菜单，类型值一定要为新建的类名 Student。

保存刷新后会看到我们的新页面出现了，而且页面的功能很完整，基础操作、查询、导入、导出功能都自动实现了。

页面新增一个学生信息，对应的Student表也多了条记录，而这个持久化的过程完全由框架来做。

尽管Erupt 框架对前后端代码做了深度封装，但它提供了丰富灵活的自定义接口，来满足我们的个性化需求。

比如我们在录入新学生信息时，希望屏蔽名字为张三的同学，可以对页面按钮功能做代理dataProxy，实现自定义的逻辑，对哪个按钮代理就实现对应方法即可，如beforeAdd、afterAdd是对新增按钮的代理。

@Getter 
@Setter 
@Erupt(name = "学生表",dataProxy = {StudentDataProxy.class}, 
        power = @Power(importable = true, export = true) 
) 
@Entity 
//@Table(name = "t_student") 
public class Student extends BaseModel { 
 
} 
public class StudentDataProxy implements DataProxy<Student> { 
 
    @Override 
    public void beforeAdd(Student student) { 
        //后台字段校验 
        if ("张三".equals(student.getStudentName())) { 
            throw new EruptApiErrorTip("名称禁止为张三！"); 
        } 
    } 
 
    @Override 
    public void afterAdd(Student student) { 
 
    } 
    @Override 
    public void afterUpdate(Student student) { 
 
    } 
 
    @Override 
    public void afterDelete(Student student) { 
    } 
 }