在Mybatis的配置xml中配置拦截器插件:
<plugins><plugin interceptor="PageHelper"><property name="dialect" value="mysql"></property></plugin></plugins>
这里的PageHelper要使用完整的类路径,需要加上包路径。 增加dialect属性,使用时必须指定该属性,可选值为oracle和mysql,该参数没有默认值,必须指定该属性。
解决了RowBounds分页的严重BUG,原先会在物理分页基础上进行内存分页导致严重错误,已修复
增加对MySql的支持,该支持由鲁家宁增加。
下面一一讲解每个版本的变化:
1.0是最初的一个版本,1.0版本使用的拦截器签名如下:
@Intercepts({@Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class}),@Signature(type = ResultSetHandler.class, method = "handleResultSets", args = {Statement.class})})
其中StatementHandler是一个Mybatis分页拦截器中最常见的拦截器签名,ResultSetHandler签名在现在看来是画蛇添足。
2.0的时候,拦截器签名如下:
@Intercepts(@Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class}))
签名改成了Executor,主要原因是为了解决缓存的问题,所以换了签名,而且发现这种签名的方式更好,换签名之后,处理分页的逻辑代码和1.0版本没有一点一样的地方,只有PageHelper的两个静态调用方法是不变,不影响1.0时候的代码。
2.1版本是因为发现了一个MappedStatement并发访问时的严重BUG,为了解决BUG,修改了逻辑,解决了并发问题。为了提醒所有使用者,特地发布了2.1版本。
3.0版本是在2.1版本发布后,根据多人的建议做的修改,改动仍然不小,首先是有人认为调用PageHelper.startPage方法不够简单,因而增加了对RowBounds的支持,因为不是所有时候分页都需要求count总数,因而增加了跳过count的方法。为了更像Mybatis默认的RowBounds方法,对使用RowBounds方法的调用,默认不进行count,需要的可以手动修改代码实现。
3.1.0版本首先是发现了3.0版本增加的RowBounds方法存在一个严重BUG,这个BUG会在物理分页之后进行内存分页导致严重的错误,因而主要修复了该BUG,同时鲁家宁提供了兼容mysql和oracle的实现,合并到了3.1.0版本中,因而就有了今天的发布。
不管版本号怎么变,目的都是为了更方便的使用该插件。
如果你对本插件有什么意见或建议,欢迎留言,不需要保留,大胆的说出来吧!