少写重复 CRUD:用大白话搞懂 MyBatis-Plus

> Spring 系列 · 第 9 篇(持久层进阶)

>适用读者 :会写 Java 和简单 SQL,用过 Spring Boot,第一次接触 MyBatis-Plus。最好先读过 MyBatis 持久层实战(./Spring-MyBatis持久层实战指南.md),不读也能跟着本文把示例跑起来。

>技术环境 :Java 17(本文 `mvn test` 实际跑在 Java 21)· Spring Boot 3.4.1 · MyBatis-Plus 3.5.18 · 示例面向 MySQL 8

>示例项目:mybatis-plus-user-demo(./mybatis-plus-user-demo/)


提示:写完文章后,目录可以自动生成,如何生成可参考右边的帮助文档

文章目录

[- 前言:第三张表开始,你会烦(#前言第三张表开始你会烦)


前言:第三张表开始,你会烦

假设系统里有一张用户表。新增、按编号查询、修改、删除,四条 SQL,外加一个 Mapper 接口。第二天来一张部门表,又是四条。第三天来一张角色表,你开始复制粘贴,只改表名。

这些 SQL 长得几乎一样,错却容易出在「复制完忘了改某一列」。MyBatis-Plus 要解决的就是这种单表、形状固定的重复劳动。它不负责替你设计表,也不负责把三张表 JOIN 出一份报表。

> 一句话:MyBatis 是「你写 SQL,它帮你执行并映射成对象」;MyBatis-Plus 是在这之上,把「按主键增删改查」这种每张表都差不多的 SQL,提前写好了。

读完后你应该能做到:

  1. 说清楚 MyBatis、MyBatis-Plus 和数据库各管哪一段;

  2. 知道它省掉的是哪一类代码,以及它不该承包的查询;

  3. 独立做出用户模块的增删改查、条件查询和分页;

  4. 认出逻辑删除、空值更新、手写 SQL 这三处最容易想错的地方。

验证范围先说清楚。 示例项目的 `mvn test` 用 H2 的 MySQL 兼容模式跑过,下面引用的 SQL 来自这次测试的日志。项目里的 MySQL 地址、账号和 `sql/schema.sql` 是给本机 MySQL 8 准备的**,我没有连上真实 MySQL 再跑一遍**。接口代码没有用 HTTP 客户端打过,文中的 JSON 是按 Service 测试结果整理的。


提示:以下是本篇文章正文内容,下面案例可供参考

一、从重复劳动开始:为什么需要 MyBatis-Plus

1.1 同一条【按编号查询】,两种写法差在哪

用MyBatis 做【按id查用户】,你至少要准备接口和SQL:

java 复制代码
public interface SysUserMapper {
    SysUser selectById(Long id);
}
XML 复制代码
<select id="selectById" resultType="com.example.userdemo.entity.SysUser">
    SELECT id, name, age, email, deleted
    FROM sys_user
    WHERE id = #{id}
</select>

插入、更新、删除这组固定还要再写一份。表字段一改,XML里的列清单还要改。

MyBatis-Plus把这组固定动作做进了Base Mapper。你的接口变成了:

java 复制代码
@Mapper
public interface SysUserMapper extends BaseMapper<SysUser> {
}

调用 `sysUserMapper.selectById(1L)` 时,框架按实体上的注解拼出 SQL,再交给 MyBatis 执行。测试日志里按主键查询的语句是:

SELECT id,name,age,email,deleted FROM sys_user WHERE id=? AND deleted=0

`?` 是预编译参数,不是把数字拼进 SQL 字符串。后面的 `deleted=0` 不是我们在 Java 里手写的,是逻辑删除加上的,第六节再拆。

你可能会问:那我是不是不用学 MyBatis 了?

不用学 XML 的语法细节,也要知道这句话最终还是 MyBatis 的 `SqlSession` 在执行。日志里的 `Preparing` / `Parameters` 就是 MyBatis 打出来的。Plus 没换数据库驱动,也没换事务管理器。

1.2 它适合省什么,不适合省什么

适合交给它的,是【一张表、条件说得清】的操作;按主键取一行、按字段过滤、排序、分页、按主键改几个非空字段。

不适合一开始就交给它的,是多表关联、分组统计、数据库方言函数、以及【这个字段就算是null 也必须写进UPDATE】这类要精确控制SET子句的语句。这些在第七节用手写SQL接回来。

1.3 不要把它和JPA 画等号

生活里可以把它想成连锁店的标准点菜单:

红烧肉、米饭、例汤,每家店都有,总部印好了,特色菜仍然有这家店由这家店自己写在黑板上。

类比的边界:点菜单不会在你改了菜品数量之后又,自己偷偷再下一单。JPA/Hibernate会跟踪实体状态,事务提交时可能把你改过的字段自动UPDATE回去。MyBatis-Plus不盯着对象。你调用`save`、`updateById`、`removeById`,它才发 SQL;方法返回之后,内存里的对象不会再和数据库保持同步。

所以它是MyBatis的增强工具,不是【另一个全自动ORM】。

二、搭好一个能运行的示例

2.1 版本锁死,不写「最新版」

3.5.9 之后有两处和旧教程不一样,本文按 3.5.18 的 jar 为准:

  1. 分页插件依赖的 SQL 解析器要另外 引入 `mybatis-plus-jsqlparser`,版本与 starter 相同。

  2. `IService` / `ServiceImpl` 的包名是 `com.baomidou.mybatisplus.spring.service`。我在 `mybatis-plus-extension-3.5.18.jar` 里没有找到旧的 `extension.service.IService`。很多 2024 年以前的文章仍在教旧包名,照抄会编译失败。

Spring Boot 3 用 `mybatis-plus-spring-boot3-starter`。不要再引入 `mybatis-spring-boot-starter`,两套自动配置叠在一起容易打架。官方安装说明也写了这一点。

2.2 Maven 依赖

`mysql-connector-j` 的版本交给 Spring Boot 3.4.1 的 parent 管理,pom 里不手写。

XML 复制代码
<properties>
    <java.version>17</java.version>
    <mybatis-plus.version>3.5.18</mybatis-plus.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <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-jsqlparser</artifactId>
        <version>${mybatis-plus.version}</version>
    </dependency>
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

2.3 贯穿全文的表

文件在 `mybatis-plus-user-demo/sql/schema.sql`:

sql 复制代码
CREATE DATABASE IF NOT EXISTS user_demo DEFAULT CHARACTER SET utf8mb4;
USE user_demo;

CREATE TABLE sys_user (
    id      BIGINT       NOT NULL AUTO_INCREMENT COMMENT '主键',
    name    VARCHAR(50)  NOT NULL COMMENT '姓名',
    age     INT          NULL COMMENT '年龄',
    email   VARCHAR(100) NULL COMMENT '邮箱',
    deleted INT          NOT NULL DEFAULT 0 COMMENT '逻辑删除:0 未删除,1 已删除',
    PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

`deleted` 用 `INT`,不用 `TINYINT(1)`。MySQL 驱动默认可能把 `TINYINT(1)` 当成布尔值,和实体里的 `Integer` 对不上。这是驱动的映射规则,不是 Plus 的注解能改的。

2.4 配置和目录

java 复制代码
spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/user_demo?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver

mybatis-plus:
  configuration:
    map-underscore-to-camel-case: true
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  global-config:
    db-config:
      id-type: auto
      logic-delete-field: deleted
      logic-delete-value: 1
      logic-not-delete-value: 0

mybatis-plus-user-demo

├── pom.xml

├── sql/schema.sql

└── src/main/java/com/example/userdemo

├── UserDemoApplication.java

├── config/MybatisPlusConfig.java

├── entity/SysUser.java

├── mapper/SysUserMapper.java

├── service/SysUserService.java

├── service/impl/SysUserServiceImpl.java

├── controller/SysUserController.java

└── dto/ UserSaveRequest、UserQuery、PageResult

启动类只要 `@SpringBootApplication`。Mapper 接口上的 `@Mapper` 会被 starter 扫到。Mapper 如果放在启动类的包外面,再加 `@MapperScan`。

三、看懂实体类和数据库表如何对应

3.1 四个注解各自回答一个问题

实体回答的是:这行数据在 Java 里长什么样,哪一列是主键,哪一列表示「已经删了」。

java 复制代码
@TableName("sys_user")
public class SysUser {

    @TableId(type = IdType.AUTO)
    private Long id;

    private String name;
    private Integer age;
    private String email;

    @TableLogic(value = "0", delval = "1")
    private Integer deleted;

    // getName / setName 等访问器见示例项目。
    // Lambda 表达式 SysUser::getName 依赖这些方法,不是依赖字段名本身。
}

主键策略先记两个就够。`AUTO` 是数据库自己编号,测试里三条数据的 id 是 1、2、3。`ASSIGN_ID` 是框架用雪花算法在 Java 里先算好一个长整型再插入。启动日志里出现过 `datacenterId` / `workerId`,那是雪花算法的初始化信息;本实体没有用它,插入语句里没有 id 列。

全局配置 `id-type: auto` 和字段上的 `@TableId(type = IdType.AUTO)` 说的是同一件事。字段注解更显眼,全局配置用来兜住那些没标注解的实体。

3.2 数据库里存了什么,框架替你做了什么

建表语句决定列、类型、默认值、自增。这些在 Java 进程没起来时就已经存在。

框架做的是另一半:

  • 启动时根据实体注册「insert / selectById / updateById / deleteById」这些语句;

  • 调用时把对象属性放进 `?`;

  • 把结果集填回对象;

  • 发现 `@TableLogic` 之后,查询和更新自动带上「还没删除」,删除改成改标记。

你可能会问:`save` 返回之后,`deleted` 为什么还是 null?**

测试里就是这样。插入语句是:

INSERT INTO sys_user ( name, age, email ) VALUES ( ?, ?, ? )

`deleted` 为 null,默认的 `NOT_NULL` 策略(3.5.18 的 `DbConfig` 构造方法把 insert、update、where 三个策略都设成了 `FieldStrategy.NOT_NULL`)会把它从列清单里拿掉,于是用上表的 `DEFAULT 0`。`save` 只把自增主键填回来,不会再发一条 SELECT 把默认值读回来。想看到 `deleted = 0`,要再 `getById`。

这就是「框架不是数据库」:默认值发生在库里,Java 对象不会自动刷新。

3.3 这些类怎么串起来

`BaseMapper<SysUser>` 里的 `T` 就是这张表对应的实体。换一张表,就换一个实体、再写一个 `extends BaseMapper<那张表的实体>`。通用方法跟着 `T` 走,不用复制。

`countActiveByAgeRange` 是我们自己加的方法,不在 `BaseMapper` 里。框架不会为它发明逻辑删除条件,SQL 全文要自己写。这是第七节的例子。

四、用少量代码完成基础 CRUD

4.1 一次按主键查询,中间经过谁

生活类比:你对前台说【查1号会员】。前台(Service)核对这个人还在不在;柜员(Mapper代理)拿出标准表格;表格生成器(Plus)把【1号】和【未注销】印进单据;邮局(MyBatis)寄给数据库;数据库回一封信,邮局拆开放进`SysUser`。

类比的边界:前台不会改单据上的SQL。SQL的形状在启动时就已经注册好了,这次调用只填参数。

零行时方法返回 `null`,不抛「找不到」的异常。示例里的 Controller 把 `null` 转成了「用户不存在」。这是我们写的业务反应,不是框架的默认行为。

4.2 新增、修改、删除各发什么 SQL

Service 里和数据库相关的四次调用是:

java 复制代码
save(user);          // INSERT,跳过值为 null 的字段
getById(id);         // SELECT ... WHERE id=? AND deleted=0
updateById(patch);   // UPDATE,SET 里只有非 null 字段
removeById(id);      // 因为有 @TableLogic,实际是 UPDATE deleted=1

测试里把「林夏」改名为「林夏一」,年龄和邮箱传的是 null。日志只有:

UPDATE sys_user SET name=? WHERE id=? AND deleted=0

随后再查,年龄仍是 28,邮箱仍在。null 的意思是「这次别碰这列」,不是「把这列写成 NULL」。 想把邮箱清空,不能靠 `setEmail(null)` 再 `updateById`。那要写 `UpdateWrapper`,显式 `set` 成 null,并确认字段策略允许。本文的示例没有做「清空字段」。

删除的日志是:

UPDATE sys_user SET deleted=1 WHERE id=? AND deleted=0

然后再 `getById`,结果集行数是 0。用 `JdbcTemplate` 绕过框架去查同一行,`deleted` 仍是 1。行还在。

4.3 `IService` 是一层便利,不是必经之路

3.5.9 的变更说明里写过:通用能力抽到了 Repository,不再建议用 IService 把业务层和数据操作搅在一起。3.5.18 里这个接口还在,位置挪到了 `com.baomidou.mybatisplus.spring.service.IService`,它继承 `IRepository`。`ServiceImpl` 继承 `CrudRepository`,所以 `save`、`getById`、`page` 这些方法还在。

示例仍然用了它,因为你在现有项目里最常见到的就是这层。它做的事可以概括成:帮你注入 `BaseMapper`,并提供一批和 Mapper 同义的方法(`save` 对应 `insert`,`removeById` 对应 `deleteById`)。

Controller 只调 `SysUserService`。下面这些决定放在 `SysUserServiceImpl`,没有放进 Mapper:

  • 姓名不能为空;

  • 空白邮箱当成「没填」,不要写成空字符串;

  • 页码小于 1 时按第 1 页,每页条数限制在 1 到 100;

  • 条件是否拼进 WHERE,看参数有没有值。

Mapper 保持「怎么访问这张表」。业务规则换一张表就不成立,所以留在 Service。只做单表 CRUD、没有这些规则时,Controller 直接注入 Mapper 也能工作。多这一层是为了放规则,不是框架强迫的。

请求体用 `UserSaveRequest`,不直接收 `SysUser`。否则调用方可以在 JSON 里带上 `deleted`,虽然更新策略不一定会把它写进去,但没必要把这个字段暴露成入参。

五、把查询条件写清楚

5.1 字符串列名,和 Lambda 列名

两种写法都能描述「年龄大于等于、按 id 倒序」:

java 复制代码
QueryWrapper<SysUser> byName = new QueryWrapper<SysUser>()
        .like("name", "林")
        .ge("age", 20)
        .orderByDesc("id");
java 复制代码
LambdaQueryWrapper<SysUser> byMethod = new LambdaQueryWrapper<SysUser>()
        .like(SysUser::getName, "林")
        .ge(SysUser::getAge, 20)
        .orderByDesc(SysUser::getId);

示例项目走的是第二种。第一种能工作,但 `"name"` 只是字符串。你把属性改成 `username` 并改了列名,编译器不会提醒这行字符串。`SysUser::getName` 在改名时会编译失败,IDE 的「重命名」也能跟上。

Lambda 能做到这件事,是因为接口方法在字节码里留着名字 `getName`,框架去掉 `get`、再按驼峰转下划线得到列名。它不是在运行时扫描数据库表结构。列名和这个推导结果不一致时,仍然要 `@TableField`。

类比:字符串列名像在便签上写「第三排柜子」;方法引用像贴着柜子的正式标签,柜子改名时便签不会自己变。边界:便签写对了一样能找到柜子。Lambda 不是更安全的 SQL,只是列名和 Java 方法绑在一起,重构时更不容易留一处旧名字。

5.2 参数为空时,不要把条件加上

`like`、`eq`、`ge`、`le` 都有一个带布尔值的重载:第一个参数为 false,这个条件就不会出现在 SQL 里。

java 复制代码
LambdaQueryWrapper<SysUser> wrapper = new LambdaQueryWrapper<>();
wrapper.like(StringUtils.hasText(query.getName()), SysUser::getName, query.getName())
        .eq(StringUtils.hasText(query.getEmail()), SysUser::getEmail, query.getEmail())
        .ge(query.getMinAge() != null, SysUser::getAge, query.getMinAge())
        .le(query.getMaxAge() != null, SysUser::getAge, query.getMaxAge())
        .orderByDesc(SysUser::getId);

测试只传了年龄 20 到 30,日志里的条件就是年龄,没有姓名:

SELECT COUNT(*) AS total FROM sys_user WHERE deleted = 0 AND (age >= ? AND age <= ?)

SELECT id,name,age,email,deleted FROM sys_user WHERE deleted=0 AND (age >= ? AND age <= ?) ORDER BY id DESC LIMIT ?

参数是 `20`、`30`,以及 `LIMIT` 后面的 `2`。姓名若也传了「林」,才会多一个 `LIKE`。空字符串用 `StringUtils.hasText` 挡掉,避免拼出 `name LIKE '%'` 这种把全表扫进来的条件。

常见误区: 自己先 `if` 再 `wrapper.like(...)`,和这个布尔重载是一回事。容易错的是写成 `like(name != null, ...)`,空字符串仍然会进去。

六、分页与逻辑删除如何工作

6.1 分页插件要自己注册

starter 不会自动分页。不注册 `PaginationInnerInterceptor` 时,你传入的 `Page` 不会变成 `LIMIT`,有机会把整表装进内存。3.5.9 起这个插件还依赖单独的 `mybatis-plus-jsqlparser`,只加 starter 会在真正分页时缺类。

java 复制代码
@Configuration
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new BlockAttackInnerInterceptor());
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

官方分页说明要求:多个内部插件时,分页放在最后。`BlockAttackInnerInterceptor` 用来拦住没有 WHERE 的更新和删除,也是这里显式 new 出来的,不是默认开启。

查询代码:

java 复制代码
Page<SysUser> page = page(new Page<>(current, size), wrapper);

`current` 是第几页,从 1 开始。`size` 是每页条数。返回对象上:

当时库里有三个人:林夏 28 岁、周宁 35 岁、陈舟 22 岁。年龄 20 到 30 滤掉周宁,所以总数是 2。按 id 倒序,本页先是陈舟,再是已改名的林夏一。整理成接口会返回的 JSON:

java 复制代码
{
  "total": 2,
  "current": 1,
  "size": 2,
  "pages": 1,
  "records": [
    {"id": 3, "name": "陈舟", "age": 22, "email": null, "deleted": 0},
    {"id": 1, "name": "林夏一", "age": 28, "email": "linxia@example.com", "deleted": 0}
  ]
}

这是 Service 的返回值,不是一次真实 HTTP 调用的抓包。

对应请求如果走 Controller,是:

GET /api/users?current=1&size=2&minAge=20&maxAge=30

新增、查询、修改、删除分别是:

POST /api/users {"name":"林夏","age":28,"email":"linxia@example.com"}

GET /api/users/1

PUT /api/users/1 {"name":"林夏一"}

DELETE /api/users/1

`PUT` 只带姓名时,JSON 里没有的 `age`、`email` 会是 null,于是不会进入 SET,原值保留。这和测试里的更新是同一条规则。

分页会先查总数,再查一页。总数那条 SQL 由插件根据原查询改写,所以它和列表 SQL 的空格、括号不完全一样。测试里第一页的列表是 `LIMIT ?`,参数就是页大小。我没有再请求第 2 页,偏移不为 0 时日志里的 `LIMIT` 长什么样,以你打开日志看到的为准。MySQL 上分页越深,`LIMIT` 偏移越大,数据库往往仍要扫描被跳过的行。页码很大时,这是 SQL 的成本,不是把 `size` 调小就能消失的。

`DbType.MYSQL` 表示按 MySQL 的分页语法改写。测试库是 H2 的 MySQL 模式,所以它执行了这套语法。换数据库就要改这个枚举,否则生成的分页语句可能根本跑不了。

6.2 逻辑删除是改标记,不是 DROP 一行

物理删除是 `DELETE FROM sys_user WHERE id=?`,行从表里消失。逻辑删除是把 `deleted` 改成 1,普通查询都带 `deleted=0`,所以业务上看不到。

它适合「删错了还能在库里找到」的资料。它不适合当业务状态来用。官方逻辑删除说明里有一句很实在:如果你要经常把这些行查出来展示,就不要用逻辑删除,单独做一个状态字段。因为一旦标成逻辑删除,通用查询会故意看不见它。

配置可以写在 `@TableLogic` 上,也可以从 3.3.0 起只写全局的 `logic-delete-field`。示例两处都写了,而且值一致。只是为了对照,不是必须写两遍。两处写成不同的 0/1,就会和表里的数据对不上。

你可能会问:删掉之后,按邮箱再注册一个同名用户,会不会撞上旧行的唯一索引?

会。逻辑删除的行还占着唯一索引。本文这张表没有给 `email` 建唯一索引,所以测试看不出这个问题。真要「删除后允许再用同一个邮箱」,唯一索引得把删除标记设计进去,那已经超出这篇入门的范围。

七、哪些地方不能只靠框架

7.1 统计这种句子,自己写更清楚

「20 岁到 30 岁、还没删除的有多少人」用 `selectCount` 加条件也能做。下面这条放在 Mapper 上,是为了展示另一条路:SQL 由你负全责。

java 复制代码
@Select("""
        SELECT COUNT(*)
        FROM sys_user
        WHERE deleted = 0
          AND age >= #{minAge}
          AND age <= #{maxAge}
        """)
Long countActiveByAgeRange(@Param("minAge") int minAge, @Param("maxAge") int maxAge);

测试参数 20 和 30,结果是 2,和分页的 `total` 一致。请注意 `WHERE deleted = 0` 是写死在字符串里的。换成 `BaseMapper` 的方法,框架会自动加;换成自己的 `@Select`,你写什么就执行什么。漏掉这句,已删除的人会被算进去。

联表、分组、子查询也是同样的道理。Wrapper 能拼的条件变长之后,读 SQL 的人还要把 Java 再翻译一遍。那种时候,一段放在注解或 XML 里的 SQL 更容易评审。

`#{}` 会变成 `?`。不要为了省事改成 `${}`,那是字符串替换,用户输入会进 SQL 正文。Wrapper 的 `apply` 如果拼接原始字符串,也是同一类风险。`eq` / `like` / `ge` 走的是参数绑定,测试日志里能看到 `?`。

7.2 四个容易想当然的点

1.代码少,不表示可以不看 SQL。 把 `log-impl` 设成标准输出,就是为了看见最终语句。逻辑删除、null 被省略、分页的 COUNT,都只在 SQL 里现形。

2.没有 WHERE 的更新或删除非常危险。 `BlockAttackInnerInterceptor` 的字节码里准备了两句拒绝理由:`Prohibition of full table deletion` 和 `Prohibition of table update operation`。测试对 `delete(new QueryWrapper<>())` 断言到了异常,并且日志里没有出现 `Preparing`,说明语句没送到数据库。逻辑删除会把 delete 改写成 update,因此你看到的可能是其中一句更新拦截。我没有在测试里打印异常原文,这里不指定唯一的那句英文。这个拦截器要自己注册;不注册的话,空条件删除会作用到所有未删除的行。

3.更新时的 null 不是 NULL。 第四节的日志已经证明。需要「写入 NULL」时单独处理,不要假设 `updateById` 会把没赋值的字段清空。

4.**分页的总数不是免费的。**每次分页至少两条 SQL。条件没有索引时,COUNT 和列表会一起慢。`size` 在 Service 里被限制到 100,避免一个请求拉走太多行;这是示例自己的限制,插件默认不会替你封顶。

八、检验自己是否真正理解

8.2 五道复述题

先自己答,再看后面的判断要点。

  1. `removeById` 之后,表里还有没有这一行?`getById` 为什么返回 null?

  2. 为什么更倾向于 `SysUser::getEmail`,而不是 `"email"`?这是不是就防止了 SQL 注入?

  3. 只引入 starter、不注册 `PaginationInnerInterceptor`,`new Page<>(1, 10)` 会发生什么?

  4. 自己写的 `@Select` 会不会自动加上 `deleted = 0`?

  5. `updateById` 时邮箱设为 null,数据库里的邮箱会被清空吗?

判断要点:

  1. 行还在,`deleted` 被改成 1。`getById` 的 SQL 带 `deleted=0`,所以返回 null。用不经框架的 SQL 仍能读到这行。

  2. 方法引用在改名时能编译失败,字符串不会。防注入靠的是 `?` 占位,两种 Wrapper 的 `eq` / `like` 都用占位。方法引用解决的是重构,不是注入。

  3. 插件不会生效,语句里不会按页截断。具体会不会把很多行查回来,取决于你有没有别的条件。分页插件和 `mybatis-plus-jsqlparser` 都要自己加上。

  4. 不会。自动追加只发生在框架生成的方法上。手写 SQL 要自己写删除条件。

  5. 不会。3.5.18 默认更新策略是 `NOT_NULL`,null 字段不进入 SET。测试里的语句只有 `SET name=?`。

8.3 做完才算会

在示例上加一个查询:**按姓名模糊匹配,并且可选地按年龄区间分页**。本文的 `pageUsers` 已经包含姓名和年龄。请你改一处它还没做的事,并写出你期望的 SQL:

给 `SysUserMapper` 增加一个方法,查出**已经逻辑删除**、且邮箱等于某个参数的用户。然后说明:

  • 为什么不能用 `getById` 或普通的 `LambdaQueryWrapper` 完成;

  • SQL 里应不应该再写 `deleted = 0`;

  • 参数为什么必须用 `#{}`。

判断要点:通用查询会强制「未删除」,所以看不见这些行。这条手写 SQL 要写 `deleted = 1`。邮箱用 `#{email}`,不要拼接进字符串。


总结

MyBatis-Plus 把「每张单表都要抄一遍的增删改查」收成了 `BaseMapper`。数据库仍执行 SQL,MyBatis 仍负责绑定参数和映射结果,Plus 负责把固定句式和逻辑删除、分页这些加工补上。

下次你觉得「框架怎么没按我想的更新」,先看日志里的 `Preparing`。那一行比任何注解的名字都接近真相:哪一列被省略了,哪一个条件被自动加上了,分页有没有真正带上 `LIMIT`。

相关推荐
不绝19126 分钟前
Lua基础语法入门:注释、变量类型与字符串操作
开发语言·lua
CoderYanger33 分钟前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第四弹):图书管理系统(用户登录+添加图书)
java·数据库·spring boot·mysql·面试·java-ee·mybatis
雪芽蓝域zzs34 分钟前
第 11 章:Maven 打包 + Linux 部署(SpringBoot jar 包部署
spring boot
goyeer42 分钟前
【Kubernetes】Kubernetes之CRI详解
java·容器·kubernetes
牧瀬クリスだ1 小时前
从零手写博客系统:分层架构与统一响应(一)
java·数据库·架构·mybatis·springboot·安全架构
Hhy_11071 小时前
《C++深度解构07》手撕 vector —— 从底层三指针架构到迭代器失效彻底吃透
c语言·开发语言·c++·学习·visual studio
nice_lcj5201 小时前
【从零理解计算机网络 · 05】TCP 四次挥手:为什么挥手要四次、TIME_WAIT 在等什么
后端·tcp/ip·计算机网络·面试·tcp·四次挥手·time_wait
Moment1 小时前
RSI 是怎样让 AI 改进自己的 ❓❓❓
前端·后端·面试
风落青芜1 小时前
链式二叉树的实现与基本操作
c语言·开发语言·数据结构·算法