MyBatisPlus的快速入门与基本使用

# 1. 介绍

## 1.1 什么是MyBatisPlus

MyBatisPlus（简称MP）是一款基于MyBatis的轻量级增强框架，旨在简化MyBatis的开发流程。它提供了许多强大的功能和特性，使得开发者可以更加高效、快速地进行数据库操作。

## 1.2 MyBatisPlus的主要特性

- **简化XML配置**：MyBatisPlus通过使用注解和配置类，极大地减少了繁琐的XML配置，使开发更加便捷。
- **强大的CRUD操作**：MyBatisPlus提供了丰富的CRUD方法，只需简单几行代码即可完成数据的增删改查。
- **灵活的分页查询**：MyBatisPlus内置了分页插件，支持多种数据库的分页查询，并提供了简单易用的分页方法。
- **便捷的条件构造器**：MyBatisPlus提供了链式调用的方式来构建查询条件，使得查询更加灵活、可读性更高。
- **内置的通用方法**：MyBatisPlus提供了一系列通用的方法，如批量操作、逻辑删除、乐观锁等，减少了重复劳动。
- **丰富的插件支持**：MyBatisPlus支持自定义插件的开发和使用，可以轻松扩展框架的功能。

## 1.3 为什么选择使用MyBatisPlus

相比于传统的MyBatis框架，MyBatisPlus具有以下优点：

- **简单易用**：MyBatisPlus将MyBatis的繁琐过程进行封装，提供了一系列简单易用的方法，开发者无需关心复杂的底层实现细节。
- **高效开发**：MyBatisPlus提供了丰富的通用方法和便捷的条件构造器，以及自动生成的Mapper文件，使得开发效率大大提升。
- **可维护性强**：MyBatisPlus的代码结构清晰，规范明确，易于理解和维护，减少了代码的冗余和重复。
- **丰富的功能扩展**：MyBatisPlus支持自定义插件和扩展，可以根据实际需求进行功能增强，满足不同场景的开发需求。

综上所述，MyBatisPlus是一款让开发更加简单、高效和灵活的框架，值得开发者选择和使用。

## 1.4 环境准备和安装

在开始使用MyBatisPlus之前，我们需要进行一些环境准备和安装步骤：

- **环境准备**：确保已经安装好Java开发环境和相应的数据库环境。
- **项目依赖**：在项目的`pom.xml`文件中添加MyBatisPlus的Maven依赖。
- **数据库连接**：配置数据库连接信息，包括URL、用户名和密码等。
- **实体类编写**：创建与数据库表字段对应的实体类。

下一节将详细介绍如何进行配置与初始化。

# 2. 配置与初始化

在这一章节中，我们将详细介绍如何配置和初始化MyBatisPlus，包括Maven依赖配置、数据库连接配置、实体类编写以及MyBatisPlus核心组件的配置。

### 2.1 Maven依赖配置

首先，我们需要在Maven项目的pom.xml文件中添加MyBatisPlus的依赖配置，以引入MyBatisPlus库的支持。在dependencies节点下添加以下依赖：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus</artifactId>
    <version>3.4.2</version>
</dependency>

保存pom.xml文件后，Maven将自动下载并导入MyBatisPlus库。

### 2.2 数据库连接配置

接下来，我们需要在项目的配置文件（如application.properties或application.yml）中配置数据库连接信息。以application.properties为例：

spring.datasource.url=jdbc:mysql://localhost:3306/mybatis_plus_demo?useSSL=false&serverTimezone=GMT%2B8&useUnicode=true&characterEncoding=utf-8
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

这里我们使用MySQL数据库作为示例，需要根据实际情况修改url、username和password的数值。

### 2.3 实体类编写

在使用MyBatisPlus进行CRUD操作时，我们需要对应数据库中的表定义实体类。以用户表User为例，我们创建一个User实体类：

import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;

@TableName("user")
public class User {
    @TableId
    private Long id;
    private String username;
    private String password;
    // 省略getter和setter方法
}

在这里，@TableName注解用于指定实体类对应的数据库表名，@TableId注解用于指定实体类的主键字段。

### 2.4 配置MyBatisPlus的核心组件

MyBatisPlus的核心组件包括Mapper接口和Mapper.xml文件，但是在MyBatisPlus中，Mapper接口可以通过继承BaseMapper接口来实现基本的CRUD操作，而无需编写Mapper.xml文件。我们只需为每个实体类创建对应的Mapper接口，让它继承BaseMapper接口即可。

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

public interface UserMapper extends BaseMapper<User> {
    // 这里可以自定义一些特殊的查询方法
}

在这里，UserMapper接口继承自BaseMapper\<User>接口，即可直接调用BaseMapper中定义的CRUD方法，无需额外编写Mapper.xml文件。

通过以上步骤，我们完成了MyBatisPlus的配置与初始化。接下来，我们将介绍如何进行CRUD操作。

# 3. CRUD操作

#### 3.1 创建数据表

首先，我们需要创建一个数据表，以便进行CRUD操作的演示。假设我们创建了一个名为 `user` 的表，包含 `id`（主键），`username` 和 `password` 字段。

CREATE TABLE user (
  id INT AUTO_INCREMENT PRIMARY KEY,
  username VARCHAR(50) NOT NULL,
  password VARCHAR(50) NOT NULL
);

#### 3.2 插入数据

接下来，我们将演示如何使用 MyBatisPlus 插入数据到数据库中。

// 创建 User 对象
User user = new User();
user.setUsername("John");
user.setPassword("123456");

// 插入数据
userMapper.insert(user);

**代码解释：**
- 首先创建一个 `User` 对象，并设置 `username` 和 `password` 的值。
- 然后通过 `userMapper.insert(user)` 方法将数据插入数据库中。

#### 3.3 查询数据

下面以查询id为1的用户作为例子进行演示：

// 查询id为1的用户
User user = userMapper.selectById(1);
System.out.println(user.getUsername());
System.out.println(user.getPassword());

**代码解释：**
- 通过 `userMapper.selectById(1)` 方法可以查询指定id的用户信息。
- 查询结果将会打印该用户的用户名和密码。

#### 3.4 更新数据

更新数据操作如下所示：

// 查询id为1的用户
User user = userMapper.selectById(1);
// 修改用户密码
user.setPassword("654321");
// 更新数据
userMapper.updateById(user);

**代码解释：**
- 首先通过 `userMapper.selectById(1)` 方法查询id为1的用户信息。
- 然后修改用户的密码为“654321”。
- 最后通过 `userMapper.updateById(user)` 方法更新用户数据。

#### 3.5 删除数据

删除数据操作如下所示：

// 根据id删除用户
userMapper.deleteById(1);

**代码解释：**
- 通过 `userMapper.deleteById(1)` 方法可以删除id为1的用户数据。

以上就是 MyBatisPlus 中的 CRUD 操作示例，包括数据表的创建、数据的插入、查询、更新和删除操作。

# 4. 高级查询与条件构造器

在本章中，我们将介绍如何使用MyBatisPlus进行高级查询和条件构造，包括使用Wrapper构造查询条件、分页查询、排序查询、统计查询以及嵌套查询与关联查询的使用方法。

#### 4.1 使用Wrapper构造查询条件

MyBatisPlus提供了Wrapper类来帮助我们构造查询条件，其中包括QueryWrapper和UpdateWrapper。QueryWrapper用于构造查询条件，UpdateWrapper用于构造更新条件。

// 使用QueryWrapper构造查询条件
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.eq("age", 18)  // 相等条件
            .like("name", "Tom")  // 模糊查询条件
            .between("create_time", "2022-01-01", "2022-12-31")  // 范围查询条件
            // 其他条件...

List<User> userList = userMapper.selectList(queryWrapper);

#### 4.2 分页查询

MyBatisPlus封装了分页查询的功能，我们可以使用Page类进行分页查询。

// 执行分页查询
IPage<User> page = new Page<>(1, 10);  // 查询第1页，每页显示10条记录
IPage<User> userPage = userMapper.selectPage(page, null);

// 获取分页查询结果
List<User> records = userPage.getRecords();  // 分页数据
long total = userPage.getTotal();  // 总记录数

#### 4.3 排序查询

在MyBatisPlus中，我们可以使用orderBy方法来设置排序条件。

// 设置排序查询条件
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.orderByDesc("create_time");  // 按照创建时间降序排序

List<User> userList = userMapper.selectList(queryWrapper);

#### 4.4 统计查询

MyBatisPlus提供了lambda表达式方式来进行统计查询。

// 统计查询
int count = userMapper.selectCount(null);  // 查询总记录数
int ageAvg = userMapper.selectAvg(User::getAge);  // 查询年龄平均值
int ageMax = userMapper.selectMax(User::getAge);  // 查询年龄最大值
int ageMin = userMapper.selectMin(User::getAge);  // 查询年龄最小值

#### 4.5 嵌套查询与关联查询

在MyBatisPlus中，我们可以使用嵌套查询和关联查询来实现多表之间的数据查询。

// 嵌套查询
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.inSql("dept_id", "select id from department where name like '%技术%'");  // 使用子查询

List<User> userList = userMapper.selectList(queryWrapper);

// 关联查询
@TableName("user")
public class User {
    @TableField(exist = false)
    private Department department;  // 关联部门实体类
}

@TableName("department")
public class Department {
    // 部门表字段
}

以上就是高级查询与条件构造器的基本用法，通过这些功能，我们可以实现复杂的数据查询与处理。

# 5. 事务管理与批量操作
在实际的应用场景中，我们经常会需要对数据库进行事务管理以确保数据的一致性和完整性。此外，批量操作也是我们常常需要用到的功能。本章将介绍如何使用MyBatisPlus进行事务管理和批量操作。

### 5.1 事务的基本概念与使用

#### 5.1.1 事务的概念
事务是指数据库管理系统进行数据处理的基本单位，它是由一个或多个SQL语句组成的逻辑操作单元。事务具备以下四个特性，通常称为ACID特性：
- 原子性（Atomicity）：事务是一个不可分割的工作单位，要么全部执行成功，要么全部失败回滚。
- 一致性（Consistency）：事务执行前后，数据库的完整性约束没有被破坏。
- 隔离性（Isolation）：多个事务并发执行时，一个事务的执行不会影响其他事务的执行。
- 持久性（Durability）：一个事务成功提交后，对数据库的修改将永久保存。

#### 5.1.2 事务管理
在MyBatisPlus中，事务的管理主要通过注解的方式来实现。可以使用`@Transactional`注解在方法上标记需要进行事务管理的方法。通过`rollbackFor`属性可以指定事务需要回滚的异常类型。

##### 示例代码：

@Service
public class UserServiceImpl implements UserService {
    @Autowired
    private UserMapper userMapper;
    @Transactional(rollbackFor = Exception.class)
    @Override
    public void updateUser(User user) {
        userMapper.updateById(user);
        // 执行其他操作...
    }
}

在上述示例中，`@Transactional`注解标记的`updateUser`方法将被自动包装成一个事务，如果方法中抛出了异常，事务将回滚。

### 5.2 批量插入
批量插入是一种高效的方式来向数据库中插入大量数据。在MyBatisPlus中，我们可以使用`saveBatch`方法来实现批量插入。

#### 5.2.1 使用saveBatch方法
##### 示例代码：

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public void batchInsert(List<User> userList) {
        userMapper.saveBatch(userList);
    }
}

以上示例中，`batchInsert`方法将一个用户列表作为参数，调用`saveBatch`方法实现批量插入。

### 5.3 批量更新
与批量插入类似，批量更新也是一种高效的方式来更新大量数据。在MyBatisPlus中，我们可以使用`updateBatchById`方法来实现批量更新。

#### 5.3.1 使用updateBatchById方法
##### 示例代码：

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public void batchUpdate(List<User> userList) {
        userMapper.updateBatchById(userList);
    }
}

以上示例中，`batchUpdate`方法将一个用户列表作为参数，调用`updateBatchById`方法实现批量更新。

### 5.4 批量删除
批量删除可以一次性删除多条数据，提高数据库操作的效率。在MyBatisPlus中，我们可以使用`removeByIds`方法来实现批量删除。

#### 5.4.1 使用removeByIds方法
##### 示例代码：

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public void batchDelete(List<Long> userIds) {
        userMapper.removeByIds(userIds);
    }
}

以上示例中，`batchDelete`方法将一个用户ID列表作为参数，调用`removeByIds`方法实现批量删除。

通过上述示例，我们可以看到MyBatisPlus提供了方便的批量操作方法，可以简化我们对数据库的操作。

本章介绍了如何使用MyBatisPlus进行事务管理和批量操作。通过使用事务管理，可以保证数据库操作的一致性和完整性；而批量操作可以提高数据库操作的效率，特别是在处理大量数据时。接下来的章节将介绍MyBatisPlus的附加功能与插件的使用。

# 6. 附加功能与插件

在本章中，我们将介绍MyBatisPlus提供的一些附加功能和插件，这些功能和插件能够帮助我们更好地利用MyBatisPlus进行开发，提高开发效率和代码质量。

### 6.1 逻辑删除

逻辑删除是指通过修改标识符或者状态来达到"删除"数据库中数据的目的，而不是真正地将数据从数据库中删除。MyBatisPlus提供了对逻辑删除的支持，可以通过简单的配置，使得对被逻辑删除的数据进行筛选时与普通删除无异，从而满足很多业务场景的需求。

// 实体类中加上逻辑删除注解
@TableName(value = "user", keepGlobalPrefix = true)
public class User implements Serializable {
    private Long id;
    private String name;
    private Integer age;
    @TableLogic
    private Integer deleted;
}

### 6.2 自动填充（字段赋值、时间戳）

MyBatisPlus还提供了自动填充的功能，可以在插入或更新数据时自动填充特定字段，比如创建时间、更新时间等。在实体类中使用注解指定需要自动填充的字段，并编写对应的处理器即可实现这一功能。

public class MyMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        this.strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

### 6.3 乐观锁

在高并发的情况下，为了避免数据被不同线程同时修改而导致数据错误，MyBatisPlus提供了乐观锁的支持。通过在实体类字段上添加乐观锁注解，可以实现在更新数据时进行版本号的控制，并且MyBatisPlus会自动处理乐观锁的校验和更新。

public class User {
    @Version
    private Integer version;
}

### 6.4 动态表名与分表分库

MyBatisPlus支持动态表名的操作，可以根据具体的业务场景，在运行时动态确定要操作的表名。同时，MyBatisPlus也支持分表分库的功能，可以通过配置路由策略，实现数据的分片存储和读取，以提高数据库的并发处理能力。

### 6.5 MyBatisPlus插件的使用与扩展

除了上述功能外，MyBatisPlus还支持插件的使用与扩展。可以根据具体需求编写自定义的插件，来扩展MyBatisPlus的功能，比如自定义的查询解析器、SQL拦截器、性能分析插件等。通过插件的使用与扩展，可以更加灵活地定制MyBatisPlus的行为，满足特定的业务需求。

在这一章节中，我们介绍了MyBatisPlus提供的一些附加功能和插件，这些功能和插件对于开发实际项目非常有用，能够帮助我们更好地应对复杂的业务场景和提升开发效率。