GitHub - digdeep126/Mybatis-PageHelper: Mybatis通用分页插件

#Mybatis分页插件 - PageHelper

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

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

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

##物理分页

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

Oracle
Mysql
MariaDB
SQLite
Hsqldb
PostgreSQL
DB2
SqlServer(2005,2008)
Informix
H2
SqlServer2012

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

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

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

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

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

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

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

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

###Maven坐标

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

###下载JAR包

分页插件pagehelper.jar：

###由于使用了sql解析工具，你还需要下载jsqlparser.jar

####4.1.0及以后版本需要0.9.4版本

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

####4.1.0以前版本需要0.9.1版本

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

##4.1.0更新日志：

增加autoRuntimeDialect参数，允许在运行时根据多数据源自动识别对应方言的分页（暂时不支持自动选择sqlserver2012，只能使用sqlserver）。
去掉了4.0.3版本增加的returnPageInfo参数，接口返回值不支持PageInfo类型，可以使用下面ISelect中演示的方法获取
增加对SqlServer2012的支持，需要手动指定dialect=sqlserver2012，否则会使用2005的方式进行分页
jsqlparser升级到0.9.4版本，使用jar包时必须用最新的0.9.4版本，使用Maven会自动依赖0.9.4
增加ISelect接口，方便调用，使用方法可以参考src/test/java/com.github.pagehelper.test.basic.TestISelect测试。

###使用ISelect接口可以参考如下用法(返回值为Page或PageInfo)：

//jdk6,7用法，创建接口
Page<Country> page = PageHelper.startPage(1, 10).setOrderBy("id desc").doSelectPage(new ISelect() {
    @Override
    public void doSelect() {
        countryMapper.selectGroupBy();
    }
});
//jdk8 lambda用法
Page<Country> page = PageHelper.startPage(1, 10).setOrderBy("id desc").doSelectPage(()-> countryMapper.selectGroupBy());
//为了说明可以链式使用，上面是单独setOrderBy("id desc")，也可以直接如下
Page<Country> page = PageHelper.startPage(1, 10, "id desc").doSelectPage(()-> countryMapper.selectGroupBy());

//也可以直接返回PageInfo，注意doSelectPageInfo方法和doSelectPage
pageInfo = PageHelper.startPage(1, 10).setOrderBy("id desc").doSelectPageInfo(new ISelect() {
    @Override
    public void doSelect() {
        countryMapper.selectGroupBy();
    }
});
//对应的lambda用法
pageInfo = PageHelper.startPage(1, 10).setOrderBy("id desc").doSelectPageInfo(() -> countryMapper.selectGroupBy());

//count查询，返回一个查询语句的count数
long total = PageHelper.count(new ISelect() {
    @Override
    public void doSelect() {
        countryMapper.selectLike(country);
    }
});
//lambda
total = PageHelper.count(()->countryMapper.selectLike(country));