Spring集成PageHelper的简单用法

1、Maven依赖，注意使用PageHelper时的版本必须与Mybatis版本对应

         <!-- 添加Mybatis依赖 -->
         <dependency>
             <groupId>org.mybatis</groupId>
             <artifactId>mybatis</artifactId>
             <version>3.3.0</version>
         </dependency>
         <dependency>
             <groupId>org.mybatis</groupId>
             <artifactId>mybatis-spring</artifactId>
             <version>1.2.3</version>
         </dependency>
         <!-- pageHelper -->
         <dependency>
             <groupId>com.github.pagehelper</groupId>
             <artifactId>pagehelper</artifactId>
             <version>4.1.4</version>
         </dependency>

2、需要在Mybatis的配置信息中使用PageHelper插件，mybatis-config.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.PageHelper">
             <!--指明数据库 4.0.0以后不需要设置此属性-->
             <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"/>
             <!-- 设置为true时，如果pageSize=0或者RowBounds.limit = 0就会查询出全部的结果 -->
             <!-- （相当于没有执行分页查询，但是返回结果仍然是Page类型）-->
             <property name="pageSizeZero" value="true"/>
             <!-- 3.3.0版本可用 - 分页参数合理化，默认false禁用 -->
             <!-- 启用合理化时，如果pageNum<1会查询第一页，如果pageNum>pages会查询最后一页 -->
             <!-- 禁用合理化时，如果pageNum<1或pageNum>pages会返回空数据 -->
             <property name="reasonable" value="true"/>
             <!-- 3.5.0版本可用 - 为了支持startPage(Object params)方法 -->
             <!-- 增加了一个`params`参数来配置参数映射，用于从Map或ServletRequest中取值 -->
             <!-- 可以配置pageNum,pageSize,count,pageSizeZero,reasonable,orderBy,不配置映射的用默认值 -->
             <!-- 不理解该含义的前提下，不要随便复制该配置 -->
             <property name="params" value="pageNum=start;pageSize=limit;"/>
             <!-- 支持通过Mapper接口参数来传递分页参数 -->
             <property name="supportMethodsArguments" value="true"/>
             <!-- always总是返回PageInfo类型,check检查返回类型是否为PageInfo,none返回Page -->
             <property name="returnPageInfo" value="check"/>
         </plugin>
     </plugins>
 </configuration>

3、在配置Spring配置文件中，配置Mybatis的SqlSessionFactory时，需要把mybatis-config.xml添加到属性中

     <!-- SqlSessionFactory -->
     <bean id="sessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
         <!--设置数据源-->
         <property name="dataSource" ref="dataSource"></property>
         <!--设置映射文件-->
         <property name="mapperLocations" value="classpath:mybatis/sqlmap/mapper/*.xml"></property>
         <!--设置pageHelper-->
         <property name="configLocation" value="classpath:mybatis/mybatis-config.xml"></property>
     </bean>

4、使用Mybatis的mapper接口进行查询，在查询时，需要使用PageHelper.startPage方法

     @Test
     public void testSelectAll() {
         Page<Doctor> page = PageHelper.startPage(1, 3);
         //selectAll查询出的List即为上面定义的page
         doctorMapper.selectAll();
         //注意：
         //使用PageHelper.startPage只是针对接下来的一条查询语句，
         //如果又查询了一次数据，则还需要使用一次PageHelper.startPage
         logger.info("获取所有Doctor信息，获得记录数：{}", page.size());
         logger.info("获取所有Doctor信息，获得记录：{}", page);
         //使用PageInfo封装
         PageInfo<Doctor> info = new PageInfo<Doctor>(page);
         logger.info("info.getPages:{}",info.getPages());
     }

5、Page对象继承了ArrayList，因此在使用了PageHelper.startPage之后，Page即为查询到的数据，并且在Page中还额外封装了pageNum，pageSize等属性，还可以使用PageInfo封装Page，PageInfo中有更多的分页属性，例如isFirstPage是否为首页、isLastPage是否为末尾、hasNextPage是否存在下一页等。