MyBatis-Plus实战：CRUD操作的基本使用

1. 简介

1.1 什么是MyBatis-Plus

MyBatis-Plus（以下简称MP）是一个基于MyBatis的增强工具，旨在简化MyBatis操作和提升开发效率。它在MyBatis的基础上进行了扩展，提供了许多实用的功能，如通用CRUD（增删改查）操作、分页查询、条件构造器等，可以极大地简化数据库操作的编写。同时，MP还提供了一些常用的工具类和注解，方便开发者使用。

1.2 为什么选择MyBatis-Plus

相比于原生的MyBatis，MyBatis-Plus具有以下几个优点：

- 简化开发：MP提供了丰富的增强功能，能够省去开发者重复编写重复的基础代码，使开发更高效。
- 提高效率：MP内置的CRUD操作、分页查询等功能，能够快速完成常见的数据库操作，提高开发效率。
- 易于使用：MP的API设计简洁明了，易于上手，降低学习成本。
- 功能丰富：MP不仅提供了基本的增删改查操作，还支持条件构造器、动态SQL等高级功能，能够满足复杂业务场景的需求。
- 可扩展性强：MP支持自定义插件，开发者可以根据业务需求进行功能扩展。

1.3 MyBatis-Plus的基本特性

MyBatis-Plus具有以下几个基本特性：

- 基于MyBatis：MyBatis-Plus是对MyBatis的增强工具，在保留MyBatis的基础上进行了扩展。
- 内置常用CRUD操作：MyBatis-Plus内置了通用的CRUD操作，无需手动编写SQL语句，能够快速完成数据库操作。
- 支持代码生成：MyBatis-Plus提供了代码生成器，能够根据数据库表结构自动生成实体类、Mapper接口等代码，减少手工编写的工作量。
- 提供丰富的查询功能：MyBatis-Plus支持条件构造器、Lambda表达式等方式进行高级查询，灵活且易于使用。
- 支持分页查询：MyBatis-Plus提供了便捷的分页查询方法，能够方便地进行分页操作。
- 提供性能优化：MyBatis-Plus针对分页查询进行了性能优化，能够提升查询效率。

2. 环境搭建

2.1 安装MyBatis-Plus

在使用MyBatis-Plus之前，需要先将其添加到项目的依赖中。可以使用Maven、Gradle等构建工具来管理依赖。

对于Maven项目，可以在`pom.xml`文件中添加如下依赖：

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

这里需要将`latest version`替换为最新版本号。

2.2 配置MyBatis-Plus

配置文件中需要添加MyBatis-Plus的相关配置。主要包括数据库连接信息、Mapper扫描路径等。

在Spring Boot项目中，可以在`application.properties`或`application.yml`文件中添加如下配置：

   spring:
     datasource:
       url: jdbc:mysql://localhost:3306/mybatis_plus_demo?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
       username: root
       password: password
     ## MyBatis-Plus配置
     mybatis-plus:
       ## Mapper扫描路径
       mapper-locations: classpath:mapper/*.xml
       ## 实体类扫描路径
       type-aliases-package: com.example.entity

这里需要根据实际情况修改数据库连接信息。

2.3 创建数据库和表

在使用MyBatis-Plus进行CRUD操作前，需要先创建数据库和相应的表。可以使用MySQL Workbench等数据库管理工具来创建。

假设我们创建了一个名为`mybatis_plus_demo`的数据库，其中包含一个名为`user`的表，表结构如下：

   CREATE TABLE `user` (
     `id` int(11) NOT NULL AUTO_INCREMENT,
     `name` varchar(255) NOT NULL,
     `age` int(11) NOT NULL,
     PRIMARY KEY (`id`)
   ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

### 3. CRUD操作入门

在本章节中，我们将介绍如何使用MyBatis-Plus进行CRUD操作。CRUD操作指的是创建(Create)、读取(Read)、更新(Update)和删除(Delete)数据的操作。

#### 3.1 创建实体类

首先，我们需要创建实体类来映射数据库中的表结构。假设我们有一个用户表，表结构如下：

CREATE TABLE user (
  id INT PRIMARY KEY AUTO_INCREMENT,
  username VARCHAR(50),
  age INT,
  email VARCHAR(100)
);

我们可以创建对应的实体类User：

public class User {
    private Long id;
    private String username;
    private Integer age;
    private String email;
    
    // 省略getter和setter方法
}

#### 3.2 创建Mapper接口

接下来，我们创建Mapper接口来定义对用户表的CRUD操作，这里使用MyBatis-Plus提供的BaseMapper接口，无需编写SQL语句，MyBatis-Plus会根据方法名自动生成对应的SQL。

public interface UserMapper extends BaseMapper<User> {
    // 这里无需编写任何方法，MyBatis-Plus会根据BaseMapper自动提供CRUD方法
}

#### 3.3 使用MyBatis-Plus进行CRUD操作

##### 3.3.1 新增数据

使用MyBatis-Plus进行新增数据操作非常简单，只需创建实体对象并调用BaseMapper的insert方法即可。

User user = new User();
user.setUsername("Alice");
user.setAge(25);
user.setEmail("alice@example.com");

userMapper.insert(user);

##### 3.3.2 查询数据

通过MyBatis-Plus进行查询操作也非常方便，只需调用BaseMapper的selectById或者selectList方法即可。

// 根据id查询用户
User userById = userMapper.selectById(1L);
System.out.println(userById);

// 查询所有用户
List<User> userList = userMapper.selectList(null);
userList.forEach(System.out::println);

##### 3.3.3 更新数据

更新数据同样简单，只需创建实体对象并调用BaseMapper的updateById方法即可。

User user = new User();
user.setId(1L);
user.setUsername("Bob");
userMapper.updateById(user);

##### 3.3.4 删除数据

删除数据也非常简单，只需调用BaseMapper的deleteById方法即可。

userMapper.deleteById(1L);

通过以上示例，我们可以看到使用MyBatis-Plus进行CRUD操作非常便捷，无需编写SQL语句，大大提高了开发效率。

## 4. 高级查询

在实际的开发中，除了简单的CRUD操作之外，我们经常需要进行更复杂的查询。MyBatis-Plus提供了一些强大的查询功能，帮助我们轻松实现高级查询需求。

### 4.1 条件构造器的使用

条件构造器是MyBatis-Plus中一个非常方便的功能，它可以帮助我们动态构建SQL查询条件。我们可以通过`QueryWrapper`、`UpdateWrapper`来创建条件构造器对象。

// 创建查询条件构造器对象
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
// 添加查询条件
queryWrapper.eq("age", 20).ne("sex", "男");
// 执行查询
List<User> userList = userDao.selectList(queryWrapper);

`eq`方法表示等于，默认使用`=`号，可以省略。`ne`方法表示不等于，使用`<>`符号。

### 4.2 Lambda表达式的使用

MyBatis-Plus还支持使用Lambda表达式来构建查询条件，让代码更加简洁和易读。

// 使用Lambda表达式构建查询条件
LambdaQueryWrapper<User> lambdaQueryWrapper = new LambdaQueryWrapper<>();
lambdaQueryWrapper.eq(User::getAge, 20).ne(User::getSex, "男");
// 执行查询
List<User> userList = userDao.selectList(lambdaQueryWrapper);

可以看到，使用Lambda表达式相比于条件构造器更加简洁和直观。通过`User::getAge`和`User::getSex`可以指定对应字段，并结合`eq`和`ne`方法构建查询条件。

### 4.3 动态SQL

在复杂的业务场景中，我们可能需要根据不同的条件进行动态的SQL拼装。MyBatis-Plus中使用XML标签来实现动态SQL的拼装。

#### 4.3.1 If标签

使用`<if>`标签可以根据条件判断动态拼装SQL语句。

<select id="getUserList" resultMap="BaseResultMap">
    SELECT * FROM user
    <where>
        <if test="name != null">
            AND name = #{name}
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
</select>

在上面的示例中，如果`name`和`age`参数不为空，则会根据该条件进行拼接。

#### 4.3.2 Choose、When、Otherwise标签

使用`<choose>`、`<when>`和`<otherwise>`标签可以实现条件选择。

<select id="getUserList" resultMap="BaseResultMap">
    SELECT * FROM user
    <where>
        <choose>
            <when test="name != null">
                AND name = #{name}
            </when>
            <when test="age != null">
                AND age = #{age}
            </when>
            <otherwise>
                AND status = 1
            </otherwise>
        </choose>
    </where>
</select>

在上面的示例中，如果`name`和`age`参数都为空，则会选择`<otherwise>`标签中的条件进行拼接。

#### 4.3.3 Trim、Where、Set标签

`<trim>`、`<where>`和`<set>`标签可以帮助我们动态地添加SQL的前缀和后缀。

<update id="updateUser" parameterType="User">
    UPDATE user
    <set>
        <trim prefix="SET" suffixOverrides=",">
            <if test="name != null">name=#{name},</if>
            <if test="age != null">age=#{age},</if>
        </trim>
    </set>
    WHERE id = #{id}
</update>

在上面的示例中，`<trim>`标签的`prefix`属性表示添加的前缀，`suffixOverrides`属性表示需要去除的后缀。

#### 4.3.4 Foreach标签

使用`<foreach>`标签可以实现循环遍历集合并动态拼接SQL语句。

<update id="updateBatch" parameterType="java.util.List">
    UPDATE user
    <trim prefix="SET" suffixOverrides=",">
        <foreach collection="list" item="item" separator=",">
            <if test="item.name != null">name=#{item.name},</if>
            <if test="item.age != null">age=#{item.age},</if>
        </foreach>
    </trim>
    WHERE id IN
    <foreach collection="list" item="item" separator="," open="(" close=")">
        #{item.id}
    </foreach>
</update>

在上面的示例中，`<foreach>`标签的`collection`属性表示需要遍历的集合，`item`属性表示遍历的元素，在循环中可以使用`item`来引用元素。

### 5. 分页查询

在实际开发中，分页查询是非常常见的需求，特别是在处理大量数据时。MyBatis-Plus提供了丰富的分页查询方法，可以轻松满足各种分页需求。

#### 5.1 分页查询的常用方法

MyBatis-Plus提供了一系列常用的分页查询方法，比如`selectPage`、`selectMapsPage`、`selectMaps`等，这些方法可以满足大部分的分页需求。接下来，我们将详细介绍这些方法的使用。

#### 5.2 自定义分页查询方法

除了使用MyBatis-Plus提供的常用分页查询方法外，我们还可以通过自定义分页查询方法来满足特定的分页需求。比如，可以在自定义方法中添加一些特定的条件，或者对查询结果进行特殊处理。

#### 5.3 分页查询的性能优化

在进行分页查询时，尤其是处理大量数据时，性能往往是一个不可忽视的问题。MyBatis-Plus提供了一些性能优化的方案，比如合理利用索引、适当调整分页大小等，来提升分页查询的性能。

## 6. 总结与展望

### 6.1 MyBatis-Plus的优点与不足

#### 6.1.1 优点

- 简化开发：MyBatis-Plus提供了很多便捷的方法，简化了对数据库的CRUD操作，减少了开发人员的编码工作量。
- 高度灵活：MyBatis-Plus支持动态SQL、条件构造器、Lambda表达式等高级查询方式，使得查询操作更加灵活、方便。
- 提高性能：MyBatis-Plus优化了查询性能，尤其是在分页查询和批量更新操作方面表现突出。
- 易于集成：MyBatis-Plus与MyBatis框架完美融合，使用起来非常方便，可以根据项目需要进行灵活配置。

#### 6.1.2 不足

- 学习成本：虽然MyBatis-Plus相对于MyBatis来说更加简洁易用，但是作为一个新的框架，需要一定的时间来学习和掌握。
- 可能限制灵活性：由于MyBatis-Plus封装了一些操作，可能会导致一些特殊需求无法直接使用，需要额外扩展或调整。

### 6.2 使用MyBatis-Plus的心得体会

在使用MyBatis-Plus进行开发的过程中，我深刻感受到了它的便利性和高效性。通过简洁的代码，我能够快速完成数据库的增删改查操作，同时也能够使用高级查询功能满足复杂的查询需求。

MyBatis-Plus提供了丰富的扩展功能，例如条件构造器、Lambda表达式和动态SQL等，使得查询操作更加灵活方便。同时，它还支持自定义分页查询以及性能优化，大大提高了开发效率和查询性能。

虽然在初期学习和使用的过程中可能会遇到一些困难，但通过官方文档和丰富的社区资源，我能够快速解决问题，并且逐渐掌握了MyBatis-Plus的使用技巧。

### 6.3 对MyBatis-Plus未来发展的展望

作为目前非常流行的数据库持久层框架，我对MyBatis-Plus的未来发展充满期待。以下是我对MyBatis-Plus未来发展的几点展望：

- 更加完善的文档和教程：希望MyBatis-Plus能够提供更加完善的文档和教程，方便开发者学习和使用。
- 更多的扩展插件：期待MyBatis-Plus能够提供更多的扩展插件，满足不同场景下的需求。
- 更好的性能优化：希望MyBatis-Plus能够持续改进性能优化方面的功能，提供更好的查询性能。