详解Mybatis极其(最)简(好)单(用)的一个分页插件

注意：这篇博客已经和当前的分页插件完全不一样了，所以建议大家通过上面项目地址查看最新的源码和文档来了解。

以前为Mybatis分页查询发愁过，而且在网上搜过很多相关的文章，最后一个都没采用。在分页的地方完全都是手写分页SQL和count的sql，总之很麻烦。

后来有一段时间想从Mybatis内部写一个分页的实现，我对LanguageDriver写过一个实现，自动分页是没问题了，但是查询总数（count）仍然没法一次性解决，最后不了了之。

最近又要用到分页，为了方便必须地写个通用的分页类，因此又再次参考网上大多数的Mybatis分页代码。

实际上在很早之前，有人在github上开源过一个实现，支持MySQL,Oracle,sqlserver的，和上面这个参考的比较类似，考虑的更全面。但是我觉得太多类太麻烦了，所以自己实现了一个只有一个拦截器的类，实际上可以分为两个类，其中一个类被我写成静态类放在了拦截器中，你也可以将Page类提取出来，方便使用Page。

先说实现方法，该插件只有一个类：PageHelper.Java

拦截器签名为：

@Intercepts({@Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class}), 
@Signature(type = ResultSetHandler.class, method = "handleResultSets", args = {Statement.class})}) 

这里的签名对整个实现和思想至关重要，首先我拦截prepare方法来改分页SQL，来做count查询。然后我拦截handleResultSets方法来获取最后的处理结果，将结果放到Page对象中。

下面是修改分页的代码，是针对Oracle数据进行的修改，如果有用其他数据库的，自己修改这里的代码就可以。

/** 
   * 修改原SQL为分页SQL 
   * @param sql 
   * @param page 
   * @return 
   */ 
  private String buildPageSql(String sql, Page page) { 
    StringBuilder pageSql = new StringBuilder(200); 
    pageSql.append("select * from ( select temp.*, rownum row_id from ( "); 
    pageSql.append(sql); 
    pageSql.append(" ) temp where rownum <= ").append(page.getEndRow()); 
    pageSql.append(") where row_id > ").append(page.getStartRow()); 
    return pageSql.toString(); 
  } 

之后在下面的setPageParameter方法中一个selelct count语句，这里也需要根据数据库类型进行修改：

// 记录总记录数 
String countSql = "select count(0) from (" + sql + ")"; 

为什么我不提供对各种数据库的支持呢，我觉得没必要，还有些数据库不支持分页，而且这个插件越简单对使用的开发人员来说越容易理解，越容易修改。修改成自己需要的分页查询肯定不是问题。

最后上完整代码（继续看下去，下面还有使用方法）：（点击下载）

package com.mybatis.util; 
import org.apache.ibatis.executor.parameter.ParameterHandler; 
import org.apache.ibatis.executor.resultset.ResultSetHandler; 
import org.apache.ibatis.executor.statement.StatementHandler; 
import org.apache.ibatis.mapping.BoundSql; 
import org.apache.ibatis.mapping.MappedStatement; 
import org.apache.ibatis.plugin.*; 
import org.apache.ibatis.reflection.MetaObject; 
import org.apache.ibatis.reflection.SystemMetaObject; 
import org.apache.ibatis.scripting.defaults.DefaultParameterHandler; 
import org.apache.log4j.Logger; 
 
import java.sql.*; 
import java.util.List; 
import java.util.Properties; 
 
/** 
 * Mybatis - 通用分页拦截器 
 * @author liuzh/abel533/isea 
 * Created by liuzh on 14-4-15. 
 */ 
@Intercepts({@Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class}), 
    @Signature(type = ResultSetHandler.class, method = "handleResultSets", args = {Statement.class})}) 
public class PageHelper implements Interceptor { 
  private static final Logger logger = Logger.getLogger(PageHelper.class); 
 
  public static final ThreadLocal<Page> localPage = new ThreadLocal<Page>(); 
 
  /** 
   * 开始分页 
   * @param pageNum 
   * @param pageSize 
   */ 
  public static void startPage(int pageNum, int pageSize) { 
    localPage.set(new Page(pageNum, pageSize)); 
  } 
 
  /** 
   * 结束分页并返回结果，该方法必须被调用，否则localPage会一直保存下去，直到下一次startPage 
   * @return 
   */ 
  public static Page endPage() { 
    Page page = localPage.get(); 
    localPage.remove(); 
    return page; 
  } 
 
  @Override 
  public Object intercept(Invocation invocation) throws Throwable { 
    if (localPage.get() == null) { 
      return invocation.proceed(); 
    } 
    if (invocation.getTarget() instanceof StatementHandler) { 
      StatementHandler statementHandler = (StatementHandler) invocation.getTarget(); 
      MetaObject metaStatementHandler = SystemMetaObject.forObject(statementHandler); 
      // 分离代理对象链(由于目标类可能被多个拦截器拦截，从而形成多次代理，通过下面的两次循环 
      // 可以分离出最原始的的目标类) 
      while (metaStatementHandler.hasGetter("h")) { 
        Object object = metaStatementHandler.getValue("h"); 
        metaStatementHandler = SystemMetaObject.forObject(object); 
      } 
      // 分离最后一个代理对象的目标类 
      while (metaStatementHandler.hasGetter("target")) { 
        Object object = metaStatementHandler.getValue("target"); 
        metaStatementHandler = SystemMetaObject.forObject(object); 
      } 
      MappedStatement mappedStatement = (MappedStatement) metaStatementHandler.getValue("delegate.mappedStatement"); 
      //分页信息if (localPage.get() != null) { 
      Page page = localPage.get(); 
      BoundSql boundSql = (BoundSql) metaStatementHandler.getValue("delegate.boundSql"); 
      // 分页参数作为参数对象parameterObject的一个属性 
      String sql = boundSql.getSql(); 
      // 重写sql 
      String pageSql = buildPageSql(sql, page); 
      //重写分页sql 
      metaStatementHandler.setValue("delegate.boundSql.sql", pageSql); 
      Connection connection = (Connection) invocation.getArgs()[0]; 
      // 重设分页参数里的总页数等 
      setPageParameter(sql, connection, mappedStatement, boundSql, page); 
      // 将执行权交给下一个拦截器 
      return invocation.proceed(); 
    } else if (invocation.getTarget() instanceof ResultSetHandler) { 
      Object result = invocation.proceed(); 
      Page page = localPage.get(); 
      page.setResult((List) result); 
      return result; 
    } 
    return null; 
  } 
 
  /** 
   * 只拦截这两种类型的 
   * StatementHandler 
   * ResultSetHandler 
   * @param target 
   * @return 
   */ 
  @Override 
  public Object plugin(Object target) { 
    if (target instanceof StatementHandler || target instanceof ResultSetHandler) { 
      return Plugin.wrap(target, this); 
    } else { 
      return target; 
    } 
  } 
 
  @Override 
  public void setProperties(Properties properties) { 
 
  } 
 
  /** 
   * 修改原SQL为分页SQL 
   * @param sql 
   * @param page 
   * @return 
   */ 
  private String buildPageSql(String sql, Page page) { 
    StringBuilder pageSql = new StringBuilder(200); 
    pageSql.append("select * from ( select temp.*, rownum row_id from ( "); 
    pageSql.append(sql); 
    pageSql.append(" ) temp where rownum <= ").append(page.getEndRow()); 
    pageSql.append(") where row_id > ").append(page.getStartRow()); 
    return pageSql.toString(); 
  } 
 
  /** 
   * 获取总记录数 
   * @param sql 
   * @param connection 
   * @param mappedStatement 
   * @param boundSql 
   * @param page 
   */ 
  private void setPageParameter(String sql, Connection connection, MappedStatement mappedStatement, 
                 BoundSql boundSql, Page page) { 
    // 记录总记录数 
    String countSql = "select count(0) from (" + sql + ")"; 
    PreparedStatement countStmt = null; 
    ResultSet rs = null; 
    try { 
      countStmt = connection.prepareStatement(countSql); 
      BoundSql countBS = new BoundSql(mappedStatement.getConfiguration(), countSql, 
          boundSql.getParameterMappings(), boundSql.getParameterObject()); 
      setParameters(countStmt, mappedStatement, countBS, boundSql.getParameterObject()); 
      rs = countStmt.executeQuery(); 
      int totalCount = 0; 
      if (rs.next()) { 
        totalCount = rs.getInt(1); 
      } 
      page.setTotal(totalCount); 
      int totalPage = totalCount / page.getPageSize() + ((totalCount % page.getPageSize() == 0) ? 0 : 1); 
      page.setPages(totalPage); 
    } catch (SQLException e) { 
      logger.error("Ignore this exception", e); 
    } finally { 
      try { 
        rs.close(); 
      } catch (SQLException e) { 
        logger.error("Ignore this exception", e); 
      } 
      try { 
        countStmt.close(); 
      } catch (SQLException e) { 
        logger.error("Ignore this exception", e); 
      } 
    } 
  } 
 
  /** 
   * 代入参数值 
   * @param ps 
   * @param mappedStatement 
   * @param boundSql 
   * @param parameterObject 
   * @throws SQLException 
   */ 
  private void setParameters(PreparedStatement ps, MappedStatement mappedStatement, BoundSql boundSql, 
                Object parameterObject) throws SQLException { 
    ParameterHandler parameterHandler = new DefaultParameterHandler(mappedStatement, parameterObject, boundSql); 
    parameterHandler.setParameters(ps); 
  } 
 
  /** 
   * Description: 分页 
   * Author: liuzh 
   * Update: liuzh(2014-04-16 10:56) 
   */ 
  public static class Page<E> { 
    private int pageNum; 
    private int pageSize; 
    private int startRow; 
    private int endRow; 
    private long total; 
    private int pages; 
    private List<E> result; 
 
    public Page(int pageNum, int pageSize) { 
      this.pageNum = pageNum; 
      this.pageSize = pageSize; 
      this.startRow = pageNum > 0 ? (pageNum - 1) * pageSize : 0; 
      this.endRow = pageNum * pageSize; 
    } 
 
    public List<E> getResult() { 
      return result; 
    } 
 
    public void setResult(List<E> result) { 
      this.result = result; 
    } 
 
    public int getPages() { 
      return pages; 
    } 
 
    public void setPages(int pages) { 
      this.pages = pages; 
    } 
 
    public int getEndRow() { 
      return endRow; 
    } 
 
    public void setEndRow(int endRow) { 
      this.endRow = endRow; 
    } 
 
    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 getStartRow() { 
      return startRow; 
    } 
 
    public void setStartRow(int startRow) { 
      this.startRow = startRow; 
    } 
 
    public long getTotal() { 
      return total; 
    } 
 
    public void setTotal(long total) { 
      this.total = total; 
    } 
 
    @Override 
    public String toString() { 
      return "Page{" + 
          "pageNum=" + pageNum + 
          ", pageSize=" + pageSize + 
          ", startRow=" + startRow + 
          ", endRow=" + endRow + 
          ", total=" + total + 
          ", pages=" + pages + 
          '}'; 
    } 
  } 
} 

使用该拦截器首先需要在Mybatis配置中配置该拦截器：

<plugins> 
  <plugin interceptor="com.mybatis.util.PageHelper"></plugin> 
</plugins> 

配置拦截器的时候需要注意plugins的位置,plugins位置顺序如下：

properties?, settings?, typeAliases?, typeHandlers?, objectFactory?, objectWrapperFactory?, plugins?, environments?, databaseIdProvider?, mappers? 

最后是调用该方法的例子代码（Service层）：

@Override 
public PageHelper.Page<SysLoginLog> findSysLoginLog(String loginIp, 
                     String username, 
                     String loginDate, 
                     String exitDate, 
                     String logerr, 
                     int pageNumber, 
                     int pageSize) throws BusinessException { 
  PageHelper.startPage(pageNumber,pageSize); 
  sysLoginLogMapper.findSysLoginLog(loginIp, username, loginDate, exitDate, logerr); 
  return PageHelper.endPage(); 
} 

从上面可以看到使用该插件使用起来是很简单的，只需要在查询前后使用PageHelper的startPage和endPage方法即可，中间代码的调用结果已经存在于Page的result中，如果你在一个返回一个结果的地方调用PageHelper，返回的结果仍然是一个List，取第一个值即可（我想没人会在这种地方这么用，当然这样也不出错）。

另外在startPage和endPage中间的所有mybatis代码都会被分页，而且PageHelper只会保留最后一次的结果，因而使用时需要保证每次只在其中执行一个mybatis查询，如果有多个分页，请多次使用startPage和endPage。

由于这里只提供了Oracle的实现，所以我希望参考该分页插件实现的其他数据库的读者也能将相应的代码开源。

项目地址：http://xiazai./201612/yuanma/Mybatis_PageHelper_jb51.zip

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# mybatis  # 分页插件  # mybatis分页插件使用  # mybatis的分页插件  # Mybatis分页插件PageHelper的使用详解  # Java简单实现SpringMVC+MyBatis分页插件  # mybatis分页插件pageHelper详解及简单实例  # 自己动手写的mybatis分页插件(极其简单好用)  # Mybatis常用分页插件实现快速分页处理技巧  # spring boot和mybatis集成分页插件  # SSM使用mybatis分页插件pagehepler实现分页示例  # SpringBoot集成MyBatis的分页插件PageHelper实例代码  # Mybatis分页插件PageHelper的配置和简单使用方法(推荐)  # Mybatis分页插件使用方法详解  # 分页  # 拦截器  # 我觉得  # 多个  # 只有一个  # 重写  # 方法来  # 开源  # 都是  # 是一个  # 我想  # 也不  # 我不  # 放在  # 太多  # 第一个  # 都没  # 你在  # 我对  # 只需 

相关文章： 网站制作软件免费下载安装,有哪些免费下载的软件网站？  C++中的Pimpl idiom是什么，有什么好处？（隐藏实现）  官网网站制作腾讯审核要多久,联想路由器newifi官网  如何用PHP工具快速搭建高效网站？  小视频制作网站有哪些,有什么看国内小视频的网站，求推荐？  建站之星备案流程有哪些注意事项？  Java解压缩zip - 解压缩多个文件或文件夹实例  如何基于云服务器快速搭建网站及云盘系统？  专业公司网站制作公司,用什么语言做企业网站比较好？  淘宝制作网站有哪些,淘宝网官网主页？  制作门户网站的参考文献在哪,小说网站怎么建立？  如何挑选最适合建站的高性能VPS主机？  如何在腾讯云服务器上快速搭建个人网站？  如何用AWS免费套餐快速搭建高效网站？  Android滚轮选择时间控件使用详解  如何选择网络建站服务器？高效建站必看指南  如何在阿里云通过域名搭建网站？  建站之星下载版如何获取与安装？  济南网站建设制作公司,室内设计网站一般都有哪些功能？  做企业网站制作流程,企业网站制作基本流程有哪些？  如何通过虚拟主机快速搭建个人网站？  猪八戒网站制作视频,开发一个猪八戒网站，大约需要多少？或者自己请程序员，需要什么程序员，多少程序员能完成？  c++如何打印函数堆栈信息_c++ backtrace函数与符号名解析【方法】  如何选择靠谱的建站公司加盟品牌？  宝塔面板如何快速创建新站点？  正规网站制作公司有哪些,目前国内哪家网页网站制作设计公司比较专业靠谱？口碑好？  子杰智能建站系统｜零代码开发与AI生成SEO优化指南  官网自助建站平台指南：在线制作、快速建站与模板选择全解析  如何制作算命网站,怎么注册算命网站？  如何获取免费开源的自助建站系统源码？  jQuery 常见小例汇总  如何在局域网内绑定自建网站域名？  制作证书网站有哪些,全国城建培训中心证书查询官网？  网站制作难吗安全吗,做一个网站需要多久时间？  如何快速生成ASP一键建站模板并优化安全性？  建站主机是什么？如何选择适合的建站主机？  C++如何将C风格字符串（char*）转换为std::string？（代码示例）  网站制作中优化长尾关键字挖掘的技巧,建一个视频网站需要多少钱？  番禺网站制作公司哪家值得合作,番禺图书馆新馆开放了吗？  东莞专业网站制作公司有哪些,东莞招聘网站哪个好？  建站IDE高效指南：快速搭建+SEO优化+自适应模板全解析  详解jQuery中基本的动画方法  详解免费开源的.NET多类型文件解压缩组件SharpZipLib（.NET组件介绍之七）  可靠的网站设计制作软件,做网站设计需要什么样的电脑配置？  攀枝花网站建设,攀枝花营业执照网上怎么年审？  平台云上自助建站如何快速打造专业网站？  如何快速搭建高效WAP手机网站？  详解jQuery停止动画——stop()方法的使用  如何设置并定期更换建站之星安全管理员密码？  制作旅游网站html,怎样注册旅游网站？