Mybatis使用pageHelper分页插件原理

关注

原创最新推荐文章于 2026-07-16 10:23:02 发布 4.1w 阅读 AI 写同款· GEO 优化 ›

介绍一下 PageHelper 实现分页原理 • PageHelper 提供了丰富的配置选项和自定义功能，如是否支持带有“for update”的查询语句、是否支持嵌套查询等。• 开发者可以通过配置文件或注解等方式来灵活配置和使用 PageHelper。阅读详情

首先在Mybatis的配置文件 SqlMapConfig.xml中配置PageHelper插件

<?xmlversion="1.0"encoding="UTF-8"?>

<!DOCTYPEconfiguration

PUBLIC "-//mybatis.org//DTD Config 3.0//EN"

"http://mybatis.org/dtd/mybatis-3-config.dtd">

<plugininterceptor="com.github.pagehelper.PageHelper">

<propertyname="dialect"value="mysql"/>

</plugin>

</plugins>

</configuration>

pageHelper是如何在mybatis中工作呢，是通过mybatis的pulgin实现了Interceptor接口

使用原理：

pageHelper会使用ThreadLocal获取到同一线程中的变量信息，各个线程之间的Threadlocal不会相互干扰，也就是Thread1中的ThreadLocal1之后获取到Tread1中的变量的信息，不会获取到Thread2中的信息

所以在多线程环境下，各个Threadlocal之间相互隔离，可以实现，不同thread使用不同的数据源或不同的Thread中执行不同的SQL语句

所以，PageHelper利用这一点通过拦截器获取到同一线程中的预编译好的SQL语句之后将SQL语句包装成具有分页功能的SQL语句，并将其再次赋值给下一步操作，所以实际执行的SQL语句就是有了分页功能的SQL语句

1定义一个分页的类

public class Page {
    private int startPage;
    private int pageSize;
    public int getStartPage() {

        return startPage;
    }
    public void setStartPage(int startPage) {
        this.startPage = startPage;
    }
    public int getPageSize() {

        return pageSize;
    }
    public void setPageSize(int pageSize) {
        this.pageSize = pageSize;
    }
    public Page(int startPage, int pageSize) {
        super();
        this.startPage = startPage;
        this.pageSize = pageSize;
    }
    public Page() {
        super();
        // TODO Auto-generated constructor stub

    }

}

2模拟 PageHelper

public class PageHelper {
    /**
     * 其实 PageHelper 的实现靠的就是这个变量，
     * 它的里面可以存储的东西，在真正需要计算分页的时候，可以随时取出来
     */
    private static final ThreadLocal<Page> LOCAL_PAGE = new ThreadLocal<Page>();

    public static void startPage(int startPage, int pageSize) {
        Page page  = new Page();
        page.setStartPage(startPage);
        page.setPageSize(pageSize);
        LOCAL_PAGE.set(page);
    }

    public static Page getPage() {
        return LOCAL_PAGE.get();
    } 
}</span>

3.测试分页原理

public class TestPage {
    public static void main(String[] args) {
        int startPage = 1;
        int pageSize =10;
        PageHelper.startPage(startPage, pageSize);
        Page page = PageHelper.getPage();
        System.out.println(page.getStartPage()  + " : " + page.getPageSize());
    }
}