SpringBoot整合MyBatis-Plus：零XML实现高效CRUD

小赵面校招2025-05-14 9:12

前言

作为一名开发者，数据库操作是我们日常工作中不可或缺的部分。传统的MyBatis虽然强大，但需要编写大量XML映射文件，这在快速开发的今天显得效率不足。MyBatis-Plus（简称MP）作为MyBatis的增强工具，在保留MyBatis所有特性的基础上，极大地简化了开发流程。本文将带你全面了解如何在SpringBoot项目中整合MyBatis-Plus，实现零XML配置的高效CRUD操作。

一、MyBatis-Plus简介：JPA vs MyBatis vs MyBatis-Plus

在开始整合之前，我们先了解下这三种持久层框架的特点和差异：

特性 JPA MyBatis MyBatis-Plus
ORM支持 全自动ORM 半自动ORM MyBatis增强
SQL控制 自动生成，可控性低 完全手动控制 自动生成+手动控制
XML配置 无 需要大量XML 零XML
CRUD操作 方法命名自动生成 需手动编写 内置通用Mapper
学习曲线 中等 较高 低（MyBatis基础上）
适用场景 简单标准业务 复杂SQL业务 各种业务场景

MyBatis-Plus的核心优势：

  1. 无侵入：只做增强不做改变，引入它不会对现有工程产生影响

  2. 损耗小：启动即会自动注入基本CRUD，性能基本无损耗

  3. 强大CRUD：内置通用Mapper、通用Service，少量配置即可实现单表大部分CRUD操作

  4. 多种插件：支持分页、性能分析、乐观锁、逻辑删除等

二、SpringBoot整合MyBatis-Plus

1. 添加依赖

首先在pom.xml中添加必要依赖：

XML 复制代码 
<!-- SpringBoot Starter -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- MyBatis-Plus Starter -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3.1</version>
</dependency>

<!-- 数据库驱动（以MySQL为例） -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

<!-- Lombok简化实体类开发 -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

2. 配置数据库连接

在application.yml中配置数据源和MyBatis-Plus相关配置：

XML 复制代码 
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/mp_demo?useSSL=false&useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
    username: root
    password: 123456

mybatis-plus:
  configuration:
    # 下划线转驼峰
    map-underscore-to-camel-case: true
    # 日志实现
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  global-config:
    db-config:
      # 主键类型 AUTO:"数据库ID自增", INPUT:"用户输入ID", ID_WORKER:"全局唯一ID", UUID:"全局唯一UUID"
      id-type: auto
      # 逻辑删除字段名
      logic-delete-field: deleted
      # 逻辑删除值
      logic-delete-value: 1
      # 逻辑未删除值
      logic-not-delete-value: 0

三、实体类注解详解

MyBatis-Plus通过注解简化了实体类与数据库表的映射关系：

java 复制代码 
import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;

import java.util.Date;

@Data
@TableName("t_user")  // 指定表名，省略时默认使用类名作为表名
public class User {
    
    @TableId(type = IdType.AUTO)  // 主键自增
    private Long id;
    
    private String username;
    
    private String password;
    
    @TableField("real_name")  // 指定数据库字段名
    private String realName;
    
    private Integer age;
    
    private String email;
    
    @TableField(fill = FieldFill.INSERT)  // 插入时自动填充
    private Date createTime;
    
    @TableField(fill = FieldFill.INSERT_UPDATE)  // 插入和更新时自动填充
    private Date updateTime;
    
    @Version  // 乐观锁版本字段
    private Integer version;
    
    @TableLogic  // 逻辑删除字段
    private Integer deleted;
}

常用注解说明：

  • @TableName：指定实体类对应的表名

  • @TableId：指定主键字段，可配置主键生成策略

  • @TableField：指定非主键字段与数据库列的映射关系

  • @Version：乐观锁注解

  • @TableLogic：逻辑删除注解

四、Mapper接口与Service层开发

1. 创建Mapper接口

java 复制代码 
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.demo.entity.User;

public interface UserMapper extends BaseMapper<User> {
    // 继承BaseMapper后已包含基本CRUD方法
    // 可在此添加自定义SQL方法
}

2. Service层实现

MyBatis-Plus提供了通用的Service接口：

java 复制代码 
public interface UserService extends IService<User> {
    // 可扩展自定义方法
}

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
    // 实现类只需继承ServiceImpl即可
}

3. 基础CRUD示例

java 复制代码 
@RestController
@RequestMapping("/user")
public class UserController {
    
    @Autowired
    private UserService userService;
    
    // 新增
    @PostMapping
    public boolean save(@RequestBody User user) {
        return userService.save(user);
    }
    
    // 删除
    @DeleteMapping("/{id}")
    public boolean remove(@PathVariable Long id) {
        return userService.removeById(id);
    }
    
    // 修改
    @PutMapping
    public boolean update(@RequestBody User user) {
        return userService.updateById(user);
    }
    
    // 查询单个
    @GetMapping("/{id}")
    public User getById(@PathVariable Long id) {
        return userService.getById(id);
    }
    
    // 分页查询
    @GetMapping("/page")
    public IPage<User> page(@RequestParam(defaultValue = "1") Integer current,
                           @RequestParam(defaultValue = "10") Integer size) {
        return userService.page(new Page<>(current, size));
    }
}

五、高级功能实战

1. 分页插件配置

MyBatis-Plus的分页功能需要先配置分页插件：

java 复制代码 
@Configuration
public class MyBatisPlusConfig {
    
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 分页插件
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

使用示例：

java 复制代码 
// 基本分页
Page<User> page = new Page<>(1, 10);  // 当前页，每页大小
userMapper.selectPage(page, null);

// 自定义SQL分页
@Select("SELECT * FROM t_user WHERE age > #{age}")
IPage<User> selectPageByAge(IPage<User> page, @Param("age") Integer age);

2. 自动填充功能

实现MetaObjectHandler接口来处理自动填充字段：

java 复制代码 
@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
    
    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime", Date.class, new Date());
        this.strictInsertFill(metaObject, "updateTime", Date.class, new Date());
    }
    
    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updateTime", Date.class, new Date());
    }
}

3. 条件构造器Wrapper

MyBatis-Plus提供了强大的条件构造器，可以构建复杂查询条件：

java 复制代码 
// 查询年龄大于18且名字包含"张"的用户
LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
wrapper.gt(User::getAge, 18)
       .like(User::getUsername, "张");
List<User> users = userMapper.selectList(wrapper);

// 更新操作
LambdaUpdateWrapper<User> updateWrapper = new LambdaUpdateWrapper<>();
updateWrapper.eq(User::getUsername, "张三")
             .set(User::getAge, 25);
userMapper.update(null, updateWrapper);

4. 逻辑删除配置

在application.yml中已经配置了逻辑删除，实体类字段添加@TableLogic注解后，删除操作将自动变为更新操作：

java 复制代码 
// 实际执行的是UPDATE t_user SET deleted=1 WHERE id=? AND deleted=0
userMapper.deleteById(1L);

// 查询时会自动加上WHERE deleted=0条件
userMapper.selectList(null);

5. 乐观锁实现

乐观锁通过版本号机制实现：

  1. 实体类添加@Version注解

  2. 配置乐观锁插件：

java 复制代码 
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    // 乐观锁插件
    interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
    return interceptor;
}

使用示例：

java 复制代码 
// 先查询获取version
User user = userMapper.selectById(1L);
// 修改数据
user.setUsername("new name");
// 执行更新，会带上version条件
userMapper.updateById(user);

六、性能优化建议

  1. 批量操作 ：使用saveBatch、updateBatchById等方法提高批量操作效率

  2. SQL打印：开发环境可开启SQL打印方便调试，生产环境应关闭

  3. 索引优化：为常用查询条件添加数据库索引

  4. 查询字段控制 ：避免使用select *，明确指定查询字段

  5. 逻辑删除：对于大表，逻辑删除可能影响性能，需考虑归档策略

七、常见问题解决方案

  1. 表名/字段名不一致：

    • 使用@TableName和@TableField注解明确指定

    • 配置全局的下划线转驼峰命名

  2. 主键策略问题：

    • IdType.AUTO：数据库自增

    • IdType.ASSIGN_ID：雪花算法生成ID（默认）

    • IdType.ASSIGN_UUID：UUID生成

  3. 分页失效：

    • 确保配置了分页插件

    • 检查Page参数是否正确传递

  4. 逻辑删除无效：

    • 检查application.yml中的逻辑删除配置

    • 确保实体类字段添加了@TableLogic注解

结语

通过本文的介绍，相信你已经掌握了SpringBoot整合MyBatis-Plus的核心要点。MyBatis-Plus的强大功能可以让我们从繁琐的XML配置中解放出来，专注于业务逻辑的实现。在实际项目中，你可以根据需求组合使用各种功能，如分页+条件查询、逻辑删除+自动填充等，构建出高效可靠的数据访问层。

相关推荐
码农飞哥7 分钟前
互联网大厂Java求职面试实战：Spring Boot与微服务场景深度解析
java·数据库·spring boot·安全·微服务·消息队列·互联网医疗
意倾城38 分钟前
浅说MyBatis-Plus 的 saveBatch 方法
java·mybatis
I_itaiit1 小时前
Spring Boot之Web服务器的启动流程分析
spring boot·nettywebserver·httphandler·webhandler
AI+程序员在路上1 小时前
Web Service及其实现技术（SOAP、REST、XML-RPC）介绍
xml·rpc·web
老李不敲代码2 小时前
榕壹云搭子系统技术解析：基于Spring Boot+MySQL+UniApp的同城社交平台开发实践
spring boot·mysql·微信小程序·uni-app·软件需求
养军博客3 小时前
spring boot3.0自定义校验注解：文章状态校验示例
java·前端·spring boot
DragonnAi3 小时前
【目标检测标签转换工具】YOLO 格式与 Pascal VOC XML 格式的互转详解（含完整代码）
xml·yolo·目标检测
Brilliant Nemo3 小时前
五、框架实战：SSM整合原理和实战
maven·mybatis
小赵面校招4 小时前
Spring Boot整合MyBatis全攻略：原理剖析与最佳实践
java·spring boot·mybatis
曼岛_4 小时前
[Java实战]Spring Boot 3 整合 Ehcache 3（十九）
java·spring boot·spring
热门推荐
01YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】02从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑03KGG转MP3工具|非KGM文件|解密音频04组基轨迹建模 GBTM的介绍与实现（Stata 或 R）05【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！06Coze扣子平台完整体验和实践（附国内和国际版对比）07YOLOv5改进 | 添加CA注意力机制 + 增加预测层 + 更换损失函数之GIoU08yolov8，yolo11，yolo12 服务器训练到部署全流程 笔记09DeepSeek各版本说明与优缺点分析10【解决】Android Gradle Sync 报错 Could not read workspace metadata