再议分页插件PageHelper

1、问题描述

java分页以前介绍过pagehelper，最近项目中又用到分页，看了下，发现使用springboot下使用起来更加方便了，又系统看了看，分享下，希望能帮到有需要的朋友。

2、解决方案

2.1 官方文档

还是那句话，官方文档才是yyds，地址：https://github.com/pagehelper

第一个mybatis-pagehelper是源码实现，第二个springboot的是对第一个做了封装。

目前springboot下最新的pagehelper版本是：1.3.1

2.2 具体配置与使用

因为老王的代码是公司电脑上，复制不出来，本地简单弄了个案例说明下。

springboot下使用pagehelper更加方便了，只需要配置两个地方就可以了

2.2.1 pom文件

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

有了springboot下的pagehelper的gav，就不需要mybatis的gav了，pagehelper的gav中已经包含mybatis的gav了。

2.2.2 yml文件配置下

pagehelper:
  helper-dialect: mysql
  reasonable: true
  support-methods-arguments: true
  params: count=countSql

主要是配置下helper-dialect，这里是根据不同的配置，会使用不同的方言。

2.2.3 代码中运用

        Page<TLaowang> page = PageHelper.startPage(info.getPageNum(), info.getPageSize());
        List<TLaowang> list = tLaowangMapper.selectAll();

通过在待执行的mybatis的mppper前设置page，就可以达到分页的目的了。

2.2.4 重要提示

这里提到官网有个重要提示：

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

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

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

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

很重要的一点PageHelper.startPage要紧挨mybatis执行方法，网上查的原因，不保证真的准确。

 PageHelper方法使用了静态的ThreadLocal参数，分页参数和线程是绑定的。内部流程是ThreadLocal中设置了分页参数（pageIndex，pageSize），之后在查询执行的时候，获取当线程中的分页参数，执行查询的时候通过拦截器在sql语句中添加分页参数，之后实现分页查询，查询结束后在 finally 语句中清除ThreadLocal中的查询参数

源码：

3、代码验证

3.1 分层代码

（1）cotroller

    @RequestMapping(value ="/selectAll", method = RequestMethod.POST)
    public  Object select(LPageInfo info) {
        return testService.selectAll(info);
    }

（2）service

    public  List<TLaowang> selectAll(LPageInfo info) {
        Page<TLaowang> page = PageHelper.startPage(info.getPageNum(), info.getPageSize());
        List<TLaowang> list = tLaowangMapper.selectAll();
//        PageInfo pageInfo = new PageInfo(list);
//        System.out.println(pageInfo.getTotal());
        System.out.println(page.getTotal());
        return list;
    }

简要说明：

这里两个说明，一是tLaowangMapper要紧跟PageHelper；二是total页码，可以通过page获取，也可以通过PageInfo获取，另外会出现跨service获取total页码丢失的情况，要特别注意位置问题。

（3）mapper

  <select id="selectAll" resultMap="BaseResultMap">
    select
    <include refid="Base_Column_List" />
    from t_laowang
  </select>

（4）测试数据

3.2 执行效果

3.2.1 swagger执行

pagenum=3，pagesize=3

3.2.2 debug看效果

从debug效果看，list已经是page类型了，返回3条数据，数据是从第7条到第9条，total是9条。

3.2.3 通过idea插件mybatis-log查看数据库执行sql

说明：

（1）从图中不难看出，pagehelper执行了两条sql，一条获取total总数，二是调用mysql的分页语句进行分页。

mysql分页语句：

select * from table limit (start-1)*pageSize,pageSize; 
其中start是页码，pageSize是每页显示的条数。

查询第1条到第10条的数据的sql是：select * from table limit 0,10;  
->对应我们的需求就是查询第一页的数据：select * from table limit (1-1)*10,10;
例如：select * from table limit 0,10;  --从第0条开始，查询10条数据。
     select * from table limit 10,10;  --从第10条开始，查询10条数据。

（2）分页pagenum是从1开始的。

4、总结

简单来说，pagehelper是通过封装拦截，将分页拼接到待执行sql中，起到分页的效果，底层还是使用的对应数据的分页语句，因为不同的数据库分页语句不一样，所以才需要配置数据库类型，拼接不同的分页语句到待执行sql中去。

---

更多信息请关注公众号：「软件老王」，关注不迷路，软件老王和他的IT朋友们，分享一些他们的技术见解和生活故事。