IService 和 BaseMapper:CRUD 操作的选择指南

大家有没有注意到这么一个情况在我们平常开发的时候,会遇到一个有趣的重复现象:Dao 层 继承的 BaseMapper 提供了一系列 CRUD 方法,而Service层 接口继承的 IService 也提供了一套看起来非常相似的 CRUD 操作。那么我们在开发的时候到底该用哪个?它们有什么区别吗?

一、角色定位(这大家都知道)

  1. BaseMapper:Dao 层的"工具箱" 它属于 数据访问层(DAO/Mapper) 。这个是直接和数据库打交道的。它的方法直接对应着 一个SQL 语句。不关心业务逻辑,只负责把数据存进去或按条件查出来。

  2. IService: 它属于 业务逻辑层(Service) 。这是处理业务规则 在 BaseMapper 提供的"原子工具"基础上,构建更符合业务场景 的操作。它可能包含组合操作、批量操作、业务校验等。 方法往往更偏向于业务逻辑处理,例如 saveOrUpdate(保存或更新)、saveBatch(批量保存)、listByIds(按ID集合批量查询)、page(带分页的查询)。它是事务的边界,比如事务回滚啥的。

二、主要的区别

特性 BaseMapper (Dao层) **IService (Service层) **
定位 数据访问 (直接操作访问数据库) 主要处理业务逻辑
操作粒度 原子操作 (单条记录/简单条件) 业务操作 (可能组合多个原子操作,批量操作)
事务性 Dao层一般牵扯不到事务 有事务,比如@Transactional事务回滚等
业务逻辑 按理说这里没有业务逻辑 主要业务逻辑的处理,校验唯一性,数据是否存在,List数据组合等等
复杂度 低 (直接映射SQL) 相对较高 (封装组合逻辑)

三、实战演示:代码里的"双胞胎"

1. Dao 层 (使用 BaseMapper)

java 复制代码
// UserDao.java (Mapper 接口)
public interface UserDao extends BaseMapper<User> {
    // 通常只需要继承 BaseMapper,基础CRUD方法就有了
    // 可以在这里定义额外的、复杂SQL的自定义方法
}

2. Service 层接口 (使用 IService)

java 复制代码
// UserService.java (Service 接口)
public interface UserService extends IService<User> {
    // 继承了 IService 的通用CRUD方法
    // 可以在这里定义业务相关的特定方法
}

3. Service 层实现 (依赖 BaseMapper 实现 IService)

java 复制代码
// UserServiceImpl.java (Service 实现类)
@Service
public class UserServiceImpl extends ServiceImpl<UserDao, User> implements UserService {
    // 关键点在这里:ServiceImpl 内部已经注入了 UserDao (即 BaseMapper<User>)
    // 它利用 UserDao 提供的基础能力来实现 IService 接口中定义的更高级方法
    // 例如:
    //   @Override
    //   @Transactional(propagation = Propagation.REQUIRED, rollbackFor = Exception.class)
    //   public boolean saveBatch(Collection<User> entityList) {
    //       // 这里可能会使用循环 + userDao.insert(entity) 或更优的批量策略
    //       // 并且这个方法默认在一个事务内执行!
    //   }
}

关键观察:

  • UserDao是真正执行 SQL 的底层工具。
  • UserServiceImpl 实现了 IService 接口。
  • UserServiceImpl 内部依赖 UserDao来完成其功能。IService 的方法本质上是构建在 BaseMapper基础之上的。
  • IService 的 saveBatch等方法内部会调用 BaseMapper 的 insert 方法(可能多次或使用批处理),并在这个过程上加上了事务管理。

四、如何进行选择

明白了区别,选择就清晰多了:

  1. 在 Service 实现类 (ServiceImpl) 内部:

    • 优先使用 IService 提供的方法! 这是最推荐、最常用的方式。
    • 为什么?
    • 方法名和功能更贴合业务场景(批量操作、智能保存等)。
    • IService 方法默认在事务中执行,保证数据一致性(如批量操作失败会回滚)。
    • 代码简洁一行 saveBatch(list) 比你自己写循环调用 insert并管理事务要简洁安全得多。明确体现了 Service 层调用 Dao 层的分层关系。
  2. 在需要编写非常定制化的复杂 SQL 或特殊查询时:

    • 可以在 UserDao中定义自定义方法 ,并在对应的 Mapper.xml 文件或注解中编写 SQL。
    • 然后在 UserServiceImpl 中,通过 this.getBaseMapper() 或 baseMapper (如果你在实现类中直接注入了 UserDao ) 来调用这些自定义的 Dao 方法。
  3. 在 Controller 或其他非Service类中:

    • 绝对不要 直接注入和使用 BaseMapper!必须通过 Service 接口来访问业务功能。
    • 这是分层架构的核心原则:Controller 调用 Service,Service 调用 Mapper。直接绕开 Service 层使用 Mapper 会破坏分层,导致事务失效。千万不要这么胡整哦!都没可读性了

五、总结一把

  • BaseMapper:提供直接、原子化的数据库访问能力,是数据持久化的基础。
  • IService:站在业务的角度,在 BaseMapper 的基础上,提供更符合业务需求、而且还有事务管理的一些注解和方法等。

选择的关键在于理解分层:

  1. BaseMapper:专注"如何访问数据库"。
  2. IService:专注"业务逻辑的处理,和数据的一个整合吧",并协调底层数据访问。
相关推荐
程序猿DD1 小时前
OctaFuse Gateway 2.15.0:MCP 聚合、向量 Embeddings 与官方目录同步
后端·agent
余槐i3 小时前
PostgreSQL 函数索引报错 must be immutable:3种绕法与代价
数据库·后端·sql·postgresql·性能优化
需要8264 小时前
Spring Bean 生命周期:从实例化到销毁的完整钩子
java·后端·spring
凤山老林5 小时前
Spring Boot 接入国密 SM2/SM3/SM4 的一些实践记录
spring boot·后端·python
伯恩bourne6 小时前
Spring Boot Bean 注册的两种方式:@Component 家族 vs @Configuration + @Bean
java·spring boot·后端
张彦峰ZYF6 小时前
停顿短不等于延迟低:G1、ZGC 与低延迟服务的目标分野、代价账本与选型标定
后端·回收暂停、应用停止总时长·到达安全点、分配停滞·屏障吃吞吐、并发线程吃核心·并发窗口吃堆余量·分区式靠挑回收集兑现目标·染色指针式不支持压缩引用
pride.li7 小时前
第03章 Python 教程-基础语法:注释与变量
服务器·前端·后端·python·算法·计算机视觉
upala7 小时前
【仓颉语言入门 · 第二篇 第 6 课】
后端
罗丹丹Luna7 小时前
移动端显示“已提交”以后:SAP 与低代码集成该怎样暴露真实状态
后端·架构
码事漫谈7 小时前
因为太想讨好你,所以AI会骗你
后端