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

一、引入PageHelper分页插件

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

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

     
             
      
       com.github.pagehelper
              
      
       pagehelper-spring-boot-starter
              
      
       1.2.10
      
     

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

二、配置application.yml

# 分页配置

1 pagehelper:2   helper-dialect: mysql3   reasonable: true4   support-methods-arguments: true5   params: count=countSql

改代码不加入，程序也可以正常运行，请根据实际情况进行添加。

三、在service层中使用PageHelper插件

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

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

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

（2）EasyUI为例

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

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

　　EasyUIDataGrid.java：

1 package com.sun123.springboot.entity.easyui; 2  3 import java.util.List; 4  5 public class EasyUIDataGrid { 6     //当前页显示的数据  ?表示任意类型 7     private List
      rows; 8     //表中总个数，不是总页数 9     private long total;10 11     public List
      getRows() {12         return rows;13     }14 15     public void setRows(List
      rows) {16         this.rows = rows;17     }18 19     public long getTotal() {20         return total;21     }22 23     public void setTotal(long total) {24         this.total = total;25     }26 }

　　UserService.java：

1     //查询所有学生信息2     EasyUIDataGrid showAllStudents(int page, int rows);

　　UserServiceImpl.java：

1     public EasyUIDataGrid showAllStudents(int page, int rows) {2         EasyUIDataGrid dataGrid = new EasyUIDataGrid();3         Page pages = PageHelper.startPage(page,rows);4         List
     
       userList = userMapper.selectByExample(null);5         dataGrid.setRows(userList);6         dataGrid.setTotal(pages.getTotal());7         return dataGrid;8     }
     

　　AdminController.java：

1     @PostMapping("/showAllStudents")2     @ResponseBody3     public EasyUIDataGrid showAllStudent(int page, int rows){4         EasyUIDataGrid dataGrid = userService.showAllStudents(page, rows);5         return dataGrid;6     }

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

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

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

 

参考：https://www.neilren.com/Article/1003276