异常教程

mybatis plus（建议收藏）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在 Java 后端开发领域，数据库操作始终是开发者的核心任务之一。传统的 MyBatis 虽然功能强大，但其开发效率较低，尤其对于 CRUD 操作需要编写大量重复代码。mybatis plus（以下简称 MP）作为 MyBatis 的增强工具包，通过简化代码、提供开箱即用的功能，显著提升了开发效率。本文将从基础到进阶，结合实际案例，带读者一步步掌握 MP 的核心能力，帮助开发者快速上手并高效使用这一工具。

一、MyBatis Plus 的核心价值与适用场景

1.1 为什么选择 MyBatis Plus？

mybatis plus 是 MyBatis 的“智能助手”，其核心价值体现在以下几点：

  • 代码简洁化：通过注解和 Lambda 表达式，减少 80% 以上的重复代码。
  • 功能扩展性：内置条件构造器、自动填充、乐观锁等特性，降低复杂业务逻辑的实现难度。
  • 性能优化：支持 SQL 语句的自动优化，减少开发者对底层 SQL 的直接干预。

例如，传统 MyBatis 实现一条带条件的查询语句可能需要编写 XML 文件定义 SQL 语句，而 MP 可以通过 QueryWrapper 直接在 Java 代码中构建动态条件，避免 XML 的维护成本。

1.2 适用场景

  • 快速开发场景：需要快速实现基础的增删改查功能。
  • 中小型项目：业务逻辑复杂度适中，但希望减少代码冗余。
  • 团队协作：通过统一的 API 接口，降低因不同开发者的 SQL 写法差异带来的维护成本。

二、快速入门：从零开始搭建 MyBatis Plus

2.1 环境准备与依赖配置

在 Maven 项目中引入 mybatis plus 的核心依赖：

<dependency>  
    <groupId>com.baomidou</groupId>  
    <artifactId>mybatis-plus-boot-starter</artifactId>  
    <version>3.5.2</version>  
</dependency>

同时，需配置数据库连接信息，例如在 application.properties 中添加：

spring.datasource.url=jdbc:mysql://localhost:3306/test_db  
spring.datasource.username=root  
spring.datasource.password=123456

2.2 第一个 MyBatis Plus 示例

步骤 1：创建实体类

@Data // Lombok 注解，自动生成 getter/setter  
public class User {  
    private Long id;  
    private String name;  
    private Integer age;  
    private String email;  
}

步骤 2：定义 Mapper 接口

public interface UserMapper extends BaseMapper<User> {  
}

通过继承 BaseMapper，即可直接使用 selectById()、insert() 等基础方法。

步骤 3：编写测试代码

@Autowired  
private UserMapper userMapper;  

public void testInsert() {  
    User user = new User();  
    user.setName("张三");  
    user.setAge(25);  
    user.setEmail("zhangsan@example.com");  
    userMapper.insert(user); // 自动填充 id 值  
}

三、核心特性详解：深入理解 MyBatis Plus 的能力

3.1 条件构造器：动态 SQL 的优雅实现

QueryWrapper 是 MP 中用于构建动态查询条件的核心工具，其语法类似“积木式”拼接：

QueryWrapper<User> wrapper = new QueryWrapper<>();  
wrapper.eq("age", 25)          // 等于条件  
       .like("name", "张")     // 模糊匹配  
       .ge("age", 18);         // 大于等于  

List<User> users = userMapper.selectList(wrapper);

通过链式调用，开发者无需手动拼接 SQL 字符串，降低了 SQL 注入的风险。

3.2 自动填充：数据字段的智能维护

自动填充功能可实现在插入或更新操作时，自动为字段赋值（如创建时间、更新时间）。

步骤 1：创建填充处理器

@Component  
public class MyMetaObjectHandler implements MetaObjectHandler {  
    @Override  
    public void insertFill(MetaObject metaObject) {  
        this.setFieldValByName("create_time", System.currentTimeMillis(), metaObject);  
    }  

    @Override  
    public void updateFill(MetaObject metaObject) {  
        this.setFieldValByName("update_time", System.currentTimeMillis(), metaObject);  
    }  
}

步骤 2：在实体类中标记字段

@Data  
public class User {  
    private Long id;  
    private String name;  
    @TableField(fill = FieldFill.INSERT)  
    private Date create_time;  
    @TableField(fill = FieldFill.INSERT_UPDATE)  
    private Date update_time;  
}

3.3 乐观锁：保障数据一致性

通过 Version 注解实现乐观锁机制，防止并发修改冲突：

@Data  
public class User {  
    @Version  
    private Integer version;  
}

当两条并发更新操作同时提交时，版本号不一致的更新会被拒绝，从而避免“最后写入覆盖”问题。

四、进阶用法：解锁 MyBatis Plus 的隐藏能力

4.1 自定义 SQL 的灵活扩展

对于复杂查询需求，可通过 @Select 注解或 XML 文件定义 SQL：

public interface UserMapper extends BaseMapper<User> {  
    @Select("SELECT * FROM user WHERE name = #{name} AND age > #{age}")  
    List<User> selectByNameAndAge(String name, Integer age);  
}

4.2 分页查询的高效实现

使用 Page 对象实现分页：

Page<User> page = new Page<>(1, 10); // 第1页，每页10条  
Page<User> result = userMapper.selectPage(page, new QueryWrapper<User>().gt("age", 20));  
System.out.println("总记录数：" + result.getTotal());

4.3 性能优化：避免 N+1 问题

在关联查询场景中，通过 JOIN 和 selectObjs 方法避免多次查询：

// 假设 User 和 Order 是一对多关系  
List<Map<String, Object>> result = userMapper.selectObjs(new QueryWrapper<Order>()  
        .select("user.id AS user_id, COUNT(order.id) AS order_count")  
        .groupBy("user.id"));

五、最佳实践：让代码更健壮、高效

5.1 代码规范建议

  • 字段命名一致性：实体类字段名与数据库列名严格一致，或通过 @TableField 明确映射关系。
  • 避免全表查询：使用 selectById 替代 selectList，避免无条件查询全表数据。
  • 合理使用缓存：对高频查询数据，结合 MyBatis 的二级缓存或 Redis 进行优化。

5.2 常见问题与解决方案

问题 1：字段未自动填充

原因：未在实体类上标注 @TableField(fill = ...)，或未注册 MetaObjectHandler。
解决方案：检查配置步骤，并确保填充处理器被 Spring 容器管理。

问题 2：分页查询数据为空

原因：数据库表名与实体类名称不匹配，导致 MyBatis Plus 自动映射失败。
解决方案：在 Mapper 接口或实体类上使用 @TableName("实际表名") 显式指定表名。

六、实战案例：用户管理系统

6.1 需求描述

实现一个简单的用户管理功能，包含以下操作：

  • 新增用户
  • 根据年龄范围查询用户
  • 更新用户信息
  • 分页展示用户列表

6.2 代码实现

实体类（User.java）

@Data  
@TableName("user")  
public class User {  
    private Long id;  
    private String name;  
    private Integer age;  
    private String email;  
    @Version  
    private Integer version;  
    @TableField(fill = FieldFill.INSERT)  
    private LocalDateTime createTime;  
}

Mapper 接口（UserMapper.java）

public interface UserMapper extends BaseMapper<User> {  
    // 自定义查询：按年龄范围分页  
    List<User> selectByAgeRange(@Param("minAge") Integer minAge, @Param("maxAge") Integer maxAge);  
}

Service 层（UserService.java）

@Service  
public class UserService {  
    @Autowired  
    private UserMapper userMapper;  

    public void addUser(User user) {  
        userMapper.insert(user);  
    }  

    public Page<User> getUsersByAge(Integer pageNum, Integer pageSize, Integer minAge, Integer maxAge) {  
        Page<User> page = new Page<>(pageNum, pageSize);  
        QueryWrapper<User> wrapper = new QueryWrapper<>();  
        wrapper.between("age", minAge, maxAge);  
        return userMapper.selectPage(page, wrapper);  
    }  
}

结论

MyBatis Plus 通过其简洁的 API 和丰富的内置功能，显著降低了 Java 后端开发的复杂度。无论是基础的 CRUD 操作，还是复杂的分页、条件查询，MP 都能提供高效且易维护的解决方案。对于开发者而言，掌握 MP 的核心特性（如条件构造器、自动填充、乐观锁）是提升开发效率的关键。随着项目复杂度的增加，合理运用分页优化、自定义 SQL 等进阶功能，更能确保系统的稳定性和可扩展性。

建议读者在实践中逐步探索 MP 的更多特性，例如多数据源支持、代码生成器等，以进一步释放其潜力。通过本文的案例和代码示例，希望每位开发者都能快速上手并享受 MyBatis Plus 带来的开发乐趣！

最新发布

查看更多文章