全栈开发之后端脚手架：SpringBoot集成MybatisPlus代码生成，分页，雪花算法，统一响应，异常拦截，Swagger3接口文档

当需要快速实现一个想法时，如果采用 Java 技术栈，一般都是选择 SpringBoot 技术栈，虽然 SpringBoot 解决了传统 Spring 及 MVC 配置等方面的问题，且其生态体系也非常强大，但是在实际使用时仍然需要集成最起码的数据库、响应封装、异常拦截、代码生成器、接口文档等基础组件，这时一般有两种手段：

使用开源的各类后台管理系统，这类系统一般模块完善，功能强大；然而很多无关紧要的模块又会带来一些干扰；使用自建的简化版，集成最常用的模块即可，一方面便于掌控，同时在“重复造轮子”的过程中也熟悉下这些主流技术是如何整合在一起的。

这里，就从零开始搭建后端脚手架，以搭积木的方式将开源组件组装起来。后续的玩具项目都基于这个脚手架进行开发。

参考官方的代码仓库以及文档：https://mp.baomidou.com/guide/generator.html

简单修改路径信息后，直接执行 MysqlGenerator 类的 main 方法。分别键入模块表以及表名即可生成 Entity , Mapper , Service , Controller 等对应的文件。

MybatisPlus (3.3.1)的主键策略默认是雪花算法，如果不显式设置主键的话， MybatisPlus 通过代码自动通过雪花算法算出一个值，插入的时候就会将其作为id插入。

雪花算法（ SnowFlake ）是一个 Long 类型的 Java 长整型数字，一般对应 MySQL 中的类型为 BIGINT(20) ；具有趋势单调递增，且全局唯一的特点。

MybatisPlusConfig.java

@Configuration
public class MybatisPlusConfig {
    @Bean
    public PaginationInterceptor paginationInterceptor() {
        return new PaginationInterceptor().setCountSqlParser(new JsqlParserCountOptimize(true));
    }
}

PageUtils.java

@Data
public class PageUtils {
    //总记录数
    private long total;

    //每页记录数
    private long size;

    //总页数
    private long pages;

    //当前页数
    private long current;

    //列表数据
    private List records;

    //灵活添加
    private Map data;

    
    public PageUtils(List records, long total, long size, long current) {
        this.records = records;
        this.total = total;
        this.size = size;
        this.current = current;
        this.pages = (long)Math.ceil((double)total/size);
    }

    
    public PageUtils(List records, long total, long size, long current, Map data) {
        this.records = records;
        this.total = total;
        this.size = size;
        this.current = current;
        this.data = data;
        this.pages = (long)Math.ceil((double)total/size);
    }

    
    public PageUtils(Page page) {
        this.records = page.getRecords();
        this.total = (long)page.getTotal();
        this.size = page.getSize();
        this.current = page.getCurrent();
        this.pages = (long)page.getPages();
    }
}

BookController.java

// 分页查询：使用自定义PageUtils
@GetMapping("list")
public Result list(@RequestParam(defaultValue = "0") Integer page, @RequestParam(defaultValue = "10") Integer size, @RequestParam Map params) {
    PageUtils list = bookService.findList(new Page<>(page, size), params);
    return Result.success(list);
}

// 分页查询：使用MyBatisPlus的page方法
@GetMapping("page")
public Result> page(@RequestParam(defaultValue = "0") Integer page, @RequestParam(defaultValue = "10") Integer size, @RequestParam Map params) {
    QueryWrapper queryWrapper = new QueryWrapper<>();
    queryWrapper.likeRight("read_date", params.get("readDate"));
    IPage list = bookService.page(new Page<>(page, size),queryWrapper);
    return Result.success(list);
}

通过 RestControllerAdvice 注解，实现对请求的拦截，统一封装结果为 Result 。

@RestControllerAdvice
public class ResultAdvice implements ResponseBodyAdvice