SpringBoot 使用 MyBatis 分页插件 PageHelper 进行分页查询

前言：本文档使用的是 SpringBoot，如果是 Spring 还需要在 MyBatis 配置 xml 中配置拦截器，并且 PageHelper 是针对 MyBatis 的，MyBatis 的集成不在本文档中叙述，请先集成 MyBatis。

一、引入PageHelper分页插件

引入的方式有两种，可以是导入Jar包，也可以使用 Maven 来构建，本文档将使用 Maven 来构建项目，如果你希望使用导入Jar包的方式进行集成，请从下面的链接下载Jar包：

• https://oss.sonatype.org/content/repositories/releases/com/github/pagehelper/pagehelper/

• http://repo1.maven.org/maven2/com/github/pagehelper/pagehelper/

在 pox.xml 中添加PageHelper分页插件依赖

<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>1.2.5</version>
</dependency>

由于是SpringBoot项目，这里使用 pagehelper-spring-boot-starter ，如果是 spring 应使用 pagehelper

二、配置application.yml

# 分页配置

# 分页配置
pagehelper:
  helper-dialect: mysql
  reasonable: true
  support-methods-arguments: true
  params: count=countSql

三、在service层中使用PageHelper插件

最简单的分页查询，直接传入

public List<Article> selectArticleListByTag(TTag tag, int page, int rows) {
    //使用分页插件,核心代码就这一行，页数、每页行数
    PageHelper.startPage(page, rows);
    //在 mapper.xml 中不要加 limit 分页，插件会自动拦截和添加 limit 分页
    return articleMapper.selectArticleListByTag(tag);
}

分页的同时，获取总数量，从而计算总页数

由于我使用了EasyUI，DataGrid控件的分页需要返回总行数，所以拿来展示比较经典

先定义一个 Page 变量，这个类在com.github.pagehelper.Page，然后依然是 PageHelper.startPage(page, rows)，然后进行正常的查询，在查询后pages.getTotal()就可以获取到总行数了，拿到总行数，就可以计算出总页数

public void selectAllArticle(EasyuiDatagrid easyuiDatagrid, int page, int rows) {
    Page pages = PageHelper.startPage(page, rows);
    easyuiDatagrid.setRows(articleMapper.selectAllArticle());
    easyuiDatagrid.setTotal(pages.getTotal());
}

四、关于页数传入异常的情况

有同学会担心，如果传入的页数是负数或者大于总页数会不会报错？是否需要进行边界检查？

其实，如果传入的页数是负数，PageHelper 会展示第一页的数据；如果传入的页数大于总页数，PageHelper会展示最后一页的数据。并不会报错，所以使用这个插件比较省心，不用担心异常的页数传入导致业务抛出异常。

到目前为止，常规的需求已经可以满足你的需要了，如果你想进一步了解更多的使用方法，例如线程安全的调用等等可以参考官方文档：https://pagehelper.github.io/docs/