MyBatis-Plus：入门学习

在 Java 后端开发中，如果你还在为手写单表 CRUD（增删改查）的 SQL 语句而掉头发，那么 MyBatis-Plus（简称 MP）绝对是你必须掌握的效率神器。官方对它的定位是：“只做增强不做改变，为简化开发、提高效率而生”。

这条文章主要是方便自己复习用，如果有错误请在评论区帮我指正，谢谢咯~

核心原理解析：为什么不用写 SQL？

MP 底层并没有脱离 JDBC 和 MyBatis，它只是做了一套非常精妙的**“自动化封装”**。

主要依赖于三个核心技术：

1.继承机制： MP 官方提供了 BaseMapper<T> 和 IService<T> 两个接口。你的类只要继承它们，就等于直接拥有了官方提前写好的几十个标准 CRUD 方法。

2.泛型推导：接口后面的泛型 <T>（例如 <User>）非常关键。MP 会读取这个实体类的信息。

3.反射与动态 SQL：当项目启动时，MP 的“SQL 注入器”会利用 Java 反射机制，扫描 <T> 对应的实体类。

通过类名推导出表名（User -> user 表）。
通过属性名推导出字段名（userAccount -> user_account 字段）。
最终在内存中自动帮你动态拼接出标准的 SQL 语句（如 SELECT * FROM user WHERE id = ?），并注入到 MyBatis 的配置中。

Mapper 层实战

Mapper 层是最贴近数据库的一层，它继承自 BaseMapper<T>，主要负责单表的最基础操作。

接口定义

// 继承 BaseMapper，泛型指定为 User 实体类
@Mapper
public interface UserMapper extends BaseMapper<User> {
    // 里面一行代码都不用写，但是涵盖了基础 CRUD 功能！
}

常用方法演示

// 1. 新增 (Insert)
User user = new User();
user.setUserAccount("admin");
user.setUserPassword("123456");
userMapper.insert(user); // 插入成功后，雪花算法生成的 ID 会自动回填到 user 对象中

// 2. 删除 (Delete)
userMapper.deleteById(1001L); // 根据 ID 删除
userMapper.deleteBatchIds(Arrays.asList(1L, 2L, 3L)); // 批量删除

// 3. 修改 (Update)
User updateObj = new User();
updateObj.setId(1001L);
updateObj.setUserName("新名字");
userMapper.updateById(updateObj); // 仅更新非空字段，密码等未设置的字段不会被覆盖

// 4. 查询 (Select)
User dbUser = userMapper.selectById(1001L); // 查单条
List<User> userList = userMapper.selectBatchIds(Arrays.asList(1L, 2L)); // 根据多个 ID 查集合

Service 层实战

很多时候，单条的 insert 无法满足复杂的业务场景（比如注册时要判断存在则更新，不存在则插入）。这时候就需要 Service 层出马了。它继承自 IService<T>。

接口与实现类定义

// 1. 接口继承 IService
public interface UserService extends IService<User> {
}

// 2. 实现类继承 ServiceImpl，并实现自己的接口
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
}

Service 层的独特功能

Service 层不仅封装了 Mapper 的所有功能，还自带事务控制和批量处理能力。

// 1. 批量保存 (saveBatch) —— 极致的性能优化
List<User> userList = new ArrayList<>();
// ... 模拟添加1000个用户对象到集合中
userService.saveBatch(userList); // 底层分批次提交，性能远超写个 for 循环调用 mapper.insert

// 2. 保存或更新 (saveOrUpdate) —— 智能路由
User user = new User();
user.setId(1001L); // 如果传入了ID，且数据库中有该ID，则执行 Update
user.setUserName("更新名字");
// user.setId(null); // 如果ID为空，则直接执行 Insert
userService.saveOrUpdate(user); 

// 3. 链式查询 (Chain Query) —— 代码更优雅
List<User> list = userService.query()
    .eq("user_account", "admin")
    .list();

3.Service层(this.xxx)的用法

// 在 UserServiceImpl 类的方法中：

boolean updateResult = this.update()
    .eq("user_account", "admin")      // 锁定条件 (WHERE)
    .set("user_password", "888888")   // 修改内容 (SET)
    .set("status", 1)                 // 修改内容 (SET)
    .update();                        // 执行

if(!updateResult){
    throw new RuntimeException("更新失败");
}

（1）查询

日常开发中最常打交道的就是查数据，除了this.query()有很多直接的方法:

this.getById(id)：最简单的按主键查单条。
this.getOne(wrapper, throwEx)：（高频踩坑点！） 根据条件查单条。如果数据库里符合条件的有多条记录，默认会报错。你可以传第二个参数 false（this.getOne(wrapper, false)），这样遇到多条记录时，它会乖乖返回第一条而不报错。
this.list() / this.list(wrapper)：查全表，或者根据条件查出一个 List 集合。
this.listByIds(idList)：极度常用！传入一个 ID 的 List，直接返回这些 ID 对应的实体集合（比如在购物车里根据选中的商品 ID 列表查详情）。
this.count(wrapper)：统计行数。比如 this.count(new QueryWrapper<User>().eq("status", 1))，相当于 SELECT COUNT(*) ...。
this.page(page, wrapper)：无脑分页查询。

（2）删除

this.removeById(id)：根据 ID 删单条。
this.removeByIds(idList)：根据 ID 集合批量删（比如后台管理系统的“批量删除”按钮）。
this.remove(wrapper)：根据条件删（比如清空某个用户的所有登录日志：this.remove(new LambdaQueryWrapper<Log>().eq(Log::getUserId, 1001))）。

（3）链式调用

// 链式查询：查出一个 List
List<User> list = this.query()
    .eq("status", 1)
    .like("user_name", "张")
    .list(); // 最后以 .list() 结尾

// 链式查询：查出一个单条对象
User user = this.query().eq("user_account", "admin").one();

// 链式查询：查总数
long count = this.query().eq("role", "VIP").count();

// 链式删除：一行代码搞定条件删除
this.update().eq("status", -1).remove();

条件构造器 (Wrapper)

如何不写 SQL 就能完成复杂的 WHERE 条件过滤？MP 提供了强大的 Wrapper 机制。在企业开发中，强烈推荐使用 LambdaQueryWrapper，它可以避免字段名拼写错误。

// 场景：在 API 开放平台中，查询账号为 admin，且状态为正常的接口调用者，按创建时间倒序排
LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();

wrapper.eq(User::getUserAccount, "admin")       // WHERE user_account = 'admin'
       .eq(User::getStatus, 0)                  // AND status = 0
       .like(User::getUserName, "测试")          // AND user_name LIKE '%测试%'
       .orderByDesc(User::getCreateTime);       // ORDER BY create_time DESC

List<User> userList = userMapper.selectList(wrapper);

常用条件指令速查表：

eq (等于 =)、ne (不等于 <>)
gt (大于 >)、ge (大于等于 >=)
lt (小于 <)、le (小于等于 <=)
like (模糊查询 LIKE ‘%值%’)
in (包含 IN (v1, v2, …))

进阶实用功能

除了基础 CRUD，MP 还内置了非常多解决开发痛点的插件：

分页插件： 只需配置一个拦截器，调用 selectPage 方法，MP 会自动帮你执行 COUNT 查询并拼接 LIMIT 语句，从此告别手写分页逻辑。
自动填充： 通过 @TableField(fill = FieldFill.INSERT) 配合元对象处理器，可以在插入或更新时，自动填充 create_time 和 update_time，再也不用每次 set 时间了。
逻辑删除： 给 is_deleted 字段加上 @TableLogic 注解。调用 deleteById 时，底层会自动变成 UPDATE is_deleted = 1，并在随后的所有 select 查询中，自动带上 WHERE is_deleted = 0 的过滤条件。