PageHelper - MyBatis 分页插件

        如果你也在用 MyBatis，建议尝试该分页插件，这一定是最方便使用的分页插件。分页插件支持任何复杂的单表、多表分页。

        学习任何知识都推荐查看它的官方文档：MyBatis 分页插件 PageHelper

        文档里面介绍了很多，我这里谈一下我的理解，以及我觉得最好用的使用方法

使用分页插件的步骤

1.引入依赖(在 pom.xml 中添加如下依赖)

<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>最新版本</version>
</dependency>

        点击 PageHelper 官网的更新日志即可查看版本

2.配置插件

在 MyBatis 配置文件 mybatis-config.xml 中配置拦截器插件

        要注意 plugins 在配置文件中的位置必须符合要求

<!--
    plugins在配置文件中的位置必须符合要求，否则会报错，顺序如下:
    properties?, settings?,
    typeAliases?, typeHandlers?,
    objectFactory?,objectWrapperFactory?,
    plugins?,
    environments?, databaseIdProvider?, mappers?
-->
<plugins>
    <!-- com.github.pagehelper为PageHelper类所在包名 -->
    <plugin interceptor="com.github.pagehelper.PageInterceptor">
        <!-- 使用下面的方式配置参数，后面会有所有的参数介绍 -->
        <property name="param1" value="value1"/>
    </plugin>
</plugins>

        name 对应参数名，value 对应参数的值
如：
        <property name="helperDialect" value="mysql"/>  配置分页插件使用哪种方言（这里使用的是mysql），当然即使不设置分页插件也会自动检测当前的数据库链接，自动选择合适的分页方式。
        <property name="reasonable" value="true"/>    分页合理化参数，默认值为false。当该参数设置为 true 时，pageNum（页码）<=0 时会查询第一页， pageNum>pages（超过总数时），会查询最后一页。默认false 时，直接根据参数进行查询。

在 Spring 配置文件中配置拦截器插件

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
  <!-- 注意其他配置 -->
  <property name="plugins">
    <array>
      <bean class="com.github.pagehelper.PageInterceptor">
        <property name="properties">
          <!--使用下面的方式配置参数，一行配置一个 -->
          <value>
            params=value1
          </value>
        </property>
      </bean>
    </array>
  </property>
</bean>

3.在代码中使用

使用PageInfo的用法：
/获取第1页，10条内容，默认查询总数count
//开始分页，传入 pageNum（页码） 和 pageSize（每页数目）
PageHelper.startPage(1, 10);

//查询出所有的数据放到列表中
//我们只需要查询出所有的数据放到列表中，之后将列表交给 PageHelper ，PageHelper 就能提供各种方法让我们获取到关于列表的数据
List<Country> list = countryMapper.selectAll();

//用PageInfo对结果进行包装
// 将包含所有数据的列表作为参数构造 PageInfo 对象，泛型是列表中的数据类型
// PageInfo 对象的 get 系列方法可以让我们获得关于列表的各种数据
PageInfo<Country> page = new PageInfo(list);

//测试PageInfo全部属性
//PageInfo包含了非常全面的分页属性
assertEquals(1, page.getPageNum());
assertEquals(10, page.getPageSize());
assertEquals(1, page.getStartRow());
assertEquals(10, page.getEndRow());
assertEquals(183, page.getTotal());
assertEquals(19, page.getPages());
assertEquals(1, page.getFirstPage());
assertEquals(8, page.getLastPage());
assertEquals(true, page.isFirstPage());
assertEquals(false, page.isLastPage());
assertEquals(false, page.isHasPreviousPage());
assertEquals(true, page.isHasNextPage());

//想要获取关于这个分页列表的什么数据，直接调用 PageInfo 的内置方法即可。