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

前言

作为一名开发者，数据库操作是我们日常工作中不可或缺的部分。传统的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中添加必要依赖：

<!-- 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相关配置：

spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/mp_demo?useSSL=false&useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghaiusername: rootpassword: 123456mybatis-plus:configuration:# 下划线转驼峰map-underscore-to-camel-case: true# 日志实现log-impl: org.apache.ibatis.logging.stdout.StdOutImplglobal-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通过注解简化了实体类与数据库表的映射关系：

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接口

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接口：

public interface UserService extends IService<User> {// 可扩展自定义方法
}@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {// 实现类只需继承ServiceImpl即可
}

3. 基础CRUD示例

@RestController
@RequestMapping("/user")
public class UserController {@Autowiredprivate UserService userService;// 新增@PostMappingpublic boolean save(@RequestBody User user) {return userService.save(user);}// 删除@DeleteMapping("/{id}")public boolean remove(@PathVariable Long id) {return userService.removeById(id);}// 修改@PutMappingpublic 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的分页功能需要先配置分页插件：

@Configuration
public class MyBatisPlusConfig {@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() {MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();// 分页插件interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));return interceptor;}
}

使用示例：

// 基本分页
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接口来处理自动填充字段：

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {@Overridepublic void insertFill(MetaObject metaObject) {this.strictInsertFill(metaObject, "createTime", Date.class, new Date());this.strictInsertFill(metaObject, "updateTime", Date.class, new Date());}@Overridepublic void updateFill(MetaObject metaObject) {this.strictUpdateFill(metaObject, "updateTime", Date.class, new Date());}
}

3. 条件构造器Wrapper

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

// 查询年龄大于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注解后，删除操作将自动变为更新操作：

// 实际执行的是UPDATE t_user SET deleted=1 WHERE id=? AND deleted=0
userMapper.deleteById(1L);// 查询时会自动加上WHERE deleted=0条件
userMapper.selectList(null);

5. 乐观锁实现

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

1. 实体类添加@Version注解

2. 配置乐观锁插件：

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

 使用示例：

// 先查询获取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配置中解放出来，专注于业务逻辑的实现。在实际项目中，你可以根据需求组合使用各种功能，如分页+条件查询、逻辑删除+自动填充等，构建出高效可靠的数据访问层。