/Mybatis-PageHelper

Mybatis通用分页插件

Primary LanguageJavaMIT LicenseMIT

#Mybatis分页插件 - PageHelper

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

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

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

##物理分页

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

  1. Oracle
  2. Mysql
  3. MariaDB
  4. SQLite
  5. Hsqldb
  6. PostgreSQL
  7. DB2
  8. SqlServer(2005+)
  9. Informix
  10. H2

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

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

在4.0.0版本以后，dialect参数可以不配置，系统能自动识别这里提到的所有数据库。

对于不支持的数据库，可以实现com.github.pagehelper.parser.Parser接口，然后配置到dialect参数中(4.0.2+)。

##MyBatis工具网站:http://mybatis.tk

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

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

###Maven坐标

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

###下载JAR包

分页插件pagehelper.jar：

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

##4.0.3更新日志：

  • PageHelper新增3个offsetPage方法，参数主要是offset和limit，允许不规则分页

  • 新增两个可配参数supportMethodsArguments和returnPageInfo，具体含义和用法请看如何使用分页插件中的参数介绍

##4.0.2更新日志：

  • 简化Page<E>类，包含排序条件orderBy

  • dialect参数是数据库名称时不区分大小写

  • dialect参数可以设置为实现com.github.pagehelper.parser.Parser接口的实现类全限定名称

  • 增加对H2数据库的支持

  • 将OrderByHelper(排序插件)融合到PageHelper中，移除OrderByHelper

  • 该版本调整比较大，但对开发人员影响较小，为以后扩展和完善提供方便

##4.0.1更新日志：

##4.0.0更新日志：

  • 配置属性dialect不在强制要求，可以不写，分页插件会自动判断

  • 解决从request中获取分页参数时的错误,感谢探路者☆

  • PageInfo增加空构造方法，所有属性增加setter方法

  • 增加对排序的支持

  • 可以单独使用PageHelper.orderBy(String orderBy)对查询语句增加排序，也可以配合startPage的其他方法使用

  • 可以使用PageHelper.startPage(int start,int size,String orderBy)对分页查询进行排序

  • 修改分页查询的处理逻辑，主要是将原sqlSource包装成可以分页和排序的sqlSource

##项目文档wiki：

###如何使用分页插件

如果要使用分页插件，这篇文档一定要看，看完肯定没有问题。

如果和Spring集成不熟悉，可以参考下面两个MyBatis和Spring集成的框架

只有基础的配置信息，没有任何现成的功能，作为新手入门搭建框架的基础

这两个集成框架集成了MyBatis分页插件和MyBatis通用Mapper。

###如何使用排序插件

###更新日志

包含全部的详细的更新日志。

###重要提示

提示很重要，建议一定看一遍！

###提交(gitosc)BUG

##相关链接

对应于oschub的项目地址：http://git.oschina.net/free/Mybatis_PageHelper

对应于github的项目地址：https://github.com/pagehelper/Mybatis-PageHelper

Mybatis-Sample（分页插件测试项目）：http://git.oschina.net/free/Mybatis-Sample

Mybatis项目：https://github.com/mybatis/mybatis-3

Mybatis文档：http://mybatis.github.io/mybatis-3/zh/index.html

Mybatis专栏：

作者博客：

作者邮箱： abel533@gmail.com

Mybatis工具群： Mybatis工具