Spring之Mybatis分页插件PageHelper

Spring Version: 4.3.17.RELEASE
MyBatis Version: 5.1.2

SqlMapConfig.xml简单配置

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <plugins>
        <plugin interceptor="com.github.pagehelper.PageInterceptor">
            <property name="helperDialect" value="mysql" />
        </plugin>
    </plugins>
</configuration>

MyBatis注意事项:

5.x使用PageInterceptor代替了原来的PageHelper,同时helperDialect代替了原来的dialect属性.
1、 5.x的正确配置为:
interceptor="com.github.pagehelper.PageInterceptor"
<property name="helperDialect" value="mysql" />
2、5.x以下的正确配置为:
interceptor="com.github.pagehelper.PageHelper"
<property name="dialect" value="mysql" />

MyBatis5.x使用不当可能造成的错误

1、 当使用如下配置:
interceptor="com.github.pagehelper.PageHelper"
<property name="dialect" value="mysql" />
时可能造成如下错误:

org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: java.lang.ClassCastException: com.github.pagehelper.PageHelper cannot be cast to org.apache.ibatis.plugin.Interceptor

2、 当使用如下配置
interceptor="com.github.pagehelper.PageInterceptor"
<property name="dialect" value="mysql" />
时可能造成如下错误:

org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: com.github.pagehelper.PageException: java.lang.ClassNotFoundException: mysql