PageHelper的简单使用

PageHelper是mybatis框架的一个插件,用于支持在mybatis执行分页操作,使用非常方便,在这儿写一下基本的使用.

github文档地址:https://github.com/pagehelper/Mybatis-PageHelper/blob/master/wikis/zh/HowToUse.md

1.准备一个maven项目,导入相关依赖

Mybatis

log4j(可以在控制台查看sql语句的执行)

mysql-connector(mysql的驱动包)

lombok(用于生成setter,getter方法)

<!-- mybatis依赖 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.6</version>
        </dependency>

        <!-- mysql -->
        <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.18</version>
        </dependency>

        <!-- 日志依赖 -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>

        <!-- lombok -->
        <!-- https://mvnrepository.com/artifact/org.projectlombok/lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.16.20</version>
            <scope>provided</scope>
        </dependency>

       
        <!-- pageHelper依赖 -->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper</artifactId>
            <version>5.1.10</version>
        </dependency>

2.准备一张表

名为student,三个字段,id,name,age,准备一些数据

3,配置项目

首先在resources目录下,创建一个Mybatis-config.xml文件,用于做一些全局的mybatis基本的配置,例如数据库连接信息,事务,mapper映射文件路径,日志实现,类的别名,也包含了分页插件的基本配置

<configuration>
	<properties resource="db.properties" />
	<settings>
        <!--日志的实现是LOG4J-->
		<setting name="logImpl" value="LOG4J" />
	</settings>
	<typeAliases>
		<package name="com.ren.domain" />
	</typeAliases>
    <!--mybatis的插件配置-->
	<plugins>
		<!-- com.github.pagehelper为PageHelper类所在包名 -->
		<plugin interceptor="com.github.pagehelper.PageInterceptor">
			<!-- 表示使用mysql的分页方法 -->
			<property name="helperDialect" value="mysql" />
			<!-- 表示当页码长度为0 的时候,就不进行分页查询 -->
			<property name="pageSizeZero" value="true"/>
		</plugin>
	</plugins>
	
	<!-- 配置连接数据库四要素 -->
	<environments default="dev">
		<environment id="dev">
			<transactionManager type="JDBC" />
			<dataSource type="POOLED">
				<property name="driver" value="${driverClassName}" />
				<property name="url" value="${url}" />
				<property name="username" value="${username}" />
				<property name="password" value="${password}" />
			</dataSource>
		</environment>
	</environments>

	<mappers>
		<mapper resource="com/ren/mapper/StudentMapper.xml" />
	</mappers>
</configuration>

4.编写mapper,domain类

Student类,字段名和数据库表中对应的字段名尽量一致

5.首先做高级查询(条件查询)编写StudentMapper类和QueryObject类,在StudentMapper类中编写一个高级查询的方法,名为queryByConditions,根据姓名关键字和年龄范围查询,把查询条件封装到QueryObject类中.QueryObject类包括了姓名的关键字,年龄的范围,QueryObject类中的currentPage,和pageSize用于存储分页的条件

StudentMapper类:

QueryObject类:

编写StudentMapper对应的mapper文件.StudentMapper.xml

StudentMapper.xml中，需要写StudentMapper.java中queryConditions对应的查询sql语句

4.在mybatis中引入一段配置

<plugins>
    <!-- com.github.pagehelper为PageHelper类所在包名 -->
    <plugin interceptor="com.github.pagehelper.PageInterceptor">
        <!-- 使用什么数据库 -->
        <property name="helperDialect" value="mysql"/>
	</plugin>
</plugins>

5.编写分页的业务,IStudentService,以及实现类StudentServiceImpl,page(qo)方法最终返回一个PageInfo对象

IStudentService的实现类StudentServiceImpl

PageHelper库中中有一个核心类PageInfo封装查询的list,包含了分页信息(结果总数,当前页,上一页,下一页,当前页的结果集),还有一个PageHelper类,在分页查询之前使用PageHelper.startPage(当前页,每一页的条数),完成分页查询操作

调用自己的查询方法queryByConditions()方法查询出的list对象封装到PageInfo中即可完成,PageInfo中包括了分页的结果集

把高级查询返回的list对象(list对象)作为构造器参数传入PageInfo中,即可.

使用Junit5单元测试编写一个StudentMapperTest类

可以观察sql语句,在mapper文件中并没有写limit,pageHelper已经帮我们加上了limit关键字完成了查询.OK了