MyBatis-Plus 框架中，`BaseMapper` 和 `ServiceImpl` 是两个核心组件区别对比

原创已于 2025-07-08 15:00:22 修改 · 796 阅读

18 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis #java

于 2025-07-08 14:41:07 首次发布

JAVA 专栏收录该内容

30 篇文章

订阅专栏

在 MyBatis-Plus 框架中，BaseMapper 和 ServiceImpl 是两个核心组件，分别承担数据访问层（DAO）和服务层（Service）的职责。以下是两者的区别对比及实际应用场景分析：

1. 定义与定位

组件	定义	定位
BaseMapper	MyBatis-Plus 提供的基础 Mapper 接口，封装了单表的 CRUD 操作（如 `insert`、`deleteById`、`selectById` 等）。	数据访问层（DAO/Mapper）
ServiceImpl	MyBatis-Plus 提供的服务层默认实现类，实现了 `IService` 接口，封装了业务逻辑，并通过委托模式调用 `BaseMapper` 的方法。	服务层（Service）

2. 功能范围

组件	功能特点
BaseMapper	- 提供基础的数据库操作方法（增删改查）。 - 方法命名遵循 SQL 动作（如 `insert`、`updateById`）。 - 仅支持单表操作，不涉及业务逻辑。
ServiceImpl	- 封装业务逻辑（如数据校验、事务管理、多表操作）。 - 对 `BaseMapper` 方法进行二次封装（如 `save` 对应 `insert`），返回更友好的布尔值或对象。 - 支持批量操作（如 `saveBatch`）、组合操作（如 `saveOrUpdate`）等高级功能。

3. 代码生成与实现

组件	代码实现
BaseMapper	- 接口方法由 MyBatis 动态代理生成，无需手动实现。 - 例如：`insert(entity)` 自动生成插入 SQL。
ServiceImpl	- 继承自 `ServiceImpl` 的类会自动拥有 `IService` 的所有方法实现。 - 例如：`save(entity)` 内部调用 `baseMapper.insert(entity)` 并返回操作结果。 - 可通过继承 `ServiceImpl` 扩展自定义业务逻辑。

4. 方法对照与差异

BaseMapper 的核心方法

insert(T entity): 插入一条记录。
deleteById(Serializable id): 根据主键删除。
updateById(T entity): 根据主键更新。
selectById(Serializable id): 根据主键查询。

ServiceImpl 的核心方法

save(T entity): 调用 baseMapper.insert(entity)，返回布尔值。
removeById(Serializable id): 调用 baseMapper.deleteById(id)，返回布尔值。
updateById(T entity): 直接调用 baseMapper.updateById(entity)。
getById(Serializable id): 调用 baseMapper.selectById(id)。

差异点

返回值不同：
- BaseMapper 方法返回 int（影响行数），而 ServiceImpl 方法返回 boolean（操作是否成功）。
- 例如：save(entity) 内部通过 SqlHelper.retBool(baseMapper.insert(entity)) 转换返回值。
功能扩展：
- ServiceImpl 提供了 BaseMapper 不具备的额外方法，如 saveBatch（批量保存）、saveOrUpdate（保存或更新）等。

5. 使用场景

适用 BaseMapper 的场景

需要直接执行简单 CRUD 操作，且无需业务逻辑处理。

示例：在 Mapper 接口中直接调用 BaseMapper 方法：

@Select("SELECT * FROM user WHERE age > #{age}")
List<User> selectByAge(@Param("age") int age);

适用 ServiceImpl 的场景

需要处理复杂业务逻辑（如事务管理、数据校验、多表关联）。

示例：在 Service 层实现业务逻辑：

@Transactional
public boolean registerUser(User user) {
    // 业务逻辑：校验用户、加密密码、保存用户
    if (user.getPassword() == null) return false;
    user.setPassword(encrypt(user.getPassword()));
    return save(user); // 调用 ServiceImpl 的 save 方法
}

6. 关系与协作

依赖关系：ServiceImpl 依赖 BaseMapper（通过泛型参数注入 Mapper 实例）。
协作模式：ServiceImpl 通过方法代理调用 BaseMapper 的方法，并在其基础上封装业务逻辑。
分层意义：
- BaseMapper 负责数据操作，与数据库紧密耦合。
- ServiceImpl 负责业务逻辑，解耦业务与数据库操作，提升可维护性。

总结

对比维度	BaseMapper	ServiceImpl
层级	数据访问层（DAO）	服务层（Service）
功能	基础 CRUD 操作（单表）	业务逻辑封装、事务管理、多表操作
方法返回值	`int`（影响行数）	`boolean`（操作结果）或对象
扩展性	通过继承扩展自定义 SQL 方法	通过重写方法或添加新方法扩展业务逻辑
适用场景	简单数据库操作	复杂业务逻辑、事务管理、批量操作