PageHelper版本差异造成的Interceptor和dialect问题。

问题描述。

在学习网上流传的电商项目，项目也比较老了，在对mybatis分页的时候使用的是pagehelper。在最初搭建项目的时候，我没有使用教程中给的本地maven，而是直接从网上拉取包。教程中pagehelper使用的版本号是：< pagehelper.version >3.4.2fix< /pagehelper.version >，当时一直下载不下来（后来才知道fix是教程中老师自己修改过的），就直接去github找到了最新的版本5.0.4进行使用。

结果在进行分页的时候问题来了：

出现了如下错误，意思是没有实现mybatis的Interceptor：

Caused by: java.lang.ClassCastException: com.github.pagehelper.PageHelper cannot be cast to org.apache.ibatis.plugin.Interceptor
at org.apache.ibatis.builder.xml.XMLConfigBuilder.pluginElement(XMLConfigBuilder.java:142)
at org.apache.ibatis.builder.xml.XMLConfigBuilder.parseConfiguration(XMLConfigBuilder.java:100)
… 39 more

Interceptor实现位置修改。

教程中这一部分说的是，pagepelper在mybatis的Executor和MappedStatement中间实现了mybatis的Interceptor接口，为sql语句添加了limit语句，所以才可以进行分页处理。需要在SqlMapConfig.xml中配置如下内容从而支持插件：

使用的是PageHelper这个类作为拦截器的，但是错误中有说这个类并不能映射到Interceptor中，那也就是说该类并没有实现Interceptor。然后查看了一下该类：

发现确实并没有实现Interceptor，既然该类并没有实现拦截器，但是想要实现分页也只能通过实现Interceptor才行，那么只能够说明随着版本的不同，拦截器的工作不再是PageHelper类执行了。然后在下面就看到了PageInterceptor这个类：

很显然，PageInterceptor接替了PageHelper的拦截工作，在这个版本中由PageInterceptor进行拦截实现分页。

我有特地的下载了3.4.2的版本，发现在当时的版本中PageHelper确实实现了Interceptor：

修改了SqlMapConfig.xml 中拦截器的类，将其配置为新版本的PageInterceptor：

然后这样的配置也并不能使用。

dialect加载问题。

结果又出现了没有找到mysql的错误：

网上说这个版本的已经不需要了设置dialect了，因为在之前的版本中PageHelper是这样设置数据库的：

在PageHelper中设置数据库方言的名称：

然后在SqlUtil中设置了一个枚举类型，检测是哪种数据库:

然后根据不同的数据库创建不同的解析器：

就算解析器创建失败之后，也会重新创建：

除非使用了不在枚举范围内的方言，否则就会根据SqlMapConfig.xml中的dialect创建成功。

但是在新版本中，如果设置了dialect属性，那么会使用Class.forName来直接进行加载：

很显然是不存在mysql这个类的，并且是直接抛出异常。

如果去掉SqlMapConfig.xml中的dialect属性，那么就会默认创建一个PageHelper实例：

而在这个版本中的PageHelper是会自动加载dialect的：

所以说在5.0.4版本中在SqlMapConfig.xml中是不需要添加dialect属性的，因为会根据这个属性对应的值前去直接创建类，所以才会抛出找不到mysql类的异常。

如果将dialect设置为一个存在的类会发生什么？比如将其设置常用的驱动名称：

这个倒是能够创建成功，但是并不能将其转换为官方的Dialect类，所以还是会抛出异常：

所以说是没必要设置dialect的值的，如果非要设置的话就需要写一个实现了Dialect接口的类的名称：

注意：这样虽然不会报错，但是却并没有起到分页的作用！！！，因为这样的话就没有创建PageHelper，而我们的分页代码实在PageHelper中设置的，所以如果设置dialect的话，就只能设置为：PageHelper的名称了：com.github.pagehelper.PageHelper

PageHelper设置分页：

分页无效，输出全部内容：

设置为：com.github.pagehelper.PageHelper之后成功调用：