mybatis-plus service层拥有的方法
📅 2026/7/16 16:27:18
👁️ 阅读次数
📝 编程学习
前文我们学习了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))
编程学习
技术分享
实战经验