MyBatis之使用pageHelper插件进行分页查询

1. 分页查询原理

我们在使用SQL对数据进行分页查询时，往往使用Limit语句：

SELECT * FROM #{表名} LIMIT #{startIndex}, #{pageSize};

我们在使用分页查询时，只需要将#{startIndex}和#{pageSize}作为参数传入即可。

PageHelper就帮助我们做了这件事，如何使用PageHelper呢？

2. 引入PageHelper

推荐使用maven引入，在pom.xml中添加如下依赖：

<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>最新版本</version>
</dependency>

3. 重要提示

3.1. PageHelper.startPage方法重要提示

只有紧跟在PageHelper.startPage方法后的第一个Mybatis的**查询（Select）**方法会被分页。

3.2. 请不要配置多个分页插件

请不要在系统中配置多个分页插件(使用Spring时,mybatis-config.xml和Spring<bean>配置方式，请选择其中一种，不要同时配置多个分页插件)！

3.3. 分页插件不支持带有for update语句的分页

对于带有for update的sql，会抛出运行时异常，对于这样的sql建议手动分页，毕竟这样的sql需要重视。

3.4. 分页插件不支持嵌套结果映射

由于嵌套结果方式会导致结果集被折叠，因此分页查询的结果在折叠后总数会减少，所以无法保证分页结果数量正确。

4. 使用PageHelper

推荐使用调用Mapper接口的方式进行分页查询

在service层中，使用如下语句：

PageHelper.startPage(currentPage, pageSize);
List<XXXDO> doList = XXXDAO.getXXX(); // DAO层查询数据
PageInfo<XXXDO> pageInfo = new PageInfo<>(doList);

只需要在DAO层查询数据之前，将当前页和页大小作为参数传入PageHelper的startPage方法即可。

在DAO层，我们往往使用tkMapper来查询数据，关于tkMapper的使用可以参考另一篇文章：使用tkMapper进行增删改查；

根据分页信息查询到list后，使用PageInfo方法将其封装，PageInfo包含了非常全面的分页属性。

5. PageHelper官方文档

更多内容，可参考PageHelper官方文档；