alvinfox/Mybatis-PageHelper

#Mybatis分页插件 - PageHelper

如果你也在用Mybatis，建议尝试该分页插件，这一定是最方便使用的分页插件。

分页插件支持任何复杂的单表、多表分页，部分特殊情况请看重要提示。

想要使用分页插件？请看如何使用分页插件。

##物理分页

该插件目前支持以下数据库的物理分页:

配置dialect属性时，使用小写形式：

oracle,mysql,mariadb,sqlite,hsqldb,postgresql,db2,sqlserver,informix

##分页插件支持MyBatis3.2.0~3.3.0(包含)

##分页插件最新版本为3.7.4

###Maven坐标

<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>3.7.4</version>
</dependency>

###下载JAR包

分页插件pagehelper.jar：

由于使用了sql解析工具，你还需要下载jsqlparser.jar（这个文件完全独立，不依赖其他）：

##3.7.5-SNAPSHOT更新日志：

##3.7.4更新日志：

##3.7.3更新日志：

Page继承的ArrayList，会根据pageSize初始化大小，这就导致当pageSize过大（如Integer.MAX_VALUE）的内存溢出（实际数据量很小），此处改为初始化大小为0的List。
当想查询某页后面的全部数据时，可以使用PageHelper.startPage(pageNum, Integer.MAX_VALUE)进行分页，RowBounds(offset, Integer.MAX_VALUE)一样。
针对PageHelper.startPage(1, Integer.MAX_VALUE)优化，会取消分页，直接查询全部数据（能起到pageSizeZero参数所起的作用）。
针对RowBounds(0, Integer.MAX_VALUE)优化，会取消分页，直接查询全部数据（能起到pageSizeZero参数所起的作用）。

##3.7.2更新日志：

jsqlparser解析sql会抛出Error异常，由于只捕获Exception，所以导致部分解析失败的sql无法使用嵌套方式处理，所以修改为捕获Throwable。

##3.7.1更新日志：

##3.7.0更新日志：

由于orderby参数经常被错误认为的使用，因此该版本全面移除了orderby
Page<E>移除orderby属性
PageHelper的startPage方法中，移除包含orderby参数的方法，sqlserver相关包含该参数的全部移除
对SqlServer进行分页查询时，请在sql中包含order by语句，否则会抛出异常
当offsetAsPageNum=false的时候，由于PageNum问题，RowBounds查询的时候reasonable会强制为false，已解决
少数情况下的select中包含单个函数查询时，会使用嵌套的count查询