PageHelper的使用及避坑

最新推荐文章于 2025-04-22 10:25:51 发布

Cx330vvv

最新推荐文章于 2025-04-22 10:25:51 发布

阅读量1w

点赞数 21

文章标签： mybatis

本文链接：https://blog.csdn.net/weixin_41649773/article/details/137506134

版权

一、PageHelper介绍及使用

PageHelper是Mybatis-Plus中的一个插件，主要用于实现数据库的分页查询功能。其核心原理是将传入的页码和条数赋值给一个Page对象，并保存到本地线程ThreadLocal中。接下来，PageHelper会进入Mybatis的拦截器环节，在拦截器中获取并处理刚才保存在ThreadLocal中的分页参数。这些分页参数会与原本的SQL语句和内部已经定义好的SQL进行拼接，从而完成带有分页处理的SQL语句的构建。

PageHelper有很多中使用方式，下面列出官方给出的几种使用方式。

    //第一种，RowBounds方式的调用
    List<Country> list = sqlSession.selectList("x.y.selectIf", null, new RowBounds(0, 10));

    //第二种，Mapper接口方式的调用，推荐这种使用方式。
    PageHelper.startPage(1, 10);
    List<Country> list = countryMapper.selectIf(1);

    //第三种，Mapper接口方式的调用，推荐这种使用方式。
    PageHelper.offsetPage(1, 10);
    List<Country> list = countryMapper.selectIf(1);

    //第四种，参数方法调用
    //存在以下 Mapper 接口方法，你不需要在 xml 处理后两个参数
    public interface CountryMapper {
        List<Country> selectByPageNumSize(
                @Param("user") User user,
                @Param("pageNum") int pageNum,
                @Param("pageSize") int pageSize);
    }
    //配置supportMethodsArguments=true
    //在代码中直接调用：
    List<Country> list = countryMapper.selectByPageNumSize(user, 1, 10);

    //第五种，参数对象
    //如果 pageNum 和 pageSize 存在于 User 对象中，只要参数有值，也会被分页
    //有如下 User 对象
    public class User {
        //其他fields
        //下面两个参数名和 params 配置的名字一致
        private Integer pageNum;
        private Integer pageSize;
    }
    //存在以下 Mapper 接口方法，你不需要在 xml 处理后两个参数
    public interface CountryMapper {
        List<Country> selectByPageNumSize(User user);
    }
    //当 user 中的 pageNum!= null && pageSize!= null 时，会自动分页
    List<Country> list = countryMapper.selectByPageNumSize(user);

    //第六种，ISelect 接口方式
    //jdk6,7用法，创建接口
    Page<Country> page = PageHelper.startPage(1, 10).doSelectPage(new ISelect() {
        @Override
        public void doSelect() {
            countryMapper.selectGroupBy();
        }
    });
    //jdk8 lambda用法
    Page<Country> page = PageHelper.startPage(1, 10).doSelectPage(()-> countryMapper.selectGroupBy());

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

二、PageHelper原理

其核心原理是将传入的页码和条数复制给一个Page对象，并保存到本地线程ThreadLocal中。

下面以常见的使用方式看一下：

PageHelper.startPage(1, 10, orderBy);

经过一系列的循环俄罗斯套娃调用之后，来到了这里：

public static <E> Page<E> startPage(int pageNum, int pageSize, boolean count, Boolean reasonable, Boolean pageSizeZero) {
    Page<E> page = new Page<E>(pageNum, pageSize, count);
    page.setReasonable(reasonable);
    page.setPageSizeZero(pageSizeZero);
    //当已经执行过orderBy的时候
    Page<E> oldPage = getLocalPage();
    if (oldPage != null && oldPage.isOrderByOnly()) {
        page.setOrderBy(oldPage.getOrderBy());
    }
    setLocalPage(page);
    return page;
}

重点在setLocalPage(page)这个方法，将page对象放到了静态变量ThreadLocal中。

查询接口进来的时候，PageHelper中的ThreadLocal对象中就保存的改线程对应的分页参数，在调用查询的时候就会拿出来使用。

PageHelper中有写了一个com.github.pagehelper.PageInterceptor，这里是执行分页的地方。如果你想要些其他的拦截器，也可以自定义一个拦截器，在这里对sql进行处理。

在PageInterceptor中有一个主要interceptor方法，在方法中需要判断是否需要分页，如果需要分页，则获取分页信息，查询数据量等。

接下来，PageHelper会进入Mybatis的拦截器环节，在拦截器中获取并处理刚才保存在ThreadLocal中的分页参数。这些分页参数会与原本的SQL语句和内部已经定义好的SQL进行连接，从而完成带有分页处理的SQL语句的构建。需要注意一点的是在finally中remove掉ThreadLocal对象中当前线程的Page对象。

调用skip方法，并获取分页参数判断是否需要分页。

从静态ThreadLocal中获取Page对象。

PageHelper在执行这一过程时，会判断SQL的类型，只有当该SQL是查询操作时，才会进入分页逻辑。并且，在进入分页逻辑处理后，PageHelper会通过反射获取该方法的参数，判断是否存在IPage对象（这是Mybatis-Plus中的另一个分页对象）的实现类。如果存在这样的实现类，那么也会进行相应的分页处理。

三、PageHelper注意事项

1、确保PageHelper.startPage()被正确使用：

必须在Mapper的查询方法之前调用PageHelper.startPage()，并且确保该查询方法会消费掉分页设置，否则分页设置可能会影响后续的查询。如果传参对象的分页字段是pageNum和pageSize，即使没有显式调用PageHelper.startPage()，PageHeler也可能自动应用分页，这可能导致预期之外的行为。