ibatis 分页的简单实现

ibatis 物理分页的简单实现

cheungmine 2013-8-26

使用SSI (Struts2, Spring3, iBATIS2.3)框架开发Web服务的时候有一个需求就是对查询得到的结果分页显示. iBATIS2的查询函数主要有: queryForList 和 queryForPaginatedList

queryForPaginatedList 据说可以直接分页, 以至于在数据量大了的时候, 性能急剧下降, 根本不能使用.

回到 queryForList, 如下调用可以取得queryEntities的全部数据:

List<EntityClass> entities = null;
entities = getSqlMapClientTemplate().queryForList("queryEntities", paramsMap);

如果我们需要知道记录总数, 则需要:

List<Long> rowCount = getSqlMapClientTemplate().queryForList("getRowCount", paramsMap);

我的EntityClass.xml如下:

<!-- select sql -->
  <select id="queryEntities"
    parameterClass="java.util.HashMap"
    resultClass="EntityClass"
    resultMap="EntityClassResultMapDefault">
    <![CDATA[
      SELECT * FROM 
    ]]>

    <dynamic prepend="WHERE">
      <isNotEmpty prepend="AND" property="param.itemid">
      <![CDATA[
        (itemid = #param.itemid:VARCHAR#)
      ]]>
      </isNotEmpty>
      <isNotEmpty prepend="AND" property="param.brandname">
      <![CDATA[
        (brandname like #param.brandname:VARCHAR#)
      ]]>
      </isNotEmpty>
    </dynamic>
      <dynamic prepend="LIMIT">
        <isNotEmpty property="limit" >
        <![CDATA[
            #limit:INTEGER#
        ]]>
      </isNotEmpty>
    </dynamic>
    <dynamic prepend="OFFSET">
      <isNotEmpty property="offset" >
      <![CDATA[
          #offset:INTEGER#
      ]]>
      </isNotEmpty>
    </dynamic>
  </select>

  <select id="getRowCount"
    parameterClass="java.util.HashMap"
    resultClass="java.lang.Long">
    <![CDATA[
      SELECT COUNT(*) FROM ent_table
    ]]>

    <dynamic prepend="WHERE">
      <isNotEmpty prepend="AND" property="param.itemid">
      <![CDATA[
        (itemid = #param.itemid:VARCHAR#)
      ]]>
      </isNotEmpty>
      <isNotEmpty prepend="AND" property="param.brandname">
      <![CDATA[
        (brandname like #param.brandname:VARCHAR#)
      ]]>
      </isNotEmpty>
    </dynamic>
  </select>

因此代码中需要在第一次执行queryEntities之前, 先执行getRowCount以取得记录数目. 而queryEntities由于采用了SELECT * FROM table WHERE condition LIMIT m OFFSET n 语法, 会自动跳过n个结果记录(0-based), 返回不超过m条记录. 这要求数据库支持, MySQL, Sqlite 可以. 注意, OFFSET n是在返回的结果集中跳过前n个.

以上是简单的iBATIS物理分页的实现, 显然每次我们翻页的时候都要执行一次查询, 但是由于我们只取得LIMIT 条记录, 因此对服务器的内存消耗是固定的小尺寸. 这对浏览大记录集尤为有用.