前言

MybatisPlus版本：3.4.2

Plus源码中，分页插件相关代码位于mybatis-plus-extension包下。

分页方言：众所周知，每个数据库都有自己的方言，比如MySQL 的分页是用关键字 limit， 而 Oracle 用的是 ROWNUM，dialects包下对匹配了众多数据的分页方言，比如 DB2、MySql、Oracle、SQLServer等。

分页模型：采用Page作为统一的简单分页模型，封装了查询数据列表、总数、每页显示条数（默认 10）、当前页、排序字段信息等内容。

直接使用

默认分页查询

1. 参照入门文档搭建项目，配置分页插件

@Configuration
@EntityScan("org.seata.service.order.entity")
@MapperScan(basePackages = "org.seata.service.order.**.dao", markerInterface = BaseMapper.class)
public class MyBatisPlusConfig {

    /**
     *  插件集合
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        //  插件
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 分页插件
        PaginationInnerInterceptor paginationInnerInterceptor = new PaginationInnerInterceptor(DbType.MARIADB);
        // 添加分页插件
        interceptor.addInnerInterceptor(paginationInnerInterceptor);
        return interceptor;
    }
}

2. 编写测试接口，查询某表数据，实现在表中插入了1W+测试数据。

    @GetMapping("testPage")
    public Object testPage() {
    	//  分页查询对象，未添加任何分页参数
        Page<OrderTbl> page=new Page();
        Page<OrderTbl> orderTblPage = orderTblService.page(page);
        System.err.println("查询结果列表大小:"+orderTblPage.getRecords().size());
        System.err.println("总条数:"+orderTblPage.getTotal());
        System.err.println("countId:"+orderTblPage.getCountId());
        System.err.println("当前页:"+orderTblPage.getCurrent());
        System.err.println("每页显示条数，默认 10:"+orderTblPage.getSize());
        System.err.println("最大分页条数限制:"+orderTblPage.getMaxLimit());
        System.err.println("总页数:"+orderTblPage.getPages());
        return orderTblPage;
    }

3. 调用测试接口，可知plus查询分页对象当前页的默认值为1，分页条数为10，countId未设置，最大分页数量默认无限制。
   

自定义分页对象查询

1. 配置当前页及每页条数（也可通过构造方法配置）

        Page<OrderTbl> page=new Page<>();
        // 设置分页查询参数
        page.setCurrent(1);
        page.setSize(10000L);

2. 自定义count查询语句

Mapper：

public interface OrderTblMapper extends BaseMapper<OrderTbl> {
    //  自定义count
    Long myCount();
}

XML：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="org.seata.service.order.dao.OrderTblMapper">
    <select id="myCount" resultType="java.lang.Long">
           select  count(id) from order_tbl
    </select>
</mapper>

配置countId

        // 设置分页查询参数
        page.setSize(10000L);
        page.setCurrent(1);
        // countId可写mapper接口方法，也可以带全路径包名
        page.setCountId("myCount");

测试发现，已经使用了自定义的方法进行count查询。

3. 分页限制，防止溢出

        page.setMaxLimit(100L);

测试发现：虽然配置每页条数为1W，但是因为设置了MaxLimit，只返回了100条数据。

4. 关闭count,默认true（打开）

page.setSearchCount(false);

测试：没有打印count查询语句，总条数为0

5. 是否优化COUNT SQL，默认值为true。
   不优化时count Sql打印如下，会对查询语句的结果集再进行count处理，效率不高
   

分页插件配置

PaginationInnerInterceptor作为plus的分页插件，提供了通用的参数进行统一配置。

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        //  插件
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 分页插件
        PaginationInnerInterceptor paginationInnerInterceptor = new PaginationInnerInterceptor();
        // 设置最大分页数
        paginationInnerInterceptor.setMaxLimit(100L);
        // 是否对超过最大分页时做溢出处理
        paginationInnerInterceptor.setOverflow(true);
        // 设置数据库类型
        paginationInnerInterceptor.setDbType(DbType.MARIADB);
        //paginationInnerInterceptor.setProperties();
       // paginationInnerInterceptor.setDialect();
        //paginationInnerInterceptor.setOptimizeJoin();
        // 添加分页插件
        interceptor.addInnerInterceptor(paginationInnerInterceptor);
        return interceptor;
    }

1. setMaxLimit： 设置最大分页数
2. setOverflow：是否对超过最大分页时做溢出处理，默认false不处理，即直接丢弃溢出的数据，为true时，怎么把溢出数据放入到下一个分页中。
3. setDbType：设置数据库类型以匹配不同方言
4. setDialect： 设置分页方言
5. setOptimizeJoin：优化Join分页语句，默认true