【前后端的那些事】开源！前后端环境搭建+树形结构表格实现

前言：最近写项目，发现了一些很有意思的功能，想写文章，录视频把这些内容记录下。但这些功能太零碎，如果为每个功能都单独搭建一个项目，这明显不合适。于是我想，就搭建一个项目，把那些我想将的小功能全部整合到一起。实现搭一次环境，处处使用。

本文主要实现一下两个功能

1. 前后端项目搭建
2. 表格展示树形数据

已录制视频
b站视频链接

仓库地址
https://github.com/xuhuafeifei/fgbg-font-and-back.git

1. 前后端项目环境搭建

前端：pure-admin-thin + renren-fast-vue

后端：springboot 2.7.5 + renren-fast

前端

• 克隆pure-admin-thin

  git clone https://github.com/pure-admin/pure-admin-thin.git
  

• 安装前端依赖

  pnpm i
  

• 运行前端项目

  pnpm run dev
  

后端

• 构建springboot项目

• pom.xml

      <properties>
          <java.version>1.8</java.version>
          <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
          <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
          <java.version>1.8</java.version>
          <mybatisplus.version>3.3.1</mybatisplus.version>
          <mysql.version>8.0.28</mysql.version>
          <mssql.version>4.0</mssql.version>
          <oracle.version>11.2.0.3</oracle.version>
          <druid.version>1.1.13</druid.version>
          <quartz.version>2.3.0</quartz.version>
          <commons.lang.version>2.6</commons.lang.version>
          <commons.fileupload.version>1.2.2</commons.fileupload.version>
          <commons.io.version>2.5</commons.io.version>
          <commons.codec.version>1.10</commons.codec.version>
          <commons.configuration.version>1.10</commons.configuration.version>
          <shiro.version>1.9.0</shiro.version>
          <jwt.version>0.7.0</jwt.version>
          <kaptcha.version>0.0.9</kaptcha.version>
          <qiniu.version>7.2.23</qiniu.version>
          <aliyun.oss.version>2.8.3</aliyun.oss.version>
          <qcloud.cos.version>4.4</qcloud.cos.version>
          <swagger.version>2.7.0</swagger.version>
          <joda.time.version>2.9.9</joda.time.version>
          <gson.version>2.8.5</gson.version>
          <hutool.version>4.1.1</hutool.version>
          <lombok.version>1.18.4</lombok.version>
      </properties>
  
  
      <dependencies>
          <dependency>
              <groupId>com.fasterxml.jackson.datatype</groupId>
              <artifactId>jackson-datatype-jsr310</artifactId>
          </dependency>
  
          <!--日志-->
          <dependency>
              <groupId>ch.qos.logback</groupId>
              <artifactId>logback-classic</artifactId>
          </dependency>
          <dependency>
              <groupId>ch.qos.logback</groupId>
              <artifactId>logback-access</artifactId>
          </dependency>
          <dependency>
              <groupId>ch.qos.logback</groupId>
              <artifactId>logback-core</artifactId>
          </dependency>
          <dependency>
              <groupId>commons-dbcp</groupId>
              <artifactId>commons-dbcp</artifactId>
              <version>1.4</version>
          </dependency>
  
          <dependency>
              <groupId>com.auth0</groupId>
              <artifactId>java-jwt</artifactId>
              <version>3.2.0</version>
          </dependency>
  
          <dependency>
              <groupId>com.aliyun</groupId>
              <artifactId>dysmsapi20170525</artifactId>
              <version>2.0.23</version>
          </dependency>
  
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-validation</artifactId>
          </dependency>
          <dependency>
              <groupId>commons-io</groupId>
              <artifactId>commons-io</artifactId>
              <version>2.11.0</version>
          </dependency>
          <dependency>
              <groupId>javax.annotation</groupId>
              <artifactId>javax.annotation-api</artifactId>
          </dependency>
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-jdbc</artifactId>
          </dependency>
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-thymeleaf</artifactId>
          </dependency>
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-web</artifactId>
          </dependency>
          <dependency>
              <groupId>com.baomidou</groupId>
              <artifactId>mybatis-plus-boot-starter</artifactId>
              <version>${mybatisplus.version}</version>
              <exclusions>
                  <exclusion>
                      <groupId>com.baomidou</groupId>
                      <artifactId>mybatis-plus-generator</artifactId>
                  </exclusion>
              </exclusions>
          </dependency>
          <dependency>
              <groupId>org.apache.shiro</groupId>
              <artifactId>shiro-core</artifactId>
              <version>${shiro.version}</version>
          </dependency>
          <dependency>
              <groupId>org.apache.shiro</groupId>
              <artifactId>shiro-spring</artifactId>
              <version>${shiro.version}</version>
          </dependency>
          <dependency>
              <groupId>io.jsonwebtoken</groupId>
              <artifactId>jjwt</artifactId>
              <version>${jwt.version}</version>
          </dependency>
          <dependency>
              <groupId>com.github.axet</groupId>
              <artifactId>kaptcha</artifactId>
              <version>${kaptcha.version}</version>
          </dependency>
          <dependency>
              <groupId>io.springfox</groupId>
              <artifactId>springfox-swagger2</artifactId>
              <version>${swagger.version}</version>
          </dependency>
          <dependency>
              <groupId>io.springfox</groupId>
              <artifactId>springfox-swagger-ui</artifactId>
              <version>${swagger.version}</version>
          </dependency>
          <dependency>
              <groupId>com.qiniu</groupId>
              <artifactId>qiniu-java-sdk</artifactId>
              <version>${qiniu.version}</version>
          </dependency>
          <dependency>
              <groupId>com.aliyun.oss</groupId>
              <artifactId>aliyun-sdk-oss</artifactId>
              <version>${aliyun.oss.version}</version>
          </dependency>
          <dependency>
              <groupId>com.qcloud</groupId>
              <artifactId>cos_api</artifactId>
              <version>${qcloud.cos.version}</version>
              <exclusions>
                  <exclusion>
                      <groupId>org.slf4j</groupId>
                      <artifactId>slf4j-log4j12</artifactId>
                  </exclusion>
              </exclusions>
          </dependency>
          <dependency>
              <groupId>joda-time</groupId>
              <artifactId>joda-time</artifactId>
              <version>${joda.time.version}</version>
          </dependency>
          <dependency>
              <groupId>com.alibaba</groupId>
              <artifactId>fastjson</artifactId>
              <version>1.2.79</version>
          </dependency>
          <dependency>
              <groupId>com.google.code.gson</groupId>
              <artifactId>gson</artifactId>
              <version>${gson.version}</version>
          </dependency>
          <dependency>
              <groupId>cn.hutool</groupId>
              <artifactId>hutool-all</artifactId>
              <version>${hutool.version}</version>
          </dependency>
          <dependency>
              <groupId>org.projectlombok</groupId>
              <artifactId>lombok</artifactId>
              <version>${lombok.version}</version>
          </dependency>
          <dependency>
              <groupId>mysql</groupId>
              <artifactId>mysql-connector-java</artifactId>
          </dependency>
          <dependency>
              <groupId>commons-lang</groupId>
              <artifactId>commons-lang</artifactId>
              <version>${commons.lang.version}</version>
          </dependency>
          <dependency>
              <groupId>org.aspectj</groupId>
              <artifactId>aspectjweaver</artifactId>
          </dependency>
          <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-data-redis -->
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-data-redis</artifactId>
              <version>2.7.5</version>
          </dependency>
          <!-- https://mvnrepository.com/artifact/org.springframework.data/spring-data-redis -->
          <dependency>
              <groupId>org.springframework.data</groupId>
              <artifactId>spring-data-redis</artifactId>
              <version>2.7.5</version>
          </dependency>
  
          <dependency>
              <groupId>javax.servlet</groupId>
              <artifactId>javax.servlet-api</artifactId>
              <version>3.1.0</version>
          </dependency>
          <dependency>
              <groupId>com.alibaba</groupId>
              <artifactId>druid-spring-boot-starter</artifactId>
              <version>1.2.13</version>
          </dependency>
          <dependency>
              <groupId>org.projectlombok</groupId>
              <artifactId>lombok</artifactId>
              <optional>true</optional>
          </dependency>
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-test</artifactId>
              <scope>test</scope>
          </dependency>
          <dependency>
              <groupId>io.minio</groupId>
              <artifactId>minio</artifactId>
              <version>8.2.2</version>
          </dependency>
          <dependency>
              <groupId>org.apache.commons</groupId>
              <artifactId>commons-lang3</artifactId>
          </dependency>
      </dependencies>
  
      <build>
          <plugins>
              <plugin>
                  <groupId>org.springframework.boot</groupId>
                  <artifactId>spring-boot-maven-plugin</artifactId>
                  <configuration>
                      <excludes>
                          <exclude>
                              <groupId>org.projectlombok</groupId>
                              <artifactId>lombok</artifactId>
                          </exclude>
                      </excludes>
                  </configuration>
              </plugin>
          </plugins>
      </build>
  

• yml

  # Tomcat
  server:
    tomcat:
      uri-encoding: UTF-8
      max-threads: 1000
      min-spare-threads: 30
    port: 9006
  #  connection-timeout: 5000ms
    servlet:
      context-path: /api_demo
  
  spring:
    datasource:
      type: com.alibaba.druid.pool.DruidDataSource
      druid:
        driver-class-name: com.mysql.cj.jdbc.Driver
        url: jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
        username: root
        password: root
        initial-size: 10
        max-active: 100
        min-idle: 10
        max-wait: 60000
        pool-prepared-statements: true
        max-pool-prepared-statement-per-connection-size: 20
        time-between-eviction-runs-millis: 60000
        min-evictable-idle-time-millis: 300000
        #Oracle需要打开注释
        #validation-query: SELECT 1 FROM DUAL
        test-while-idle: true
        test-on-borrow: false
        test-on-return: false
        stat-view-servlet:
          enabled: true
          url-pattern: /druid/*
          #login-username: admin
          #login-password: admin
        filter:
          stat:
            log-slow-sql: true
            slow-sql-millis: 1000
            merge-sql: false
          wall:
            config:
              multi-statement-allow: true
    # 环境 dev|test|prod
    profiles:
      active: dev
    # jackson时间格式化
    jackson:
      time-zone: GMT+8
      date-format: yyyy-MM-dd HH:mm:ss
    servlet:
      multipart:
        max-file-size: 100MB
        max-request-size: 100MB
        enabled: true
    redis:
      open: false  # 是否开启redis缓存  true开启   false关闭
      database: 0
      host: localhost
      port: 6379
      #    password: 123456   # 密码（默认为空）
      timeout: 6000ms  # 连接超时时长（毫秒）
      jedis:
        pool:
          max-active: 1000  # 连接池最大连接数（使用负值表示没有限制）
          max-wait: -1ms      # 连接池最大阻塞等待时间（使用负值表示没有限制）
          max-idle: 10      # 连接池中的最大空闲连接
          min-idle: 5       # 连接池中的最小空闲连接
    mvc:
      throw-exception-if-no-handler-found: true
      pathmatch:
        matching-strategy: ANT_PATH_MATCHER
  #  resources:
  #    add-mappings: false
  
  
  #mybatis
  mybatis-plus:
    logging:
      level:
        #      org.springframework: warn
        org.apache.ibatis.logging: debug
    #      com.tmxk.municipal.**.dao: debug
    mapper-locations: classpath*:/mapper/**/*.xml
    #实体扫描，多个package用逗号或者分号分隔
    typeAliasesPackage: io.renren.modules.*.entity
    global-config:
      #数据库相关配置
      db-config:
        #主键类型  AUTO:"数据库ID自增", INPUT:"用户输入ID", ID_WORKER:"全局唯一ID (数字类型唯一ID)", UUID:"全局唯一ID UUID";
        #      id-type: ASSIGN_ID
        id-type: AUTO
        logic-delete-value: 0
        logic-not-delete-value: 1
      banner: false
    #原生配置
    configuration:
      map-underscore-to-camel-case: true
      cache-enabled: false
      call-setters-on-nulls: true
      jdbc-type-for-null: 'null'
      log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl
  
  
  renren:
    redis:
      open: false
    shiro:
      redis: false
    # APP模块，是通过jwt认证的，如果要使用APP模块，则需要修改【加密秘钥】
    jwt:
      # 加密秘钥
      secret: f4e2e52034348f86b67cde581c0f9eb5[www.renren.io]
      # token有效时长，7天，单位秒
      expire: 604800
      header: token
  
  

  2. table-tree

效果图

后端项目结构

2.1 后端准备

• 数据表创建

  DROP TABLE IF EXISTS `tb_unit`;
  CREATE TABLE `tb_unit`  (
    `id` int NOT NULL AUTO_INCREMENT COMMENT '主键',
    `unit` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_croatian_ci NULL DEFAULT NULL COMMENT '单位名称',
    `pid` int NULL DEFAULT NULL COMMENT '父id',
    PRIMARY KEY (`id`) USING BTREE
  ) ENGINE = InnoDB AUTO_INCREMENT = 9 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_croatian_ci COMMENT = '用户所属单位设置表' ROW_FORMAT = Dynamic;
  
  SET FOREIGN_KEY_CHECKS = 1;
  
  

• common模块

  • R【通用返回类】

    /**
     * 返回数据
     *
     * @author Mark sunlightcs@gmail.com
     */
    public class R extends HashMap<String, Object> {
    	private static final long serialVersionUID = 1L;
    
        public static String data = "data";
    
        public R() {
    		put("code", 0);
    		put("msg", "success");
    	}
    	
    	public static R error() {
    		return error(HttpStatus.SC_INTERNAL_SERVER_ERROR, "未知异常，请联系管理员");
    	}
    
    	public static R error(ErrorCode code) {
    		return error(code.getErrorCode(), code.getMsg());
    	}
    
    	public static R error(String msg) {
    		return error(HttpStatus.SC_INTERNAL_SERVER_ERROR, msg);
    	}
    	
    	public static R error(int code, String msg) {
    		R r = new R();
    		r.put("code", code);
    		r.put("msg", msg);
    		return r;
    	}
    
    	public static R ok(String msg) {
    		R r = new R();
    		r.put("msg", msg);
    		return r;
    	}
    	
    	public static R ok(Map<String, Object> map) {
    		R r = new R();
    		r.putAll(map);
    		return r;
    	}
    	
    	public static R ok() {
    		return new R();
    	}
    
    	public R put(String key, Object value) {
    		super.put(key, value);
    		return this;
    	}
    }
    
    

  • ErrorCode

    public enum ErrorCode {
        MANAGER_NOT_FOUND(412001, "主管未设置或不存在"),
        MANAGER_NOT_EQUAL(412002, "主管id不一致, 维修设施信息和维修工单的负责主管不一致"),
        INSTALLREPAIR_STATE_NOT_CORRECT(412003, "维修信息状态(status)错误,用户新上传的维修信息状态应为0(等待维修)"),
        INSTALLREPAIR_ISREPAIR_NOT_CORRECT(412004, "维修信息是否需要维修字段设置错误,允许的状态有0(不需要维修),1(需要维修),2(审核中)"),
        STATUS_NOT_FOUND(412005, "维修信息状态设置错误,允许的状态有0(等待维修),1(正在维修),2(维修完成)"),
        SMS_SEND_FAIL(412006, "短信发送错误, 请联系管理员"),
        SYSTEM_ERROR(412007, "服务器异常"),
        USER_NOT_FOUND(412008, "用户不存在"),
        DATA_ERROR(412009, "数据异常,服务器未接收到数据或传输数据为空"),
        NOT_CONTAIN_SPECIAL_CHAR(412010, "填写字符串信息不应该包含特殊字符"),
        PASSWORD_TO_SHORT(412011, "密码过短,不该小于6位"),
        REGISTER_ERROR(412012, "注册失败"),
        PASSWORD_NOT_EQUAL(412013, "两次密码不一致"),
        USERNAME_DUPLICATE(412014, "用户名已存在"),
        NOT_LOGIN(412015, "未登录"),
        INVALID_SESSION_KEY(412016, "sessionKey异常,请重试"),
        DECRYPTION_ERROR(412017, "用户信息解密异常,请重试"),
        NOT_MANAGER(412018, "您不是主管,请通过普通用户方式登录或者联系管理员升级为主管"),
        SESSIONID_INVALID(412019, "sessionId有误,服务器中不存在"),
        NOT_NULL_MARK(412020, "mark为空"),
        CODE_ERROR(412021, "code错误"),
        APPEALS_LACK_PROPERTY(412022, "appeals缺少property作为区分三表的标志"),
        APPEALS_WRONG_PROPERTY(412023, "appeals的property错误"),
        LOGIN_TIMEOUT(412024, "登录超时"),
        NO_WORKER_REPAIR(412025, "本条记录没有工人负责,请先设置负责工人"),
        WORKER_HAD_FOUND(412026, "本条记录已有负责的工人,请勿重复设置"),
        WORKER_NOT_EXIST(412027, "工人不存在"),
        VISIT_TOO_FREQUENCY(412028, "您的访问过于频繁,被系统认定为机器人,请稍后访问"),
        THINGS_DATA_LENGTH_INVALID(412029, "微信订阅消息的thing.DATA类型数据长度不能大于20"),
        REAPEAT_ORDER(412030, "重复下单"),
        REAPEAT_RECE_ORDER(412031, "重复接单"),
        REAPEAT_UPLOAD(412032, "重复提交");
    
        /**
         * 错误码
         */
        private int errorCode;
    
        /**
         * 错误信息
         */
        private String msg;
    
        ErrorCode() {}
    
        ErrorCode(int errorCode, String msg) {
            this.errorCode = errorCode;
            this.msg = msg;
        }
    
        public int getErrorCode() {
            return errorCode;
        }
    
        public String getMsg() {
            return msg;
        }
    }
    

• entity

  package com.fgbg.demo.entity;
  
  import com.baomidou.mybatisplus.annotation.IdType;
  import com.baomidou.mybatisplus.annotation.TableField;
  import com.baomidou.mybatisplus.annotation.TableId;
  import com.baomidou.mybatisplus.annotation.TableName;
  import java.io.Serializable;
  import java.util.List;
  
  import lombok.Data;
  
  /**
   * 用户所属单位设置表
   * @TableName tb_unit
   */
  @TableName(value ="tb_unit")
  @Data
  public class TbUnit implements Serializable {
      /**
       * 主键
       */
      @TableId(type = IdType.AUTO)
      private Integer id;
  
      /**
       * 单位名称
       */
      private String unit;
  
      /**
       * 父id
       */
      private Integer pid;
  
      @TableField(exist = false)
      private List<TbUnit> children;
  
      @TableField(exist = false)
      private static final long serialVersionUID = 1L;
  }
  

• controller

      @RequestMapping("/list")
      public R list() {
          List<TbUnit> list = unitService.listAll();
          /*----
          {
              code: 0,
              msg: 'xxx',
              data: [A, B, C, D, E, F, G, H]
          }
          ---*/
          return R.ok().put("data", list);
      }
  

• service【核心逻辑】

      /**
       * 查询所有的unit数据, 并返回树形结构
       *
       * @return
       */
      @Override
      public List<TbUnit> listAll() {
          // 查询所有数据
          List<TbUnit> list = this.list();
          // 建立map映射(id->index)
          HashMap<Integer, Integer> map = new HashMap<>();
          for (int index = 0; index < list.size(); index++) {
              Integer id = list.get(index).getId();
              map.put(id, index);
          }
          // ...
          for (int i = 0; i < list.size(); i++) {
              TbUnit node = list.get(i);
              Integer pid = node.getPid();
              // 有父亲
              if (pid != null) {
                  // 找到pid的父亲, 并把当前节点(node)添加到父亲节点的children里面
                  Integer indexParent = map.get(pid);
                  // 获取父亲节点
                  TbUnit parent = list.get(indexParent);
                  if (parent.getChildren() == null) {
                      parent.setChildren(new ArrayList<>());
                  }
                  // 向父亲节点的children字段添加当前node
                  parent.getChildren().add(node);
              }
          }
          // 过滤出一级节点
          List<TbUnit> ans = list.stream().filter(e -> e.getPid() == null).collect(Collectors.toList());
          return ans;
      }
  

• 返回的json数据

  {
    "msg": "success",
    "code": 0,
    "data": [
      {
        "id": 9,
        "unit": "浙江省",
        "pid": null,
        "children": [
          {
            "id": 10,
            "unit": "杭州市",
            "pid": 9,
            "children": [
              {
                "id": 11,
                "unit": "滨江区",
                "pid": 10,
                "children": null
              },
              {
                "id": 12,
                "unit": "余杭区",
                "pid": 10,
                "children": null
              }
            ]
          },
          {
            "id": 13,
            "unit": "宁波市",
            "pid": 9,
            "children": null
          },
          {
            "id": 14,
            "unit": "温州市",
            "pid": 9,
            "children": null
          }
        ]
      }
    ]
  }
  

  2.2 前端准备

• /src/api/tree.ts

  import { http } from "@/utils/http";
  import { R, baseUrlApi } from "./utils";
  
  export class UnitEntity {
    id: Number;
    unit: String;
    pid: Number;
    children: Array<UnitEntity>;
  }
  
  /** 获取全部的unit数据 */
  export const getData = () => {
    return http.request<R<Array<UnitEntity>>>("get", baseUrlApi("unit/list"));
  };
  

• /src/api/utils.ts

  export const baseUrlApi = (url: string) => `/api_demo/${url}`;
  
  /** 后端返回通用数据类型 */
  export type R<T> = {
    code: Number;
    msg: String;
    data: T;
  };
  
  /** 同步休眠函数, 参数为毫秒 */
  export const sleep = (ms: number): Promise<void> => {
    return new Promise(resolve => setTimeout(resolve, ms));
  };
  
  /** 分页数据类型 */
  export type PageUtils<T> = {
    /** 总记录数 */
    totalCount: number;
    /** 每页记录数 */
    pageSize: number;
    /** 总页数 */
    totalPage: number;
    /** 当前页数 */
    currPage: number;
    /** 列表数据 */
    list: Array<T>;
  };
  
  export const getStoreUser = () => {
    const res = sessionStorage.getItem("user-info");
    // const res = sessionStorage.getItem("user-info");
    console.log(res);
    return JSON.parse(res);
  };
  

• /src/views/welecome/index.vue

 <script setup lang="ts">
 import { ref, onMounted } from "vue";
 import { UnitEntity, getData } from "@/api/tree.ts";
 defineOptions({
   name: "Welcome"
 });
 
 const tableData = ref<Array<UnitEntity>>();
 
 onMounted(() => {
   getData().then(res => {
     console.log(res);
     if (res.code === 0) {
       tableData.value = res.data;
     }
   });
 });
 </script>
 
 <template>
   <el-table
     :data="tableData"
     style="width: 100%; margin-bottom: 20px"
     row-key="id"
     border
     default-expand-all
   >
     <el-table-column prop="id" label="序号" sortable />
     <el-table-column prop="unit" label="单位" sortable />
     <el-table-column
       fixed="right"
       header-align="center"
       align="center"
       width="150"
       label="操作"
     >
       <template v-slot="scope">
         <el-button
           type="text"
           size="small"
           @click="addOrUpdateHandle(scope.row.id)"
           >修改</el-button
         >
       </template>
     </el-table-column>
   </el-table>
 </template>