当前位置：首页 > news >正文

【MyBatis-Plus】让 MyBatis 更简单高效

news 来源：原创 2025/5/16 7:03:33

如果你曾经使用过 MyBatis，你一定知道它的强大和灵活。然而，随着项目规模的增长，手写 SQL 成为了一件既繁琐又容易出错的事。这时，MyBatis-Plus（简称 MP）应运而生，它为 MyBatis 增强了许多功能，帮我们极大地提高开发效率。接下来，我们就来聊聊 MyBatis-Plus 的基本介绍和使用，让你轻松上手！

一、MyBatis-Plus 是什么？

MyBatis-Plus 是一款基于 MyBatis 的增强工具，它的口号是 “为简化开发而生”。简单来说，MP 在保留 MyBatis 灵活性的同时，帮我们封装了很多常用的功能，比如：

自动生成单表的 CRUD 操作，再也不用手写增删改查。
提供强大的 条件构造器，动态生成查询语句。
内置了 分页插件，让分页查询变得超级简单。

它适合那些既想要使用 ORM 工具，又希望对 SQL 有一定掌控力的开发者。

二、MyBatis-Plus 的核心特性

1. 开箱即用的 CRUD

MP 提供了 BaseMapper 接口，只需继承它，你就能获得所有单表的增删改查方法。例如：

UserMapper userMapper = ...; // Mapper 注入
User user = userMapper.selectById(1L); // 根据主键查询

就这么简单，一行代码搞定！

2. 强大的条件构造器

还记得那些复杂的 WHERE 条件 SQL 吗？MP 的条件构造器能帮你轻松搞定：

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.eq("age", 18).like("name", "Jack");
List<User> users = userMapper.selectList(queryWrapper);

动态查询再也不用拼接字符串了，是不是很香？

3. 分页插件

分页查询是开发中最常见的需求之一。MP 提供了内置的分页插件，只需简单配置，就可以用如下代码实现分页：

Page<User> page = new Page<>(1, 10); // 第1页，每页10条
Page<User> result = userMapper.selectPage(page, null);
System.out.println(result.getRecords()); // 当前页数据
System.out.println(result.getTotal()); // 总记录数

4. 自动代码生成器

如果你讨厌一遍遍写 Entity、Mapper、Service 的模板代码，MP 的代码生成器可以帮你一次性生成全部内容，让你专注于业务逻辑。

三、MyBatis-Plus 的快速入门

接下来，我们用一个简单的例子来说明如何使用 MyBatis-Plus。

1. 引入依赖

在你的项目中添加 MyBatis-Plus 的 Maven 依赖：

注意这里是以 Spring Boot 3 整合 MyBatis Plus，Spring Boot 2 的话要导入另一个包mybatis-plus-boot-starter

<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-spring-boot3-starter</artifactId><version>3.5.9</version>
</dependency>

2. 配置数据源

在 application.yml 中配置数据源（以操作 MySQL 为例）和 MyBatis-Plus：

spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/test_dbusername: rootpassword: 123456mybatis-plus:configuration:log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 把sql语句打印到控制台

3. 创建实体类

假设我们的数据库中有一个 user 表，我们可以创建对应的实体类：

@Data    // Lombok注解，生成一个JavaBean常用的方法
@TableName("user")    // 指定绑定的数据表名
public class User {private Long id;private String name;private Integer age;private String email;
}

4. 创建 Mapper 接口

继承 BaseMapper 即可：

@Mapper
public interface UserMapper extends BaseMapper<User> {
}

5. 调用 CRUD 接口

在 Service 或 Controller 中使用：

@RestController
@RequestMapping("/user")
public class UserController {@Autowiredprivate UserMapper userMapper;@GetMapping("/list")public List<User> listUsers() {return userMapper.selectList(null); // 查询所有用户}
}

运行后访问 /user/list，你会发现用户数据已经成功查询出来了！

确实，IService 是 MyBatis-Plus 提供的一种更高层次的接口封装，它将常用的业务逻辑操作进一步抽象，方便我们在 Service 层使用，避免直接操作 Mapper。下面补充关于 IService 和 ServiceImpl 的使用方法。

6. 使用 IService 接口实现业务逻辑

MyBatis-Plus 提供了 IService 和 ServiceImpl，帮我们在 Service 层简化基础逻辑操作，同时保持扩展性。

① 创建 Service 接口

继承 IService<T> 接口，定义业务逻辑层的接口：

public interface UserService extends IService<User> {// 自定义业务方法（如果有）
}

② 实现 Service 接口

创建实现类，继承 MyBatis-Plus 提供的 ServiceImpl 基类，自动注入 Mapper：

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {// 可以在这里扩展自定义的业务逻辑方法
}

③ 使用 Service

在 Controller 或其他业务类中注入 UserService，调用封装的 CRUD 方法：

@RestController
@RequestMapping("/user")
public class UserController {@Autowiredprivate UserService userService;@GetMapping("/list")public List<User> listUsers() {return userService.list(); // 查询所有用户}@PostMapping("/add")public boolean addUser(@RequestBody User user) {return userService.save(user); // 新增用户}@DeleteMapping("/delete/{id}")public boolean deleteUser(@PathVariable Long id) {return userService.removeById(id); // 根据 ID 删除用户}
}

【IService 的优势】

抽象通用逻辑：将通用的 CRUD 方法（如 save、removeById、getById、list 等）封装到接口中，避免每个 Service 重复实现。
Mapper 解耦：在业务层调用 IService 提供的方法，无需直接操作 Mapper，增强了代码的层次性和可维护性。
可扩展性：如果有自定义业务逻辑，只需在 UserService 接口和 UserServiceImpl 类中实现，无需修改基础代码。

7. 最佳实践

如果项目规模较小，直接使用 BaseMapper 实现 CRUD，简单快捷。
如果项目复杂且需要 Service 层管理业务逻辑，建议使用 IService 和 ServiceImpl，规范代码结构。

四、为什么要用 MyBatis-Plus？

手写增删改查 SQL 的疲劳感：
想象一下，你有 10 个表，每个表都要写四五个基础操作的 SQL，是不是一想到就想摆烂？
动态拼接 SQL 的复杂性：
有些查询条件需要用户输入，这就意味着动态 SQL。手写拼接不仅代码冗长，而且容易出错。
分页查询的重复劳动：
传统分页查询需要写 SQL，还要计算总数。如果有工具自动搞定，岂不是省心又省力？

五、总结

MyBatis-Plus 是一款极大提升开发效率的工具，它不仅让我们摆脱了繁琐的基础代码编写，还提供了强大的功能来满足各种场景需求，我们可以在项目开发中更加专注业务逻辑，可以说是开发行云流水。通过今天的分享，相信你已经对 MP 有了初步的了解。

如果你对 MP 感兴趣，不妨动手尝试一下，亲自体验它的便捷性！之后，我会继续进一步展开来讲解开发中常用的部分，以及一些核心机制等内容，感兴趣的朋友可以关注留意一下噢！