SpringBoot3快速整合MyBatisPlus的示例代码_Java

一、前言

mybatis 最佳搭档，只做增强不做改变，为简化开发、提高效率而生。这个发展到目前阶段已经很成熟了，社区也比较活跃，可以放心使用。官网地址：https://baomidou.com

二、快速开始

引入依赖

这里我引入了核心 starter 依赖，以及官方提供的代码生成器依赖，如果你不用代码生成器可以不引用

<properties>
  <mybatis-plus.version>3.5.7</mybatis-plus.version> <!-- mybatis增强 orm 框架 -->
</properties>

<dependencies>
  <!--   mybatis-plus 相关依赖   -->
  <dependency>
      <groupid>com.baomidou</groupid>
      <artifactid>mybatis-plus-spring-boot3-starter</artifactid>
      <version>${mybatis-plus.version}</version>
  </dependency>
  <!-- 代码生成器 -->
  <dependency>
      <groupid>com.baomidou</groupid>
      <artifactid>mybatis-plus-generator</artifactid>
      <version>${mybatis-plus.version}</version>
  </dependency>
  <!--  mysql 依赖 版本由继承的 spring-boot-starter-parent 控制，也可以自己指定  -->
  <dependency>
      <groupid>com.mysql</groupid>
      <artifactid>mysql-connector-j</artifactid>
  </dependency>
</dependencies>

配置数据库连接

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.driver
    url: jdbc:mysql://localhost:3306/itshare-dev?autoreconnect=true&useunicode=true&characterencoding=utf8&usessl=false&rewritebatchedstatements=true
    username: root
    password: root

这样整合就完成了，接下来就可以编写我们的业务代码了。

三、业务开发

使用 mybatis-plus 的基本开发流程一般是这样的，他和一些全自动的 orm 框架还是有点区别的，比如 springdatajpa 或者 hibernate 并不能根据实体对象自动执行 ddl 创建表结构（现在可以通过插件做到，这里我们不深究），一般都是通过先有表，再有实体对象

通常是：

创建数据表 -> 代码生成器生成基础类 -> 在这个基础上开发业务代码

当然你可以在代码生成器阶段尽可能的抽象出相似的地方，甚至可以生成简单的 crud 代码，市面上有很多案例可供参考，若依，eladmin 等等。这里我只介绍基础的 entity、mapper、service 生成。

3.1 创建数据表

这里我就不列举了，根据你自己业务来。

3.2 代码生成器

引入依赖

<!-- 代码生成器 -->
<dependency>
  <groupid>com.baomidou</groupid>
  <artifactid>mybatis-plus-generator</artifactid>
  <version>${mybatis-plus.version}</version>
</dependency>
<!-- 模板引擎 -->
<dependency>
  <groupid>org.freemarker</groupid>
  <artifactid>freemarker</artifactid>
</dependency>

代码生成工具类

public class codegenerator {


    private static final string db_url = "jdbc:mysql://localhost:3306/itshare-dev?useunicode=true&characterencoding=utf-8&usessl=false&servertimezone=asia/shanghai&tinyint1isbit=false";
    private static final string username = "root";
    private static final string password = "root";

    public static void main(string[] args) {

        atomicreference<string> loadmodulepackagename = new atomicreference<>("");
        // 获取当前路径
        string path = system.getproperty("user.dir");
        // &tinyint1isbit=false
        fastautogenerator.create(db_url, username, password)
        .globalconfig((scanner, builder) -> {
            // 设置作者
            builder.author("曹申阳")
            .disableopendir()
            .enablespringdoc() // 如果想用swagger，生成 springdoc 规范注解 把这个放开
            // 指定输出目录
            .outputdir(path + "\\src\\test\\java");
        })
        .datasourceconfig(builder ->
                          builder.typeconverthandler((globalconfig, typeregistry, metainfo) -> {
                              if (jdbctype.tinyint == metainfo.getjdbctype()) {
                                  return dbcolumntype.integer;
                              }
                              return typeregistry.getcolumntype(metainfo);
                          })
                         )
        .packageconfig((scanner, builder) -> {
            loadmodulepackagename.set(scanner.apply("请输入当前父包模块名称："));
            builder.parent("com.yang.itshare") // 设置父包名
            .modulename(loadmodulepackagename.get()) // 设置父包模块名
            .service("service")
            .serviceimpl("service.impl")
            .mapper("mapper")
            .controller("controller")
            .entity("entity")
            // 设置mapperxml生成路径
            .pathinfo(collections.singletonmap(outputfile.xml, path + "\\src\\main\\resources\\mapper\\" + loadmodulepackagename.get()));
        })
        .strategyconfig((scanner, builder) -> {
            // 设置需要生成的表名
            builder.addinclude(gettables(scanner.apply("请输入表名，多个英文逗号分隔？所有输入 all")))
            .addtableprefix("itshare_") // 设置过滤表前缀
            .entitybuilder() // 设置 entity 生成规则
            .addtablefills(new column("create_time", fieldfill.insert))
            .addtablefills(new column("update_time", fieldfill.insert_update))
            .logicdeletecolumnname("is_deleted")
            .idtype(idtype.auto)
            .enablelombok()// lombok 注解
            .controllerbuilder() // 设置 controller 生成规则
            .enablereststyle() // 开启生成@restcontroller 控制器
            .build();
        }
                       )
        .templateengine(new freemarkertemplateengine()) // 使用freemarker引擎模板，默认的是velocity引擎模板
        .execute();
    }

    /**
     * 处理 all 情况
     */
    protected static list<string> gettables(string tables) {
        return "all".equals(tables) ? collections.emptylist() : arrays.aslist(tables.split(","));
    }

}

亲测可用，注释也很清楚，想要自己配置可以参考配置文件 https://baomidou.com/reference/new-code-generator-configuration/

运行测试一下：我习惯将生成的放在 test 下，然后再复制到项目下，方便调试，如果你足够自信，可以指定到想要的地方，一步到位。

这个时候还差最后一步，开启 mapper 扫描，就可以正常使用了

@mapperscan("com.yang.itshare.*.mapper")

你可以加在启动类上，或者其它可以被扫描到的类上，我习惯加载 mybatis 的插件配置类上，后面会介绍。

四、常用插件功能

4.1 逻辑删除

配置全局逻辑删除属性

mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: is_deleted # 全局逻辑删除字段名
      logic-delete-value: 1 # 逻辑已删除值
      logic-not-delete-value: 0 # 逻辑未删除值
  # 打印 sql 日志
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.stdoutimpl
  # 配置mapper的扫描，找到所有的mapper.xml映射文件 如果和默认路径一样可以不配置
  mapper-locations: classpath*:/mapper/**/*.xml

这里我把常用的也放出来了，日志打印，以及 xml 扫描，我一般就放默认地址，这里不加也可以，防止大家想要修改位置，可以在这里配置路径。

加逻辑删除注解

如果你使用的是我上面的代码生成器代码，会自动添加注解

否则，需要自己完成这一步。

之后在调用 mybatis-plus 封装的查询以及删除操作时，会默认加上这个删除的判断，比如查询会过滤掉以删除的，删除会变成修改这个删除标记的状态值，并不会真正的删除。注意，如果是使用自己编写的 xml 将不会生效。

4.2 自动填充字段

实现 metaobjecthandler

@slf4j
@component
public class mymetaobjecthandler implements metaobjecthandler {

@override
public void insertfill(metaobject metaobject) {
    log.info("start insert fill ....");
    this.strictinsertfill(metaobject, "createtime", localdatetime.class, localdatetime.now());
    this.strictupdatefill(metaobject, "updatetime", localdatetime.class, localdatetime.now());
}

@override
public void updatefill(metaobject metaobject) {
    log.info("start update fill ....");
    this.strictupdatefill(metaobject, "updatetime", localdatetime.class, localdatetime.now());
}

实体类上添加注解

如果你使用我上面的代码生成器，会自动添加，否则要自己指定

4.3 分页插件和防止全表更新与删除插件

创建配置类

@configuration
@mapperscan("com.yang.itshare.*.mapper")
public class mybatisplusconfig {

    @bean
    public mybatisplusinterceptor mybatisplusinterceptor() {
        mybatisplusinterceptor interceptor = new mybatisplusinterceptor();
        interceptor.addinnerinterceptor(new blockattackinnerinterceptor()); // 防全表更新与删除插件
        paginationinnerinterceptor paginationinnerinterceptor = new paginationinnerinterceptor(dbtype.mysql);
        paginationinnerinterceptor.setmaxlimit(1000l);
        interceptor.addinnerinterceptor(paginationinnerinterceptor); // 如果配置多个插件, 切记分页最后添加
        return interceptor;
    }
}

我一般会在这里加上 mapper 的扫描，当然你也可以加在启动类上

还有很多可用插件，大家根据需要引入即可 https://baomidou.com/plugins/