PageHelper使用

1、引入jar包方式

jar包：

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

依赖包：

http://repo1.maven.org/maven2/com/github/jsqlparser/jsqlparser/0.9.5/

　2、使用Maven

在 pom.xml 中添加如下依赖：

...

    <dependency>

    <groupId>com.github.pagehelper</groupId>

    <artifactId>pagehelper</artifactId>

    <version>最新版本</version>

</dependency>

<dependency>

    <groupId>com.github.jsqlparser</groupId>

    <artifactId>jsqlparser</artifactId>

    <version>0.9.1</version>

</dependency>

...

特别注意，新版拦截器是com.github.pagehelper.PageInterceptor。com.github.pagehelper.PageHelper现在是一个特殊的dialect实现类，是分页插件的默认实现类，提供了和以前相同的用法。

...

<!--

    plugins在配置文件中的位置必须符合要求，否则会报错，顺序如下:

    properties?, settings?,

    typeAliases?, typeHandlers?,

    objectFactory?,objectWrapperFactory?,

    plugins?,

    environments?, databaseIdProvider?, mappers?--><plugins><!-- com.github.pagehelper为PageHelper类所在包名 --><plugin interceptor="com.github.pagehelper.PageHelper"><property name="dialect" value="mysql"/><!-- 该参数默认为false --><!-- 设置为true时，会将RowBounds第一个参数offset当成pageNum页码使用 --><!-- 和startPage中的pageNum效果一样--><property name="offsetAsPageNum" value="true"/><!-- 该参数默认为false --><!-- 设置为true时，使用RowBounds分页会进行count查询 --><property name="rowBoundsWithCount" value="true"/><!-- 设置为true时，如果pageSize=0或者RowBounds.limit = 0就会查询出全部的结果 --><!-- （相当于没有执行分页查询，但是返回结果仍然是Page类型）--><property name="pageSizeZero" value="true"/><!-- 3.3.0版本可用 - 分页参数合理化，默认false禁用 --><!-- 启用合理化时，如果pageNum<1会查询第一页，如果pageNum>pages会查询最后一页 --><!-- 禁用合理化时，如果pageNum<1或pageNum>pages会返回空数据 --><property name="reasonable" value="true"/></plugin></plugins>

...

mybatis分页插件的配置可以在mybaits的配置文件进行配置，也可以在spring的配置文件中进行配置，两者配置其一即可

上面是 PageHelper 官方给的配置和注释，虽然写的很多，不过确实描述的很明白。

dialect ：标识是哪一种数据库，设计上必须。offsetAsPageNum ：将 RowBounds 第一个参数 offset 当成 pageNum 页码使用rowBoundsWithCount ：设置为 true 时，使用 RowBounds 分页会进行 count 查询reasonable ： value=true 时， pageNum 小于1会查询第一页，如果 pageNum 大于 pageSize 会查询最后一页

注：上面的配置只针对于pagehelper4.x版本的，如果你用的是pagehelper5.x版本就要这样配置，注意两个spring配置中的类名不同

1. 在 MyBatis 配置 xml 中配置拦截器插件

2. 在 Spring 配置文件中配置拦截器插件

如果4.x的版本用了5.x的版本报错信息如下springboot 在启动项目的时候就会报错,报错信息有很多，主要是因为

总的来说就是缺少了 com.github.pagehelper.PageInterceptor ,这个是新版拦截器，5.x版本才开始使用，所以在4.x版本这样配置是不行的

那么5.x版本的配置在pagehelper4.x上能生效吗？答案是不行 报错信息如下

新版的拦截器PageInterceptor不能和旧版拦截器相互转换，所以还是不行的。

总的来说，pagehelper4.x就该用4.x的配置，pagehelper5.x就用5.x的配置(官方推荐)

使用mybatis的分页插件时报错： net.sf.jsqlparser.statement.select.PlainSelect.getGroupBy()Lnet/sf/jsqlparse

原因：在使用mybatis分页插件时，需要依赖 jsqlparser

PageHelper的 不同版本依赖不同 的jsqlparser版本

pageHelper4.x依赖版本 jsqlparser-1.3.jar

在配置完mybatis后，pagehelper的业务用法，就以分页查询用户列表为例

添加查询所以用户的 mapper 接口

重点来了，然后在 service 中, 先开启分页 ， 再进行查询 ，然后把查询结果集放入 PageInfo 中

PageHelper.startPage(pageNum, pageSize) 这句非常重要，这段代码表示分页的开始，意思是从第 pageNum 页开始，每页显示 pageSize 条记录。

PageInfo 这个类是插件里的类，这个类里面的属性会在输出结果中显示, 使用 PageInfo 这个类,你需要将查询出来的 list 放进去:

PageHelper输出的数据结构

然后在 controller 层调用该方法设置对应的 pageNum 和 pageSize 就可以了，我设置 pageNum 为1,pageSize 为5，看个输出结果吧

PageInfo这个类里面的属性:

pageNum 当前页

pageSize 每页的数量

size 当前页的数量

orderBy 排序

startRow 当前页面第一个元素在数据库中的行号

endRow 当前页面最后一个元素在数据库中的行号

total 总记录数(所有符合条件的数据总数)

pages 总页数 (这个页数也很好算，每页5条，总共有11条，需要3页才可以显示完)

list 结果集

prePage 前一页

nextPage 下一页

isFirstPage 是否为第一页

isLastPage 是否为最后一页

hasPreviousPage 是否有前一页

hasNextPage 是否有下一页

navigatePages 导航页码数

navigatepageNums 所有导航页号

navigateFirstPage 导航第一页

navigateLastPage 导航最后一页

firstPage 第一页

lastPage 最后一页

---