Mybatis分页插件PageHelper正确的使用方法（网上有2篇不够科学的文章）

今天下午在Mybatis项目中，实现分页。因为我是后加入项目中的，Leader用的是PageHelper这个组件，但是我在实际使用的过程中遇到了2个大问题。

 1. http://www.oschina.net/news/53808/mybatis_pagehelper-3-2-2?p=2#comments
    在这篇文章中，作者有提到需要增加PageHelper的配置，原话“ 或者如果你使用Maven，你可以添加如下依赖： ”  

   这句话是有问题的，
   < plugins >

     <!-- com.github.pagehelper为PageHelper类所在包名 -->

     < plugin  interceptor = "com.github.pagehelper.PageHelper" >

         < property  name = "dialect"  value = "mysql" />

         <!-- 该参数默认为false -->

         <!-- 设置为true时，会将RowBounds第一个参数offset当成pageNum页码使用 -->

         <!-- 和startPage中的pageNum效果一样-->

         < property  name = "offsetAsPageNum"  value = "true" />

         <!-- 该参数默认为false -->

         <!-- 设置为true时，使用RowBounds分页会进行count查询 -->

         < property  name = "rowBoundsWithCount"  value = "true" />

     </ plugin >

</ plugins >
   这几段插件配置的代码，应该放到Mybatis的config配置文件中，而非Maven。
  
   后来，听Leader说，他在这也被误导了，搞了一天时间吧。

2.  http://www.oschina.net/p/mybatis_pagehelper
   作者使用PageHelper的方法不太对，虽然Java后台测试是可以的，但是在FTL中显示的时候，EL表达式不能正常显示。

   作者的代码：
    @Test

public void testPageHelperByStartPage()  throws Exception {

     String logip =  "" ;

     String username =  "super" ;

     String loginDate =  "" ;

     String exitDate =  null ;

     String logerr =  null ;

     //不进行count查询，第三个参数设为false

     PageHelper.startPage( 1 ,  10 ,  false );

     //返回结果是Page<SysLoginLog>    

     //该对象除了包含返回结果外，还包含了分页信息，可以直接按List使用

     List<SysLoginLog> logs = sysLoginLogMapper

             .findSysLoginLog(logip, username, loginDate, exitDate, logerr);

     Assert.assertEquals( 10 , logs.size());

 

     //当第三个参数没有或者为true的时候，进行count查询

     PageHelper.startPage( 2 ,  10 );

     //返回结果是Page<SysLoginLog>    

     //该对象除了包含返回结果外，还包含了分页信息，可以直接按List使用

     Page<SysLoginLog> page = (Page<SysLoginLog>) sysLoginLogMapper

             .findSysLoginLog(logip, username, loginDate, exitDate, logerr);

     Assert.assertEquals( 10 , page.getResult().size());

     //进行count查询，返回结果total>0

     Assert.assertTrue(page.getTotal() >  0 );

}

    如果在Freemarker的FTL页面中，打印${ page.pageNum }会报错，大致的意思是“expected a hash,but is a sequence”，
期待是hash类型，但实际上序列，list、ArrayList都算作序列。

    这个地方情况比较特殊， Page是一个JavaBean，有若干属性，但是他又继承了ArrayList。经实际分析，
Freemarker把这个对象当作了ArrayList，可以直接遍历<#list page as item></#list>。

     正确的方法应该是： http://www.oschina.net/news/53808/mybatis_pagehelper-3-2-2?p=2#comments

    PageHelper.startPage( 1 ,  10 );

List<Country> list = countryMapper.selectAll();

PageInfo page =  new  PageInfo(list);

assertEquals( 10 , list.size());

assertEquals( 239 , page.getTotal());


3.我的实际代码和效果



${page},

${page.pageNum}

打印结果： com.github.pagehelper.PageInfo@125d70de, 1

 关键代码：

public PageInfo list(WithdrawForm form) {

PageHelper.startPage(form.getNumber(), form.getSize());

List<Map<String, Object>> list = withdrawDao.list(form);

PageInfo page = new PageInfo(list);

return page;

}  

 Leader在从网上寻找方法的时候，正好遇到了和采纳了这些不够科学的方法，他写的程序是可以运行的，有2点原因。
他没有在Maven中配置那个Plugin，而是在Mybatis中。出于其他需要，正好没有直接使用Page对象，而是使用自己组装的Bean。 

 
  今天遇到了这2个大问题，特意总结下，希望后来的人，不要再被误导了。

  除了PageHelper这个分页插件，我在秒针工作的时候，原秒针Web前端高级工程师 现百度高级工程师， 张少龙-默默，
他也自己实现了一个插件，今后再分享出来。

小雷FansUnion
2014年10月20日
湖北武汉