Erupt Framework-通用后台管理框架-入门案例01

Erupt 是一个低代码 全栈类 框架，它使用 Java 注解 动态生成页面以及增、删、改、查、权限控制等后台功能。
零前端代码、零 CURD、自动建表，仅需 一个类文件 + 简洁的注解配置，快速开发企业级 Admin 管理后台。
提供企业级中后台管理系统的全栈解决方案，大幅压缩研发周期，专注核心业务。
完美取代 代码生成器，开发后台管理系统更优解！

官方网址：https://www.erupt.xyz/#!/
源码地址：https://gitee.com/erupt/erupt

官方提供了非常详细的新手入门文档，我们现在按照文档一步一步搭建一个入门级项目。

1.准备工作，快速搭建Springboot项目

环境要求
Java 版本 1.8.0 及以上 15 及以下，支持 GraalVM
Spring Boot 版本 2.0 及其以上
浏览器要求 IE11 及以上，或其他现代浏览器

快速搭建springboot：idea快速搭建springboot项目

1.1搭建父工程

file->new->project

注意选择java verson 8 我们开发一般都选择这个比较稳定，注意Erupt只支持15以下的版本，其他的暂时默认，后面我们会 修改pom文件，然后这个做为父工程，src下的都会删除。

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.erupt</groupId>
    <artifactId>Erupt_parent</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <modules>
        <module>Erupt_web</module>
    </modules>
    <name>Erupt_parent</name>
    <description>parent project for Spring Boot</description>
    <packaging>pom</packaging>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.5</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

Erupt_web是我们后续加的模块，注意Spring Boot 版本 2.0 及其以上
我们选择的2.4.5
因为官方网站就是2.4.5下开发的

1.8.5 (2021年09月18日)
Spring boot版本：2.4.5

1.2搭建子工程

2.在pom.xml添加erupt依赖包，版本号详见

这是子工程的pom文件 下添加

<!--用户权限管理-->
<dependency>
  <groupId>xyz.erupt</groupId>
  <artifactId>erupt-upms</artifactId>
  <version>${erupt.version}</version>
</dependency>
<!--接口数据安全-->
<dependency>
  <groupId>xyz.erupt</groupId>
  <artifactId>erupt-security</artifactId>
  <version>${erupt.version}</version>
</dependency>
<!--后台WEB界面-->
<dependency>
  <groupId>xyz.erupt</groupId>
  <artifactId>erupt-web</artifactId>
  <version>${erupt.version}</version>
</dependency>
<!-- mysql驱动包，其他数据库驱动依赖请查阅 Maven Repository → https://mvnrepository.com -->
<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>8.0.16</version>
  <scope>runtime</scope>
</dependency>

erupt.version我们选择1.8.5最新版本

3.在资源目录下创建如下配置文件

文件位置 功能说明 详细配置
resources/public/app.js 前端配置文件，可修改标题，更改Logo，页面生命周期函数等。 #
resources/public/app.css 前端样式文件（可不创建） #
resources/public/home.html 前端首页布局（不创建，首页会出现404） #

4.在 application.yml / application.properties 中添加数据库配置与JPA配置

server:
  port: 8011

# application.yml写法
spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/erupt?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
    username: root
    password: 11111
  jpa:
    show-sql: true
    generate-ddl: true
    open-in-view: true
    database-platform: org.hibernate.dialect.MySQL5InnoDBDialect
    database: mysql

erupt可以是空的数据库，后面项目启动会反写

5.Spring Boot入口类添加 @EntityScan 注解、@EruptScan 注解

package com.web;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import xyz.erupt.core.annotation.EruptScan;

@SpringBootApplication
@EntityScan
@EruptScan
public class EruptApplication {
    public static void main(String[] args) {
        SpringApplication.run(EruptApplication.class, args);
    }
}

目录结构现在如下

6.启动成功后浏览器访问：http://localhost:8011

默认用户名密码：erupt / erupt