当前位置：首页 > news >正文

mp核心功能

news 2025/7/29 14:32:55

条件构造器

mybatisPlus支持各种复杂的where条件, 满足日常的开发

wrapper类就是条件构造器

提供了很多子类

条件构造器的用法：

QueryWrapper和LambdaQueryWrapper通常用来构建select、delete、update的where条件部分
UpdateWrapper和LambdaUpdateWrapper通常只有在set语句比较特殊才使用
尽量使用LambdaQueryWrapper和LambdaUpdateWrapper，避免硬编码

自定义SQL

我们可以利用MyBatisPlus的Wrapper来构建复杂的Where条件，然后自己定义SQL语句中剩下的部分

① 基于Wrapper构建where条件

List<Long> ids = List.of(1L, 2L, 4L);
int amount = 200;
// 1.构建条件
LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<User>().in(User::getId, ids);
// 2.自定义SQL方法调用
userMapper.updateBalanceByIds(wrapper, amount);

② 在mapper方法参数中用Param注解声明wrapper变量名称，必须是ew

void updateBalanceByIds(@Param("ew") LambdaQueryWrapper<User> wrapper, @Param("amount") int amount);

③ 自定义SQL，并使用Wrapper条件

<update id="updateBalanceByIds">UPDATE tb_user SET balance = balance - #{amount} ${ew.customSqlSegment}
</update>

service接口

接口使用流程:

1.自定义 Service 接口继承 IService

作用：让自定义的 Service 接口具备 MP IService 中封装的通用 CRUD（创建、读取、更新、删除）等基础方法，无需手动编写简单的增删改查逻辑。
代码示例：

// 自定义 IUserService 接口，继承 MP 的 IService，泛型指定操作的实体类 User
public interface IUserService extends IService<User> { // 可在此扩展自定义业务方法，如复杂查询、业务逻辑组合等
}

2.自定义 Service 实现类，继承 ServiceImpl 并实现自定义接口

作用：ServiceImpl 类已经实现了 IService 接口的通用方法，继承它后，自定义实现类可直接复用这些通用操作；同时实现自定义 IUserService 接口，保证接口方法的实现与自定义业务逻辑补充。
代码示例：

// UserServiceImpl 实现类，继承 ServiceImpl（需指定对应的 Mapper 接口和实体类），并实现 IUserService
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements IUserService {// 若 IUserService 有自定义方法，在此实现；也可直接使用父类 ServiceImpl 继承来的通用方法，如 save、update、remove、list 等
}

常见CURD:

新增

方法	作用
`save(T)`	保存单个实体对象到数据库，返回是否成功（`boolean` 类型）
`saveBatch(Collection<T>)`	批量保存实体对象集合，默认批次大小，返回操作结果
`saveBatch(Collection<T>, int)`	带自定义批次大小的批量保存，灵活控制批量操作频次
`saveOrUpdateBatch(Collection<T>)`	批量保存或更新，根据实体主键判断，存在则更新、不存在则新增
`saveOrUpdateBatch(Collection<T>, int)`	自定义批次大小的批量保存或更新
`saveOrUpdate(T)`	单个实体的保存或更新，依据主键判断操作类型
`saveOrUpdate(T, Wrapper<T>)`	结合条件的单个实体保存或更新，条件用于辅助判断等场景

修改

方法	作用
`updateById(T)`	根据实体对象的主键更新对应记录，更新非 `null` 字段
`update(Wrapper<T>)`	通过条件构造器 `Wrapper` 构建更新条件，更新符合条件的记录（需配合 `set` 操作，一般在 Lambda 语法或自定义 SQL 里设置更新内容）
`update(T, Wrapper<T>)`	指定实体对象（设置要更新的字段值）和条件构造器 `Wrapper`（设置更新条件），更新符合条件的记录
`updateBatchById(Collection<T>)`	批量根据主键更新实体对象集合，每条记录更新非 `null` 字段
`updateBatchById(Collection<T>, int)`	自定义批次大小的批量主键更新
`saveOrUpdate(T)`	前面新增分类里也有，兼具保存或更新逻辑，依据主键判断

查询

方法	作用
`getById(Serializable)`	根据主键 ID 查询单个实体对象
`getOne(Wrapper<T>)`	通过条件构造器 `Wrapper` 查询单个实体，若结果超过一条会抛异常
`getOne(Wrapper<T>, boolean)`	带是否抛出异常参数，结果多条时，`false` 则返回第一条
`listByIds(Collection<? extends Serializable>)`	根据主键 ID 集合，查询对应的实体列表
`listByMap(Map<String, Object>)`	根据 `Map` 中的键值对（对应数据库字段 - 值）查询实体列表
`list(Wrapper<T>)`	通过条件构造器 `Wrapper` 构建查询条件，查询符合条件的实体列表
`list()`	查询对应实体类的全表数据列表
`page(E, Wrapper<T>)`	结合分页参数 `E`（如 `Page` 对象）和条件构造器 `Wrapper`，实现分页查询
`page(E)`	仅用分页参数 `E` 进行全表分页查询
`lambdaQuery()`	获取 Lambda 语法的查询链 `LambdaQueryChainWrapper`，方便用 Lambda 表达式写条件，如 `service.lambdaQuery().eq(User::getId, 1).list()`
`lambdaQuery(T)`	带实体对象的 Lambda 查询链，可基于实体初始值辅助构造条件
`lambdaUpdate()`	获取 Lambda 语法的更新链 `LambdaUpdateChainWrapper`，用于便捷构建更新操作

删除

方法	作用
`removeById(Serializable)`	根据主键 ID 删除对应的实体记录
`removeById(Serializable, boolean)`	带是否逻辑删除（若开启逻辑删除）的参数，控制删除行为
`removeById(T)`	通过实体对象（主要用主键）删除记录
`removeByMap(Map<String, Object>)`	根据 `Map` 中的键值对（数据库字段 - 值）作为条件，删除符合条件的记录
`remove(Wrapper<T>)`	用条件构造器 `Wrapper` 构建删除条件，删除对应记录
`removeByIds(Collection<?>)`	根据主键 ID 集合，批量删除对应记录
`removeByIds(Collection<?>, boolean)`	带逻辑删除控制参数的批量主键删除
`removeBatchByIds(Collection<?>)`	批量删除主键对应记录，内部处理批次等逻辑
`removeBatchByIds(Collection<?>, boolean)`	带逻辑删除控制的批量主键删除
`removeBatchByIds(Collection<?>, int)`	自定义批次大小、带逻辑删除控制的批量主键删除
`removeBatchByIds(Collection<?>, int, boolean)`	更细粒度控制（批次大小、逻辑删除）的批量主键删除

统计

方法	作用
`count()`	统计对应实体类全表的记录总数
`count(Wrapper<T>)`	根据条件构造器 `Wrapper` 构建的条件，统计符合条件的记录数量

分页查询

方法分类	方法签名	功能说明	典型使用场景
分页查询	`E page(E page, Wrapper<T> queryWrapper)`	传入分页对象（如 `Page` ）和 `Wrapper` 条件，实现带条件的分页查询	分页+条件（如年龄>25 岁）查询用户，同时获取总条数、总页数等分页元数据
分页查询	`E page(E page)`	仅通过分页对象（`Page` ）做全表分页，返回分页结果（含数据+分页信息）	对大数据量表（如系统操作日志）做全表分页展示，按页加载避免一次性查全表

列表查询

方法分类	方法签名	功能说明	典型使用场景
列表查询	`List<T> listByIds(Collection<? extends Serializable> ids)`	根据主键集合批量查询，传入 ID 集合，返回对应实体列表	批量获取指定 ID 的用户信息，如 `listByIds(Arrays.asList(1L, 2L, 3L))`
列表查询	`List<T> listByMap(Map<String, Object> map)`	用 `Map` 封装简单条件（字段名 - 值）查询，返回实体列表	按 `{"name": "张三", "age": 20}` 查用户，适配无需复杂条件的场景
列表查询	`List<T> list(Wrapper<T> queryWrapper)`	结合 `Wrapper`（如 `LambdaQueryWrapper` ）构建复杂条件查询，返回列表	多条件组合（如年龄>18 且性别为男）查询，满足复杂业务筛选需求
列表查询	`List<T> list()`	查询对应实体类全表数据，返回所有记录	加载数据量小的字典表（如状态枚举表）全量内容

Lambda 操作

方法分类	方法签名	功能说明	典型使用场景
Lambda 操作	`LambdaQueryChainWrapper<T> lambdaQuery()`	获取 Lambda 查询链，支持链式调用+Lambda 表达式写条件，简化查询构建	链式写法：`lambdaQuery().eq(User::getId, 1).like(User::getName, "张").list()`
Lambda 操作	`LambdaQueryChainWrapper<T> lambdaQuery(T entity)`	基于传入实体的初始值，结合 Lambda 链补充条件查询	已有部分实体数据（如姓名），再叠加年龄条件：`lambdaQuery(user).gt(User::getAge, 18).list()`
Lambda 操作	`LambdaUpdateChainWrapper<T> lambdaUpdate()`	获取 Lambda 更新链，用链式+Lambda 表达式定义更新字段和条件	链式更新：`lambdaUpdate().set(User::getStatus, 1).eq(User::getId, 1).update()`