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日
湖北武汉