MyBatis 中如何使用分页
在实际的项目开发中，我们经常需要对数据库中的数据进行分页查询，以提高数据查询的效率和用户体验。MyBatis 是一种流行的 Java 持久层框架，它提供了多种分页查询的方式，本文将介绍其中常用的两种方式：基于 ROW_NUMBER() 函数和基于 LIMIT 和 OFFSET 关键字。
基于 ROW_NUMBER() 函数的分页查询
ROW_NUMBER() 函数是一种用于生成行号的窗口函数，它可以在查询结果中为每一行生成一个递增的行号。基于 ROW_NUMBER() 函数的分页查询可以通过以下步骤实现：
- 编写 SQL 语句，使用 ROW_NUMBER() 函数为每一行数据生成一个行号，并根据行号进行排序。
SELECT * FROM (
SELECT ROW_NUMBER() OVER (ORDER BY id ASC) AS row_num, *
FROM user
) AS temp
WHERE row_num BETWEEN #{start} AND #{end}
在上面的 SQL 语句中，我们使用 ROW_NUMBER() 函数为 user 表中的每一行数据生成一个行号，并按照 id 升序排列。然后，我们将这个 SQL 语句作为一个子查询，将其结果作为临时的表格，并在外部的查询中使用 WHERE 子句筛选出指定的行号范围。
- 在 Mapper 接口中定义一个方法，使用 @Select 注解将 SQL 语句与方法绑定，并使用 @Param 注解指定方法参数的名称。
public interface UserMapper {
@Select("SELECT * FROM ( " +
"SELECT ROW_NUMBER() OVER (ORDER BY id ASC) AS row_num, * " +
"FROM user " +
") AS temp " +
"WHERE row_num BETWEEN #{start} AND #{end}")
List<User> selectUserByRowNum(@Param("start") int start, @Param("end") int end);
}
在上面的代码中，我们使用 @Select 注解将 SQL 语句与 selectUserByRowNum() 方法绑定，并使用 @Param 注解指定方法参数的名称。注意，这里的方法参数名必须与 SQL 语句中的参数名一致。
- 在 Service 层中调用 Mapper 接口中定义的方法，并传入分页查询所需的参数。
int pageSize = 10;
int pageNum = 1;
List<User> users = userMapper.selectUserByRowNum((pageNum - 1) * pageSize + 1, pageNum * pageSize);
在上面的代码中，我们定义了每页显示的数据条数和当前页码，并根据这些参数计算出分页查询所需的起始行和结束行。然后，我们调用 Mapper 接口中定义的 selectUserByRowNum() 方法，并传入计算出的起始行和结束行作为方法参数。最后，我们将查询结果保存在一个 List 中。
基于 LIMIT 和 OFFSET 关键字的分页查询
MySQL 和 PostgreSQL 数据库都支持使用 LIMIT 和 OFFSET 关键字进行分页查询。基于 LIMIT 和 OFFSET 关键字的分页查询可以通过以下步骤实现：
- 编写 SQL 语句，使用 LIMIT 和 OFFSET 关键字指定查询结果的起始行和数据条数。
SELECT * FROM user LIMIT #{pageSize} OFFSET #{offset}
在上面的 SQL 语句中，我们使用 LIMIT 关键字指定查询结果的数据条数，使用 OFFSET 关键字指定查询结果的起始行。
- 在 Mapper 接口中定义一个方法，使用 @Select 注解将 SQL 语句与方法绑定，并使用 @Param 注解指定方法参数的名称。
public interface UserMapper {
@Select("SELECT * FROM user LIMIT #{pageSize} OFFSET #{offset}")
List<User> selectUserByLimitAndOffset(@Param("pageSize") int pageSize, @Param("offset") int offset);
}
在上面的代码中，我们使用 @Select 注解将 SQL 语句与 selectUserByLimitAndOffset() 方法绑定，并使用 @Param 注解指定方法参数的名称。注意，这里的方法参数名必须与 SQL 语句中的参数名一致。
- 在 Service 层中调用 Mapper 接口中定义的方法，并传入分页查询所需的参数。
int pageSize = 10;
int pageNum = 1;
int offset = (pageNum - 1) * pageSize;
List<User> users = userMapper.selectUserByLimitAndOffset(pageSize, offset);
在上面的代码中，我们定义了每页显示的数据条数和当前页码，并根据这些参数计算出分页查询所需的偏移量。然后，我们调用 Mapper 接口中定义的 selectUserByLimitAndOffset() 方法，并传入计算出的每页显示的数据条数和偏移量作为方法参数。最后，我们将查询结果保存在一个 List 中。
MyBatis 使用分页插件
MyBatis 还提供了一种方便的方式实现分页查询，即使用分页插件。分页插件可以在运行时自动拦截需要进行分页查询的 SQL 语句，并根据指定的分页参数对查询结果进行分页处理。
使用 MyBatis 分页插件可以通过以下步骤实现：
- 在 pom.xml 文件中添加 MyBatis 分页插件的依赖。
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
<version>5.2.1</version>
</dependency>
- 在 MyBatis 的配置文件中配置分页插件。
<plugins>
<plugin interceptor="com.github.pagehelper.PageInterceptor">
<property name="helperDialect" value="mysql"/>
</plugin>
</plugins>
在上面的配置中，我们使用 PageInterceptor 插件作为分页拦截器，并指定了数据库类型为 MySQL。
- 在 Mapper 接口中定义一个方法，使用 @Select 注解将 SQL 语句与方法绑定，并使用 PageHelper.startPage() 方法指定分页参数。
public interface UserMapper {
@Select("SELECT * FROM user")
List<User> selectAllUsers();
}
在上面的代码中，我们定义了一个 selectAllUsers() 方法，使用 @Select 注解将 SQL 语句与方法绑定。注意，这里没有指定分页参数。
- 在 Service 层中调用 Mapper 接口中定义的方法，并使用 PageHelper.startPage() 方法指定分页参数。
int pageSize = 10;
int pageNum = 1;
PageHelper.startPage(pageNum, pageSize);
List<User> users = userMapper.selectAllUsers();
在上面的代码中，我们使用 PageHelper.startPage() 方法指定分页参数，并调用 Mapper 接口中定义的 selectAllUsers() 方法。PageHelper.startPage() 方法会自动拦截后续的 SQL 语句，并根据指定的分页参数进行分页处理。最后，我们将查询结果保存在一个 List 中。
总结
本文介绍了 MyBatis 中两种常用的分页查询方式：基于 ROW_NUMBER() 函数和基于 LIMIT 和 OFFSET 关键字。此外，还介绍了使用 MyBatis 分页插件实现分页查询的方法。无论使用哪种方式，都需要注意 SQL 语句的正确性和性能问题，并及时释放资源，以避免出现内存泄漏和资源浪费等问题。
