以前使用ibatis/mybatis，都是自己手寫(xiě)sql語(yǔ)句進(jìn)行物理分頁(yè)，雖然稍微有點(diǎn)麻煩，但是都習(xí)慣了。最近試用了下mybatis的分頁(yè)插件 PageHelper,感覺(jué)還不錯(cuò)吧。記錄下其使用方法。

1. 引入依賴jar包：

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

2. 配置分頁(yè)攔截器

PageHelper的原理是基于攔截器實(shí)現(xiàn)的。攔截器的配置有兩種方法，一種是在mybatis的配置文件中配置，一種是直接在sPRing的配置文件中進(jìn)行：

1）在mybatis-config.xml文件中配置：

  <plugins>    <!-- com.github.pagehelper為PageHelper類(lèi)所在包名 -->    <plugin interceptor="com.github.pagehelper.PageHelper">        <property name="dialect" value="MySQL"/>        <!-- 該參數(shù)默認(rèn)為false -->        <!-- 設(shè)置為true時(shí)，會(huì)將RowBounds第一個(gè)參數(shù)offset當(dāng)成pageNum頁(yè)碼使用 -->        <!-- 和startPage中的pageNum效果一樣-->        <property name="offsetaspageNum" value="true"/>        <!-- 該參數(shù)默認(rèn)為false -->        <!-- 設(shè)置為true時(shí)，使用RowBounds分頁(yè)會(huì)進(jìn)行count查詢 -->        <property name="rowBoundsWithCount" value="true"/>                <!-- 設(shè)置為true時(shí)，如果pageSize=0或者RowBounds.limit = 0就會(huì)查詢出全部的結(jié)果 -->        <!-- （相當(dāng)于沒(méi)有執(zhí)行分頁(yè)查詢，但是返回結(jié)果仍然是Page類(lèi)型）        <property name="pageSizeZero" value="true"/>-->                <!-- 3.3.0版本可用 - 分頁(yè)參數(shù)合理化，默認(rèn)false禁用 -->        <!-- 啟用合理化時(shí)，如果pageNum<1會(huì)查詢第一頁(yè)，如果pageNum>pages會(huì)查詢最后一頁(yè) -->        <!-- 禁用合理化時(shí)，如果pageNum<1或pageNum>pages會(huì)返回空數(shù)據(jù) -->        <property name="reasonable" value="true"/>        <!-- 3.5.0版本可用 - 為了支持startPage(Object params)方法 -->        <!-- 增加了一個(gè)`params`參數(shù)來(lái)配置參數(shù)映射，用于從Map或ServletRequest中取值 -->        <!-- 可以配置pageNum,pageSize,count,pageSizeZero,reasonable,不配置映射的用默認(rèn)值 -->        <!-- 不理解該含義的前提下，不要隨便復(fù)制該配置         <property name="params" value="pageNum=start;pageSize=limit;"/>    -->    </plugin>  </plugins>

這里要注意 <plugins> 在mybatis-config.xml文件中的位置，必須要符合 http://mybatis.org/dtd/mybatis-3-config.dtd 中指定的順序：

<!ELEMENT configuration (properties?, settings?, typeAliases?, typeHandlers?,     objectFactory?, objectWrapperFactory?, plugins?, environments?, databaseIdProvider?, mappers?)>

不然會(huì)報(bào)錯(cuò)。

當(dāng)然mybatis-config.xml的位置，我們需要在spring的配置文件中進(jìn)行指定：

    <bean id="sqlsessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">      <property name="dataSource" ref="dataSource" />      <property name="configLocation" value="classpath:config/mybatis-config.xml" />      <property name="mapperLocations" value="classpath*:config/mappers/**/*.xml" />    </bean>

2）如果mybatis沒(méi)有mybatis-config.xml文件，那么就只能直接在spring的配置文件中配置了：

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">  <property name="dataSource" ref="dataSource"/>  <property name="mapperLocations">    <array>      <value>classpath:config/mapper/*.xml</value>    </array>  </property>  <property name="typeAliasesPackage" value="com.test.pojo"/>  <property name="plugins">    <array>      <bean class="com.github.pagehelper.PageHelper">        <property name="properties">          <value>            dialect=mysql          </value>        </property>      </bean>    </array>  </property></bean>

到這里PageHelper所需要的配置已經(jīng)完成，下面還需要在serviceImpl類(lèi)中加入分頁(yè)參數(shù)的代碼：

3. 向攔截器傳遞分頁(yè)參數(shù)

我們首先看下不分頁(yè)的serviceImpl代碼：

    @Override    public List<User> getUserByNoAndEmail(String no, String email) {        Map<String, Object> map = new HashMap<>();        map.put("no", no);        map.put("email", email);        return this.userMapper.getUserByNoAndEmail(map);    }

然后我們將它改造成使用PageHelper分頁(yè)：

1）首先我們根據(jù)自己項(xiàng)目的情況，定義一個(gè)PageBean，來(lái)保存分頁(yè)之后的結(jié)果，需要哪些屬性，就加入哪些屬性，具體可以參考源代碼中的PageInfo類(lèi)的定義，其實(shí)PageInfo是插件作者給我們自己定義自己的PageBean，提供的一個(gè)參考例子。PageInfo代碼如下：

@SuppressWarnings({"rawtypes", "unchecked"})public class PageInfo<T> implements Serializable {    private static final long serialVersionUID = 1L;    //當(dāng)前頁(yè)    private int pageNum;    //每頁(yè)的數(shù)量    private int pageSize;    //當(dāng)前頁(yè)的數(shù)量    private int size;    //由于startRow和endRow不常用，這里說(shuō)個(gè)具體的用法    //可以在頁(yè)面中"顯示startRow到endRow 共size條數(shù)據(jù)"    //當(dāng)前頁(yè)面第一個(gè)元素在數(shù)據(jù)庫(kù)中的行號(hào)    private int startRow;    //當(dāng)前頁(yè)面最后一個(gè)元素在數(shù)據(jù)庫(kù)中的行號(hào)    private int endRow;    //總記錄數(shù)    private long total;    //總頁(yè)數(shù)    private int pages;    //結(jié)果集    private List<T> list;    //第一頁(yè)    private int firstPage;    //前一頁(yè)    private int prePage;    //下一頁(yè)    private int nextPage;    //最后一頁(yè)    private int lastPage;    //是否為第一頁(yè)    private boolean isFirstPage = false;    //是否為最后一頁(yè)    private boolean isLastPage = false;    //是否有前一頁(yè)    private boolean hasPreviousPage = false;    //是否有下一頁(yè)    private boolean hasNextPage = false;    //導(dǎo)航頁(yè)碼數(shù)    private int navigatePages;    //所有導(dǎo)航頁(yè)號(hào)    private int[] navigatepageNums;    /**     * 包裝Page對(duì)象     *     * @param list     */    public PageInfo(List<T> list) {        this(list, 8);    }    /**     * 包裝Page對(duì)象     *     * @param list          page結(jié)果     * @param navigatePages 頁(yè)碼數(shù)量     */    public PageInfo(List<T> list, int navigatePages) {        if (list instanceof Page) {            Page page = (Page) list;            this.pageNum = page.getPageNum();            this.pageSize = page.getPageSize();            this.total = page.getTotal();            this.pages = page.getPages();            this.list = page;            this.size = page.size();            //由于結(jié)果是>startRow的，所以實(shí)際的需要+1            if (this.size == 0) {                this.startRow = 0;                this.endRow = 0;            } else {                this.startRow = page.getStartRow() + 1;                //計(jì)算實(shí)際的endRow（最后一頁(yè)的時(shí)候特殊）                this.endRow = this.startRow - 1 + this.size;            }            this.navigatePages = navigatePages;            //計(jì)算導(dǎo)航頁(yè)            calcNavigatepageNums();            //計(jì)算前后頁(yè)，第一頁(yè)，最后一頁(yè)            calcPage();            //判斷頁(yè)面邊界            judgePageBoudary();        }    }    /**     * 計(jì)算導(dǎo)航頁(yè)     */    private void calcNavigatepageNums() {        //當(dāng)總頁(yè)數(shù)小于或等于導(dǎo)航頁(yè)碼數(shù)時(shí)        if (pages <= navigatePages) {            navigatepageNums = new int[pages];            for (int i = 0; i < pages; i++) {                navigatepageNums[i] = i + 1;            }        } else { //當(dāng)總頁(yè)數(shù)大于導(dǎo)航頁(yè)碼數(shù)時(shí)            navigatepageNums = new int[navigatePages];            int startNum = pageNum - navigatePages / 2;            int endNum = pageNum + navigatePages / 2;            if (startNum < 1) {                startNum = 1;                //(最前navigatePages頁(yè)                for (int i = 0; i < navigatePages; i++) {                    navigatepageNums[i] = startNum++;                }            } else if (endNum > pages) {                endNum = pages;                //最后navigatePages頁(yè)                for (int i = navigatePages - 1; i >= 0; i--) {                    navigatepageNums[i] = endNum--;                }            } else {                //所有中間頁(yè)                for (int i = 0; i < navigatePages; i++) {                    navigatepageNums[i] = startNum++;                }            }        }    }    /**     * 計(jì)算前后頁(yè)，第一頁(yè)，最后一頁(yè)     */    private void calcPage() {        if (navigatepageNums != null && navigatepageNums.length > 0) {            firstPage = navigatepageNums[0];            lastPage = navigatepageNums[navigatepageNums.length - 1];            if (pageNum > 1) {                prePage = pageNum - 1;            }            if (pageNum < pages) {                nextPage = pageNum + 1;            }        }    }    /**     * 判定頁(yè)面邊界     */    private void judgePageBoudary() {        isFirstPage = pageNum == 1;        isLastPage = pageNum == pages;        hasPreviousPage = pageNum > 1;        hasNextPage = pageNum < pages;    }    public void setPageNum(int pageNum) {        this.pageNum = pageNum;    }    public int getPageNum() {        return pageNum;    }    public int getPageSize() {        return pageSize;    }    public int getSize() {        return size;    }    public int getStartRow() {        return startRow;    }    public int getEndRow() {        return endRow;    }    public long getTotal() {        return total;    }    public int getPages() {        return pages;    }    public List<T> getList() {        return list;    }    public int getFirstPage() {        return firstPage;    }    public int getPrePage() {        return prePage;    }    public int getNextPage() {        return nextPage;    }    public int getLastPage() {        return lastPage;    }    public boolean isIsFirstPage() {        return isFirstPage;    }    public boolean isIsLastPage() {        return isLastPage;    }    public boolean isHasPreviousPage() {        return hasPreviousPage;    }    public boolean isHasNextPage() {        return hasNextPage;    }    public int getNavigatePages() {        return navigatePages;    }    public int[] getNavigatepageNums() {        return navigatepageNums;    }    @Override    public String toString() {        final StringBuffer sb = new StringBuffer("PageInfo{");        sb.append("pageNum=").append(pageNum);        sb.append(", pageSize=").append(pageSize);        sb.append(", size=").append(size);        sb.append(", startRow=").append(startRow);        sb.append(", endRow=").append(endRow);        sb.append(", total=").append(total);        sb.append(", pages=").append(pages);        sb.append(", list=").append(list);        sb.append(", firstPage=").append(firstPage);        sb.append(", prePage=").append(prePage);        sb.append(", nextPage=").append(nextPage);        sb.append(", lastPage=").append(lastPage);        sb.append(", isFirstPage=").append(isFirstPage);        sb.append(", isLastPage=").append(isLastPage);        sb.append(", hasPreviousPage=").append(hasPreviousPage);        sb.append(", hasNextPage=").append(hasNextPage);        sb.append(", navigatePages=").append(navigatePages);        sb.append(", navigatepageNums=");        if (navigatepageNums == null) sb.append("null");        else {            sb.append('[');            for (int i = 0; i < navigatepageNums.length; ++i)                sb.append(i == 0 ? "" : ", ").append(navigatepageNums[i]);            sb.append(']');        }        sb.append('}');        return sb.toString();    }}

因?yàn)镻ageInfo.java只是一個(gè)示例，所以他定義得有點(diǎn)重量級(jí)，屬性有點(diǎn)多，我們可以參考它，定義適合我們自己的PageBean, 比如如下定義：

public class PageBean<T> implements Serializable {    private static final long serialVersionUID = 8656597559014685635L;    private long total;        //總記錄數(shù)    private List<T> list;    //結(jié)果集    private int pageNum;    // 第幾頁(yè)    private int pageSize;    // 每頁(yè)記錄數(shù)    private int pages;        // 總頁(yè)數(shù)    private int size;        // 當(dāng)前頁(yè)的數(shù)量 <= pageSize，該屬性來(lái)自ArrayList的size屬性        /**     * 包裝Page對(duì)象，因?yàn)橹苯臃祷豍age對(duì)象，在JSON處理以及其他情況下會(huì)被當(dāng)成List來(lái)處理，     * 而出現(xiàn)一些問(wèn)題。     * @param list          page結(jié)果     * @param navigatePages 頁(yè)碼數(shù)量     */    public PageBean(List<T> list) {        if (list instanceof Page) {            Page<T> page = (Page<T>) list;            this.pageNum = page.getPageNum();            this.pageSize = page.getPageSize();            this.total = page.getTotal();            this.pages = page.getPages();            this.list = page;            this.size = page.size();        }    }    public long getTotal() {        return total;    }    public void setTotal(long total) {        this.total = total;    }    public List<T> getList() {        return list;    }    public void setList(List<T> list) {        this.list = list;    }    public int getPageNum() {        return pageNum;    }    public void setPageNum(int pageNum) {        this.pageNum = pageNum;    }    public int getPageSize() {        return pageSize;    }    public void setPageSize(int pageSize) {        this.pageSize = pageSize;    }    public int getPages() {        return pages;    }    public void setPages(int pages) {        this.pages = pages;    }    public int getSize() {        return size;    }    public void setSize(int size) {        this.size = size;    }    }

因?yàn)榉猪?yè)查詢結(jié)果返回的是一個(gè) Page 對(duì)象，而 Page 對(duì)象繼承自ArrayList，但是如果我們直接返回ArrayList的話，在一些場(chǎng)景下回遇到問(wèn)題，比如在JSON處理Page類(lèi)型的結(jié)果時(shí)，會(huì)被當(dāng)成List來(lái)JSON格式化，會(huì)丟棄 Page 對(duì)象的所有擴(kuò)展屬性，所以這里我們要將分頁(yè)的結(jié)果 Page 類(lèi)型轉(zhuǎn)換成我們自己定義的 PageBean. 我們自己定義的PageBean沒(méi)有繼承ArrayList，而是包含一個(gè)List屬性來(lái)保存分頁(yè)結(jié)果。所以避免前面的問(wèn)題。

2）修改 serviceImpl中的代碼：

    @Override    public PageBean<User> getUserByNoAndEmail(String no, String email) {        Map<String, Object> map = new HashMap<>();        map.put("no", no);        map.put("email", email);                PageHelper.startPage(PaginationContext.getPageNum(), PaginationContext.getPageSize());        List<User> list = this.userMapper.getUserByNoAndEmail(map);        return new PageBean<User>(list);    }

我們只需要使用 PageHelper.startPage(pageNum, pageSize); 函數(shù)來(lái)指定 pageNum(第幾頁(yè)) 和 pageSize(每頁(yè)顯示幾條記錄) 兩個(gè)參數(shù)。然后調(diào)用原來(lái)的查詢，就進(jìn)行了分頁(yè)。最后將返回的List，轉(zhuǎn)換成 PageBean類(lèi)型的結(jié)果即可。前臺(tái)頁(yè)面就可以根據(jù)PageBean中包括的屬性來(lái)進(jìn)行分頁(yè)顯示了。

上面的 PaginationContext 是基于 ThreadLocal 來(lái)傳遞分頁(yè)參數(shù)的一個(gè)工具類(lèi)，其實(shí)現(xiàn)如下：

public class PaginationContext {    // 定義兩個(gè)threadLocal變量：pageNum和pageSize    private static ThreadLocal<Integer> pageNum = new ThreadLocal<Integer>();    // 保存第幾頁(yè)    private static ThreadLocal<Integer> pageSize = new ThreadLocal<Integer>();    // 保存每頁(yè)記錄條數(shù)    /*     * pageNum ：get、set、remove     */    public static int getPageNum() {        Integer pn = pageNum.get();        if (pn == null) {            return 0;        }        return pn;    }    public static void setPageNum(int pageNumValue) {        pageNum.set(pageNumValue);    }    public static void removePageNum() {        pageNum.remove();    }    /*     * pageSize ：get、set、remove     */    public static int getPageSize() {        Integer ps = pageSize.get();        if (ps == null) {            return 0;        }        return ps;    }    public static void setPageSize(int pageSizeValue) {        pageSize.set(pageSizeValue);    }    public static void removePageSize() {        pageSize.remove();    }}

實(shí)現(xiàn)了前臺(tái)頁(yè)面向ServiceImpl中傳遞分頁(yè)參數(shù)： pageNum 和 pageSize.

當(dāng)然從請(qǐng)求中獲取分頁(yè)參數(shù)pageNum和pageSize需要用到filter:

public class PageFilter implements Filter {    public PageFilter() {}    public void destroy() {}    @Override    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {        HttpServletRequest httpRequest = (HttpServletRequest) request;        PaginationContext.setPageNum(getPageNum(httpRequest));        PaginationContext.setPageSize(getPageSize(httpRequest));        try {            chain.doFilter(request, response);        }        // 使用完Threadlocal，將其刪除。使用finally確保一定將其刪除        finally {            PaginationContext.removePageNum();            PaginationContext.removePageSize();        }    }    /**     * 獲得pager.offset參數(shù)的值     *      * @param request     * @return     */    protected int getPageNum(HttpServletRequest request) {        int pageNum = 1;        try {            String pageNums = request.getParameter("pageNum");            if (pageNums != null && StringUtils.isNumeric(pageNums)) {                pageNum = Integer.parseInt(pageNums);            }        } catch (NumberFormatException e) {            e.printStackTrace();        }        return pageNum;    }    /**     * 設(shè)置默認(rèn)每頁(yè)大小     *      * @return     */    protected int getPageSize(HttpServletRequest request) {        int pageSize = 10;    // 默認(rèn)每頁(yè)10條記錄        try {            String pageSizes = request.getParameter("pageSize");            if (pageSizes != null && StringUtils.isNumeric(pageSizes)) {                pageSize = Integer.parseInt(pageSizes);            }        } catch (NumberFormatException e) {            e.printStackTrace();        }        return pageSize;    }    /**     * @see Filter#init(FilterConfig)     */    public void init(FilterConfig fConfig) throws ServletException {}}

PageFilter在web.xml中的配置：

    <!-- pagination filter -->    <filter>          <filter-name>PageFilter</filter-name>          <filter-class>com.ems.filter.PageFilter</filter-class>      </filter>      <filter-mapping>          <filter-name>PageFilter</filter-name>          <url-pattern>/*</url-pattern>      </filter-mapping>

OK，到此，PageHelper的使用方法，基本結(jié)束。

PageHelper 項(xiàng)目地址：http://git.oschina.net/free/Mybatis_PageHelper

文檔地址：http://git.oschina.net/free/Mybatis_PageHelper/blob/master/wikis/HowToUse.markdown