pageHelper分页及工作原理浅析

1、pageHelper

PageHelper是Github上开源的MyBatis分页插件，使用起来简单、方便，支持多种数据库。

Github网址：
https://github.com/pagehelper/Mybatis-PageHelper/blob/master/README_zh.md。

maven:

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

2、配置

在项目配置文件application.properties中配置pagehelper的方言
例如配置为mysql：
pagehelper.helper-dialect=mysql

配置时，可以使用下面的缩写值：

oracle,mysql,mariadb,sqlite,hsqldb,postgresql,db2,sqlserver,informix,h2,sqlserver2012,derby

特别注意：使用 SqlServer2012 数据库时，需要手动指定为 sqlserver2012，否则会使用 SqlServer2005 的方式进行分页。

ps: 我什么都没有配置也没发现什么问题。。。

3、使用方法

pageHelper的使用非常简单，只需要在分页查询逻辑前添加一行代码即可，代码：

PageHelper.startPage(pageNum, pageSize);

// pageNum：页数（第几页）

// pageSize：每页的数据行数

例如：

4、工作原理

1. 使用PageHelper.startPage时在当前线程上下文中设置一个ThreadLocal变量
2. 在 ThreadLocal中设置了分页参数，之后在查询执行的时候，获取当前线程中的分页参数
3. 执行查询的时候通过拦截器在sql语句中添加分页参数，之后实现分页查询，查询结束后在 finally 语句中清除ThreadLocal中的查询参数

PageHelper方法使用了静态的ThreadLocal参数，分页参数和线程是绑定的。只要可以保证在PageHelper方法调用后紧跟 MyBatis 查询方法，这就是安全的。因为PageHelper在finally代码段中自动清除了ThreadLocal存储的对象。

下面这样的代码，就是不安全的用法：

PageHelper.startPage(1,10);
Listlist;
if(param1!=null){   
    list=countryMapper.selectIf(param1);
} else { 
  // 如果程序走到这个逻辑分支，程序中当前的分页参数无法清除 
  list=newArrayList();
}

应该改写为：

List list;
if(param1!=null) {
	PageHelper.startPage(1,10);   
	list=countryMapper.selectIf(param1);
} else {    
	list=newArrayList();
}

参考：https://baijiahao.baidu.com/s?id=1645186885613613303&wfr=spider&for=pc
https://blog.csdn.net/qq_35915384/article/details/80203003
https://www.jianshu.com/p/ab9703237a44