mybatis-plus service层拥有的方法

📅 2026/7/16 16:27:18 👁️ 阅读次数 📝 编程学习
mybatis-plus service层拥有的方法

前文我们学习了lambdaQuery() ,这个事不过是service层里一个普通的链式调用方法,他还有其他很多的方法

在 MyBatis-Plus 中,Service 层的核心是 IService 接口及其默认实现类 ServiceImpl。它们进一步封装了 CRUD 操作,采用了 get(查询单行)、list(查询集合)、remove(删除)、save(新增)、update(更新)、page(分页)等前缀命名方式,以区分 Mapper 层并避免混淆。
以下是 MyBatis-Plus Service 层提供的常用方法分类整理:

新增操作 (Save)

  • save(T entity):插入一条记录(如果主键自增,主键会自动回填)。
  • saveBatch(Collection entityList):批量插入(默认每次提交 1000 条,可自定义批次大小)。
  • saveOrUpdate(T entity):如果记录存在则更新,不存在则插入(依赖 @TableId 注解判断)。
  • saveOrUpdateBatch(Collection entityList):批量执行插入或更新操作。

删除操作 (Remove)

  • removeById(Serializable id):根据主键 ID 删除记录。
  • removeByMap(Map<String, Object> columnMap):根据 Map 中的键值对作为条件进行删除。
  • remove(Wrapper queryWrapper):根据条件构造器(Wrapper)动态删除。
  • removeByIds(Collection<? extends Serializable> idList):根据 ID 集合批量删除。

更新操作 (Update)

  • updateById(T entity):根据主键 ID 更新记录(仅更新实体中非 null 的字段)。
  • update(T entity, Wrapper updateWrapper):根据条件构造器更新。第一个参数为实体(可为 null),第二个参数为 Wrapper 条件。
  • update(Wrapper updateWrapper):仅根据 Wrapper 中的 set 和 where 条件进行更新。
  • updateBatchById(Collection entityList):根据 ID 批量更新记录

查询单条记录 (Get)

  • getById(Serializable id):根据主键 ID 查询单条记录。
  • getOne(Wrapper wrapper):查询单条记录。若查出多条,默认不报错(自动加 LIMIT 1);若传入 getOne(wrapper, true),查出多条时会抛出异常。

查询列表与集合 (List)

  • list():查询表中的所有数据。
  • list(Wrapper wrapper):根据条件构造器查询列表。
  • listByIds(Collection<? extends Serializable> idList):根据 ID 集合批量查询。
  • listByMap(Map<String, Object> columnMap):根据 Map 条件查询列表。

分页与统计 (Page & Count)

  • page(Page page, Wrapper wrapper):分页查询,返回包含数据和总数的分页对象。
  • pageMaps(Page<Map<String, Object>> page, Wrapper wrapper):分页查询,但将结果映射为 Map 集合。
  • count():查询总记录数。
  • count(Wrapper wrapper):根据条件统计记录总数。

链式调用 (Chain Wrapper)

  • lambdaQuery():返回 LambdaQueryChainWrapper,支持使用 Lambda 表达式进行链式查询,最后以 .one()、.list()、.count() 等方法结尾。

getOne() 与 .one() 的核心区别

正确的写法

Useruser=this.lambdaQuery().eq(User::getPhone,"13800138000").orderByDesc(User::getCreateTime).one();
LambdaQueryWrapper<User>wrapper=newLambdaQueryWrapper<>();wrapper.eq(User::getPhone,"13800138000").orderByDesc(User::getCreateTime);// 使用 this.getOne() 替代 this.selectOne()Useruser=this.getOne(wrapper);

然两者都是查询单条记录,但在处理多条数据时的表现有很大不同:

  • 链式调用 .one():如果数据库中存在多条满足条件的记录,它会直接抛出异常(TooManyResultsException)。
  • this.getOne(wrapper):默认情况下(底层 throwEx 为 false),如果查出多条记录,它不会报错,而是会自动在 SQL 末尾加上 LIMIT 1,只返回第一条记录。
    (注:如果你希望 getOne 在查出多条时也抛出异常,可以显式传入第二个参数:this.getOne(wrapper, true))