快速入门：MyBatis Plus 基础教程与实际应用

概述

MyBatis Plus 是基于 MyBatis 的增强库，显著简化了 CRUD 操作，提供了动态 SQL 生成、分页支持、逻辑删除等丰富功能。它通过内置工具类和方法，大幅减少了编码量，使基于 MyBatis 的项目开发更加便捷高效。本文将引导您从引入 MyBatis Plus 开始，涵盖基础操作、高级功能探索及实战案例，同时探讨性能优化和最佳实践。

MyBatis Plus 简介

MyBatis Plus 是 MyBatis 的增强版本，旨在简化 CRUD 操作，并提供了更多功能，如动态 SQL 生成、分页支持、逻辑删除等。相较于 MyBatis，MyBatis Plus 通过内置的工具类和方法，精简了代码量，提升了开发效率。

安装与引入 MyBatis Plus

在您的项目中确保已包含 MyBatis 和其核心依赖，然后使用 Maven 或 Gradle 添加 MyBatis Plus 的依赖。

<!-- For Maven -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>最新版本号</version>
</dependency>

<!-- For Gradle -->
dependencies {
    implementation 'com.baomidou:mybatis-plus-boot-starter:最新版本号'
}

基础操作

创建实体类与自定义配置

实体类用于映射数据库中的表，通常包含属性和对应的 getter/setter 方法。MyBatis Plus 为基本操作提供了额外便利。

实体类示例：

import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import java.time.LocalDateTime;
import java.io.Serializable;

/**
 * 简单的用户实体类
 */
@TableName("user")
public class User implements Serializable {
    private static final long serialVersionUID = 1L;

    @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    private String username;

    private String password;

    private LocalDateTime createTime;

    // Getter 和 Setter 方法
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    // 其他属性的 Getter 和 Setter...
}

基本 CRUD 操作

MyBatis Plus 提供简化 CRUD 操作的工具类，如 BaseMapper 和 MapperFactory。

创建 Dao 接口：

import com.baomidou.mybatisplus.core.mapper.BaseMapper;

public interface UserMapper extends BaseMapper<User> {
}

操作示例：

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
public class UserTest {

    @Autowired
    private UserMapper userMapper;

    @Test
    public void testInsert() {
        User user = new User();
        user.setUsername("测试用户");
        user.setPassword("testPassword");
        user.setCreateTime(LocalDateTime.now());
        int rows = userMapper.insert(user);
        System.out.println("插入行数: " + rows);
    }

    @Test
    public void testUpdate() {
        QueryWrapper<User> queryWrapper = Wrappers.query();
        queryWrapper.eq("id", 1L);
        User user = new User();
        user.setUsername("更新后的用户");
        int rows = userMapper.update(user, queryWrapper);
        System.out.println("更新行数: " + rows);
    }

    // 其他测试方法...
}

高级功能探索

分页查询与分页助手

MyBatis Plus 提供了分页查询助手 PageHelper，简化了分页实现。

创建分页实例：

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
public class UserPageTest {

    @Autowired
    private UserMapper userMapper;

    @Test
    public void testPageQuery() {
        Long pageNum = 1L;
        Long pageSize = 10L;
        Page<User> page = new Page<>(pageNum, pageSize);
        userMapper.selectPage(page, null);
        List<User> users = page.getRecords();
        System.out.println("分页结果: " + users);
        System.out.println("总页数: " + page.getPages());
    }
}

条件构造器与动态 SQL

MyBatis Plus 提供了 LambdaQueryWrapper 和 QueryWrapper，用于构造复杂查询条件，简化动态 SQL 生成。

动态 SQL 示例：

import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
public class UserQueryTest {

    @Autowired
    private UserMapper userMapper;

    @Test
    public void testQueryWithWrapper() {
        QueryWrapper<User> queryWrapper = Wrappers.query();
        queryWrapper.eq(User::getId, 1L);
        List<User> users = userMapper.selectList(queryWrapper);
        System.out.println("查询结果: " + users);
    }

    @Test
    public void testQueryWithLambdaWrapper() {
        LambdaQueryWrapper<User> lambdaQueryWrapper = Wrappers.lambdaQuery();
        lambdaQueryWrapper.eq(User::getId, 1L);
        List<User> users = userMapper.selectList(lambdaQueryWrapper);
        System.out.println("查询结果: " + users);
    }
}

实战案例

项目演示与功能实现

在构建电商系统时，使用 MyBatis Plus 处理用户订单、商品、库存等业务操作。

1. 数据模型：为每个业务实体创建相应的实体类和 DAO 接口。
2. CRUD 操作：通过 MyBatis Plus 的工具类执行增删改查操作。
3. 逻辑删除与版本控制：利用 MyBatis Plus 的逻辑删除功能标记删除记录，实现版本控制。
4. 分页查询：在用户界面集成分页功能，提升用户体验。
5. 动态 SQL：通过 LambdaQueryWrapper 简化复杂查询条件的构建。

性能优化与最佳实践

• 考虑缓存策略、数据库连接优化、异步处理高并发。
• 遵循 DRY 原则，减少代码冗余，提升代码可维护性。

结论

通过本文，您已深入了解了 MyBatis Plus 的基础概念、核心功能及其在实际应用中的运用。MyBatis Plus 的高效和简洁 API 大幅提升了开发效率，简化了数据库操作。掌握 MyBatis Plus，将助力您构建高效、可维护的数据库应用，显著提升开发团队的生产力。