首页 > 软件编程 > java > MyBatis进行分页查询

在MyBatis中进行分页查询的两种方法详解

2025-11-17 09:23:06 作者：java1234_小锋

在 MyBatis 中进行分页查询通常有两种方法：一种是通过手动拼接 LIMIT 和 OFFSET,另一种是使用 MyBatis 插件（如 MyBatis-PageHelper）来自动处理分页逻辑,下面分别介绍这两种方法,需要的朋友可以参考下

如何在MyBatis中进行分页查询？

在 MyBatis 中进行分页查询通常有两种方法：一种是通过手动拼接 LIMIT 和 OFFSET，另一种是使用 MyBatis 插件（如 MyBatis-PageHelper）来自动处理分页逻辑。下面分别介绍这两种方法。

1.手动实现分页查询

手动分页查询需要在 SQL 语句中使用数据库支持的分页语法，如 LIMIT（MySQL、PostgreSQL）或 ROWNUM（Oracle）等。你可以通过传递 offset（起始行）和 limit（每页的条目数）来实现分页。

1.1 修改 Mapper XML 文件

在 XML 文件中，通常通过传递 offset 和 limit 参数来构造分页查询 SQL。

Mapper 接口：

public interface UserMapper {
    List<User> selectUsersByPage(@Param("offset") int offset, @Param("limit") int limit);
}

Mapper XML 文件：

<mapper namespace="com.example.UserMapper">
    <select id="selectUsersByPage" resultType="com.example.User">
        SELECT * FROM users
        LIMIT #{limit} OFFSET #{offset}
    </select>
</mapper>

1.2 计算offset

通常，offset 的计算方式是 (currentPage - 1) * pageSize，其中：

currentPage 是当前页码（从 1 开始）。
pageSize 是每页显示的记录数。

调用分页查询：

int currentPage = 1; // 当前页
int pageSize = 10;   // 每页的条数
int offset = (currentPage - 1) * pageSize;

List<User> users = userMapper.selectUsersByPage(offset, pageSize);

2.使用 MyBatis 插件（如 PageHelper）进行分页

如果你不想手动编写分页逻辑，可以使用第三方分页插件，如 PageHelper，它可以自动处理分页，简化分页操作。

2.1 引入 PageHelper 插件

在 pom.xml 中添加 PageHelper 的依赖。

<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>5.2.0</version> <!-- 确保使用最新版本 -->
</dependency>

2.2 配置 PageHelper 插件

在 MyBatis 的配置文件 mybatis-config.xml 中配置 PageHelper 插件。

<plugins>
    <plugin interceptor="com.github.pagehelper.PageInterceptor">
        <property name="helperDialect" value="mysql"/> <!-- 针对 MySQL -->
        <property name="reasonable" value="true"/>
        <property name="supportMethodsArguments" value="true"/>
    </plugin>
</plugins>

2.3 使用 PageHelper 进行分页查询

PageHelper 插件通过 PageHelper.startPage(pageNum, pageSize) 来启用分页。分页的实际 SQL 会在查询时动态生成。