Mybatis分页插件PageHelper 5.0.4发布

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

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

1. Oracle

2.  Mysql

3. MariaDB

4. SQLite

5. Hsqldb

6. PostgreSQL

7. DB2

8. SqlServer(2005+)

9. Informix

10. H2
    

11. SqlServer2012
    

12. Derby
    

13. Phoenix

如果你使用 Maven 可以在pom.xml 中添加下面的依赖：

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

如果使用Spring Boot，可以直接添加下面的依赖：

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

     5.0.4 

• 增加对Phoenix数据库的简单配置支持，配置helperDialect=phoenix即可，也可以自动识别Phoenix数据库的 jdbc url。

• count 查询的缓存msCountMapkey 改为String类型，key 为 count 查询的MappedStatement的 id。

• 增加countSuffixcount 查询后缀配置参数，该参数是针对PageInterceptor配置的，默认值为_COUNT。

• 增加手写 count 查询支持，详情看下面介绍。

    增加手写 count 查询支持

    增加countSuffixcount 查询后缀配置参数，该参数是针对PageInterceptor配置的，默认值为_COUNT。

    分页插件会优先通过当前查询的 msId +countSuffix查找手写的分页查询。

    如果存在就使用手写的 count 查询，如果不存在，仍然使用之前的方式自动创建 count 查询。

    例如，如果存在下面两个查询：

<select id="selectLeftjoin" resultType="com.github.pagehelper.model.Country">
    select a.id,b.countryname,a.countrycode from country a
    left join country b on a.id = b.id
    order by a.id
</select>
<select id="selectLeftjoin_COUNT" resultType="Long">
    select count(distinct a.id) from country a
    left join country b on a.id = b.id
</select>

上面的countSuffix使用的默认值_COUNT，分页插件会自动获取到selectLeftjoin_COUNT查询，这个查询需要自己保证结果数正确。

返回值的类型必须是resultType="Long"，入参使用的和selectLeftjoin查询相同的参数，所以在 SQL 中要按照selectLeftjoin的入参来使用。

因为selectLeftjoin_COUNT方法是自动调用的，所以不需要在接口提供相应的方法，如果需要单独调用，也可以提供。

上面方法执行输出的部分日志如下：

DEBUG [main] - ==>  Preparing: select count(distinct a.id) from country a left join country b on a.id = b.id 
DEBUG [main] - ==> Parameters: 
TRACE [main] - <==    Columns: C1
TRACE [main] - <==        Row: 183
DEBUG [main] - <==      Total: 1
DEBUG [main] - Cache Hit Ratio [com.github.pagehelper.mapper.CountryMapper]: 0.0
DEBUG [main] - ==>  Preparing: select a.id,b.countryname,a.countrycode from country a left join country b on a.id = b.id order by a.id LIMIT 10 
DEBUG [main] - ==> Parameters: 
TRACE [main] - <==    Columns: ID, COUNTRYNAME, COUNTRYCODE
TRACE [main] - <==        Row: 1, Angola, AO
TRACE [main] - <==        Row: 2, Afghanistan, AF
TRACE [main] - <==        Row: 3, Albania, AL