MyBatis-Plus增删改查的通用化封装过程

更新时间：2026年05月31日 10:12:54 作者：工頁光軍

这段文章详细介绍了MyBatis-Plus的通用化封装方案,通过泛型和继承实现了Mapper、Service、Controller层的通用接口；业务模块仅需继承这些通用类即可实现增删改查功能；此方案极大提升了代码复用性和扩展性；适用于企业级开发实践

一、基础准备：统一响应结果

先封装通用响应类，保证接口返回格式统一，减少重复编码：

package com.example.mpdemo.common;

import lombok.Data;

/**
 * 通用响应结果类
 * @param <T> 响应数据类型
 */
@Data
public class Result<T> {
    // 响应码（200成功，500失败）
    private Integer code;
    // 响应消息
    private String msg;
    // 响应数据
    private T data;

    // 成功响应（无数据）
    public static <T> Result<T> success() {
        return new Result<>(200, "操作成功", null);
    }

    // 成功响应（有数据）
    public static <T> Result<T> success(T data) {
        return new Result<>(200, "操作成功", data);
    }

    // 失败响应
    public static <T> Result<T> fail(String msg) {
        return new Result<>(500, msg, null);
    }
}

二、通用层封装

1. 通用 Mapper 层（BaseMapper 增强）

MyBatis-Plus 的 BaseMapper 已封装基础 CRUD，我们只需定义通用接口让业务 Mapper 继承：

package com.example.mpdemo.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;

/**
 * 通用 Mapper 接口
 * @param <T> 实体类类型
 */
@Mapper
public interface BaseGenericMapper<T> extends BaseMapper<T> {
    // 无需额外方法，继承 BaseMapper 的 17 个基础 CRUD 方法即可
}

2. 通用 Service 层

封装通用 Service 接口和实现类，复用 IService 的高级 CRUD 能力：

（1）通用 Service 接口

package com.example.mpdemo.service;

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

import java.io.Serializable;
import java.util.List;

/**
 * 通用 Service 接口
 * @param <T> 实体类类型
 */
public interface BaseGenericService<T> extends IService<T> {
    // 可扩展通用方法，比如自定义分页、批量操作等
    List<T> list(Wrapper<T> queryWrapper);  // 条件查询列表
    IPage<T> page(IPage<T> page, Wrapper<T> queryWrapper);  // 条件分页查询
    T getById(Serializable id);  // 根据 ID 查询
    boolean saveEntity(T entity);  // 新增
    boolean updateEntity(T entity);  // 修改
    boolean removeById(Serializable id);  // 根据 ID 删除
}

（2）通用 Service 实现类

package com.example.mpdemo.service.impl;

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.example.mpdemo.mapper.BaseGenericMapper;
import com.example.mpdemo.service.BaseGenericService;

import java.io.Serializable;
import java.util.List;

/**
 * 通用 Service 实现类
 * @param <M> Mapper 类型
 * @param <T> 实体类类型
 */
public class BaseGenericServiceImpl<M extends BaseGenericMapper<T>, T> 
        extends ServiceImpl<M, T> implements BaseGenericService<T> {

    @Override
    public List<T> list(Wrapper<T> queryWrapper) {
        return baseMapper.selectList(queryWrapper);
    }

    @Override
    public IPage<T> page(IPage<T> page, Wrapper<T> queryWrapper) {
        return baseMapper.selectPage(page, queryWrapper);
    }

    @Override
    public T getById(Serializable id) {
        return baseMapper.selectById(id);
    }

    @Override
    public boolean saveEntity(T entity) {
        return save(entity);  // 复用 IService 的 save 方法
    }

    @Override
    public boolean updateEntity(T entity) {
        return updateById(entity);  // 复用 IService 的 updateById 方法
    }

    @Override
    public boolean removeById(Serializable id) {
        return baseMapper.deleteById(id);
    }
}

3. 通用 Controller 层（核心）

封装通用的增删改查接口，业务 Controller 只需继承此类并指定实体和主键类型，无需重复编写接口：

package com.example.mpdemo.controller;

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.example.mpdemo.common.Result;
import com.example.mpdemo.service.BaseGenericService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.io.Serializable;
import java.util.List;

/**
 * 通用 CRUD Controller
 * @param <T> 实体类类型
 * @param <K> 主键类型（如 Long、String）
 */
public class BaseGenericController<T, K extends Serializable> {

    // 注入通用 Service（由子类指定具体实现）
    @Autowired
    protected BaseGenericService<T> baseService;

    /**
     * 1. 新增
     */
    @PostMapping
    public Result<T> add(@RequestBody T entity) {
        boolean success = baseService.saveEntity(entity);
        return success ? Result.success(entity) : Result.fail("新增失败");
    }

    /**
     * 2. 根据 ID 删除
     */
    @DeleteMapping("/{id}")
    public Result<Void> delete(@PathVariable K id) {
        boolean success = baseService.removeById(id);
        return success ? Result.success() : Result.fail("删除失败");
    }

    /**
     * 3. 修改
     */
    @PutMapping
    public Result<T> update(@RequestBody T entity) {
        boolean success = baseService.updateEntity(entity);
        return success ? Result.success(entity) : Result.fail("修改失败");
    }

    /**
     * 4. 根据 ID 查询
     */
    @GetMapping("/{id}")
    public Result<T> getById(@PathVariable K id) {
        T entity = baseService.getById(id);
        return entity != null ? Result.success(entity) : Result.fail("数据不存在");
    }

    /**
     * 5. 查询所有（无条件）
     */
    @GetMapping("/list")
    public Result<List<T>> list() {
        List<T> list = baseService.list(Wrappers.emptyWrapper());
        return Result.success(list);
    }

    /**
     * 6. 分页查询（默认第1页，每页10条，可传参数自定义）
     */
    @GetMapping("/page")
    public Result<IPage<T>> page(
            @RequestParam(defaultValue = "1") Long current,
            @RequestParam(defaultValue = "10") Long size) {
        IPage<T> page = baseService.page(new Page<>(current, size), Wrappers.emptyWrapper());
        return Result.success(page);
    }
}

三、业务模块使用示例（以 User 为例）

只需编写少量代码，继承通用类即可拥有完整的增删改查接口：

1. 实体类（User）

沿用之前的 User 实体（无需修改）：

package com.example.mpdemo.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

import java.time.LocalDateTime;

@Data
@TableName("user")
public class User {
    @TableId(type = IdType.ASSIGN_ID)
    private Long id;
    private String username;
    private Integer age;
    private String email;
    private LocalDateTime createTime;
}

2. 业务 Mapper（UserMapper）

继承通用 Mapper：

package com.example.mpdemo.mapper;

import com.example.mpdemo.entity.User;
import org.springframework.stereotype.Repository;

@Repository
public interface UserMapper extends BaseGenericMapper<User> {
    // 无需编写任何代码，自动拥有所有基础 CRUD 能力
}

3. 业务 Service

（1）Service 接口

package com.example.mpdemo.service;

import com.example.mpdemo.entity.User;

public interface UserService extends BaseGenericService<User> {
    // 可扩展自定义业务方法
}

（2）Service 实现类

package com.example.mpdemo.service.impl;

import com.example.mpdemo.entity.User;
import com.example.mpdemo.mapper.UserMapper;
import com.example.mpdemo.service.UserService;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl extends BaseGenericServiceImpl<UserMapper, User> implements UserService {
    // 无需编写任何代码，自动继承通用 Service 的所有方法
}

4. 业务 Controller

继承通用 Controller，指定实体（User）和主键类型（Long）：

package com.example.mpdemo.controller;

import com.example.mpdemo.entity.User;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * 用户控制器，继承通用 Controller 后自动拥有所有 CRUD 接口
 */
@RestController
@RequestMapping("/user")
public class UserController extends BaseGenericController<User, Long> {
    // 无需编写任何接口代码，自动拥有：
    // POST /user → 新增
    // DELETE /user/{id} → 删除
    // PUT /user → 修改
    // GET /user/{id} → 根据ID查询
    // GET /user/list → 查询所有
    // GET /user/page → 分页查询
}

四、接口测试（Postman/Curl）

接口	请求方式	说明	示例请求参数
/user	POST	新增用户	{"username":"张三","age":20,"email":"zhangsan@example.com","createTime":"2026-03-13 10:00:00"}
/user/1	DELETE	删除用户	路径参数 id=1
/user	PUT	修改用户	{"id":1,"username":"张三","age":21}
/user/1	GET	查询单个用户	路径参数 id=1
/user/list	GET	查询所有用户	无参数
/user/page?current=1&size=2	GET	分页查询	参数 current=1（页码）、size=2（每页条数）

五、扩展说明

自定义条件查询：若需添加条件查询，可在通用 Controller 中扩展，或在业务 Controller 中新增方法：

// UserController 中新增条件查询接口
@GetMapping("/listByAge")
public Result<List<User>> listByAge(@RequestParam Integer age) {
    LambdaQueryWrapper<User> wrapper = Wrappers.lambdaQuery(User.class)
            .gt(User::getAge, age);
    List<User> list = baseService.list(wrapper);
    return Result.success(list);
}

异常处理：可添加全局异常处理器（@RestControllerAdvice），统一捕获增删改查中的异常（如主键不存在、参数非法等）；
权限控制：若需接口权限，可在通用 Controller 或业务 Controller 中添加 @PreAuthorize 等注解；
参数校验：可在实体类中添加 @NotNull、@NotBlank 等校验注解，配合 @Valid 实现参数校验。

总结

核心思路：通过泛型 + 继承封装通用的 Mapper、Service、Controller，业务模块只需继承通用类，无需重复编写增删改查代码；
复用性：通用层封装了 6 个核心 CRUD 接口（新增、删除、修改、单查、列表、分页），覆盖 90% 以上的单表业务场景；
扩展性：通用类预留了扩展接口，业务模块可按需新增自定义方法，不破坏通用逻辑。

这种方式极大减少了重复编码，符合“开闭原则”，是企业开发中常用的 MyBatis-Plus 最佳实践。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

SpringBoot CountDownLatch多任务并行处理的实现方法
本篇文章主要介绍了SpringBoot CountDownLatch多任务并行处理的实现方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-04-04
mybatis 解决从列名到属性名的自动映射失败问题
这篇文章主要介绍了mybatis 解决从列名到属性名的自动映射失败问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-06-06
Java Pattern与Matcher字符串匹配案例详解
这篇文章主要介绍了Java Pattern与Matcher字符串匹配案例详解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
2021-09-09
mybatis接口绑定失效的解决
这篇文章主要介绍了mybatis接口绑定失效的解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-11-11
详谈@Autowired和static的关系
这篇文章主要介绍了@Autowired和static的关系，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-08-08
Java如何用一个统一结构接收成员名称不固定的数据
这篇文章主要为大家详细介绍了Java如何用一个统一结构接收成员名称不固定的数据,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
2024-11-11
Java中Collections.sort的使用
本文主要介绍了Java中Collections.sort的使用，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-05-05
Java设计模式之模板方法模式Template Method Pattern详解
在我们实际开发中，如果一个方法极其复杂时，如果我们将所有的逻辑写在一个方法中，那维护起来就很困难，要替换某些步骤时都要重新写，这样代码的扩展性就很差，当遇到这种情况就要考虑今天的主角——模板方法模式
2022-11-11
Java模拟微信来电提醒示例
这篇文章主要为大家介绍了Java模拟微信来电提醒示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-07-07
解决Idea运行junit测试时报Error:[3,17] 程序包org.junit不存在的问题
这篇文章主要介绍了Idea运行junit测试时报Error:[3,17] 程序包org.junit不存在解决方法,本文给大家分享两种解决办法，需要的朋友可以参考下
2023-03-03