美文网首页
MyBatis入门之分页插件PageHelper

MyBatis入门之分页插件PageHelper

作者: 80b7b6115d87 | 来源:发表于2017-11-10 11:32 被阅读288次

第一节. 项目前准备

1.PageHelper版本5.0.1
2.PageHelper官网地址
https://github.com/pagehelper/Mybatis-PageHelper/blob/master/README_zh.md

第二节. 创建项目

1.项目名称
mybatis-demo3

第三节. 添加依赖

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.4.5</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>6.0.6</version>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.1.4</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>4.3.12.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-tx</artifactId>
    <version>4.3.12.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>4.3.12.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-expression</artifactId>
    <version>4.3.12.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-test</artifactId>
    <version>4.3.12.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>1.3.1</version>
</dependency>
<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>5.0.1</version>
</dependency>
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-core</artifactId>
    <version>1.1.7</version>
</dependency>
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.1.7</version>
</dependency>

第四节. 数据库sql文件

CREATE DATABASE mybatis_demo default character set utf8;

CREATE TABLE user(
 id INT(11) PRIMARY KEY AUTO_INCREMENT,
 username VARCHAR(100) NOT NULL COMMENT '用户名',
 email VARCHAR(100) COMMENT '邮件地址',
 age INT(11) COMMENT '性别',
 gender tinyint(1) COMMENT '性别',
 create_time timestamp NULL DEFAULT NULL COMMENT '创建时间',
 update_time timestamp NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
)ENGINE=InnoDB AUTO_INCREMENT=1000 DEFAULT CHARSET=utf8 COMMENT='用户表';

第五节. 代码部分

0.创建包路径
cn.im.domain  存放映射数据库表的实体对象类
cn.im.mapper  存放操作数据库表的基础接口
1.创建映射数据库表的实体对象User
package cn.im.domain;
import java.util.Date;
/**
 * Created by mybatis-demo
 * Author: hushuang
 * Date: 2017/11/9
 * Time: 上午10:11
 * Email: hd1611756908@163.com
 * Description :创建映射数据库的实体对象
 */
public class User {
    //用户ID
    private Integer id;
    //用户名称
    private String username;
    //用户邮箱
    private String email;
    //用户年龄
    private int age;
    //用户性别
    private int gender;
    //创建时间
    private Date createTime;
    //更新时间
    private Date updateTime;
    public User() {
    }
    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getUsername() {
        return username;
    }
    public void setUsername(String username) {
        this.username = username;
    }
    public String getEmail() {
        return email;
    }
    public void setEmail(String email) {
        this.email = email;
    }
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
    public int getGender() {
        return gender;
    }
    public void setGender(int gender) {
        this.gender = gender;
    }
    public Date getCreateTime() {
        return createTime;
    }
    public void setCreateTime(Date createTime) {
        this.createTime = createTime;
    }
    public Date getUpdateTime() {
        return updateTime;
    }
    public void setUpdateTime(Date updateTime) {
        this.updateTime = updateTime;
    }
    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", email='" + email + '\'' +
                ", age=" + age +
                ", gender=" + gender +
                ", createTime=" + createTime +
                ", updateTime=" + updateTime +
                '}';
    }
}

2.创建操作映射数据库基础接口UserMapper
package cn.im.mapper;
import cn.im.domain.User;
import com.github.pagehelper.PageRowBounds;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.session.RowBounds;
import java.util.List;
/**
 * Created by mybatis-demo
 * Author: hushuang
 * Date: 2017/11/9
 * Time: 下午1:48
 * Email: hd1611756908@163.com
 * Description : 测试分页查询
 */
public interface UserMapper {
    /**
     * 按页查询用户信息
     * @return
     */
    List<User> findPageUser();
    /**
     * Mapper接口方式的调用,推荐这种使用方式
     * 这种查询方式需要在xml配置文件中配置配置参数信息
     * @param pageNumKey : 当前页
     * @param pageSizeKey : 每页查询的数量
     * @return : 用户列表信息
     */
    List<User> findPageByNumAndSize(@Param("pageNumKey") int pageNumKey, @Param("pageSizeKey") int pageSizeKey);
    /**
     * 采用接口方式的配置RowBounds参数
     * PageRowBounds 是继承 RowBounds的子类,因为RowBounds没有提供查询数量总数,但是PageRowBounds可以获取到
     * @param rowBounds
     * @return
     */
    List<User> findPageByRowNum(RowBounds rowBounds);
}

3.在resources文件夹下创建mapper文件夹用于存放映射接口的xml文件UserMapper.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.im.mapper.UserMapper">

    <select id="findPageUser" resultType="cn.im.domain.User">
        SELECT id,username,email,age,gender,create_time as createTime,update_time as updateTime FROM user
    </select>

    <select id="findPageByNumAndSize" resultType="cn.im.domain.User" parameterType="int">
        SELECT id,username,email,age,gender,create_time as createTime,update_time as updateTime FROM user
    </select>

    <select id="findPageByRowNum" resultType="cn.im.domain.User">
        SELECT id,username,email,age,gender,create_time as createTime,update_time as updateTime FROM user
    </select>
</mapper>
4.在resources文件夹下创建applicationContext.xml文件进行框架整合
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd
                           http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.3.xsd">


    <!-- 导入数据库连接池配置的属性文件 -->
    <context:property-placeholder location="classpath:db.properties" />

    <!-- 数据库连接池设置
         设置参考链接官网:https://github.com/alibaba/druid/wiki/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98
         下面的《9. Druid有没有参考配置》
         1.配置数据源Druid
     -->

    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"
          init-method="init" destroy-method="close">
        <!-- 基本属性 url、user、password -->
        <property name="url" value="${jdbc.url}" />
        <property name="username" value="${jdbc.username}" />
        <property name="password" value="${jdbc.password}" />

        <!-- 配置初始化大小、最小、最大 -->
        <property name="initialSize" value="1" />
        <property name="minIdle" value="1" />
        <property name="maxActive" value="20" />

        <!-- 配置获取连接等待超时的时间 -->
        <property name="maxWait" value="60000" />

        <!-- 配置间隔多久才进行一次检测,检测需要关闭的空闲连接,单位是毫秒 -->
        <property name="timeBetweenEvictionRunsMillis" value="60000" />

        <!-- 配置一个连接在池中最小生存的时间,单位是毫秒 -->
        <property name="minEvictableIdleTimeMillis" value="300000" />
        <property name="validationQuery" value="SELECT 'x'" />
        <property name="testWhileIdle" value="true" />
        <property name="testOnBorrow" value="false" />
        <property name="testOnReturn" value="false" />
        <!-- 打开PSCache,并且指定每个连接上PSCache的大小 -->
        <property name="poolPreparedStatements" value="false" />
        <property name="maxPoolPreparedStatementPerConnectionSize" value="20" />
        <!-- 配置监控统计拦截的filters -->
        <property name="filters" value="stat" />
    </bean>
    <!--
        2.注册sqlsessionFactory
        俗话说为什么这么配置,我是怎么知道这么配置的:追本溯源当然是mybatis-spring这个依赖提供的整合方式
        中文官网地址:http://www.mybatis.org/spring/zh/index.html    官网介绍了下面的 2 3 4 步,都在官网中。
    -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <!-- 装配druid数据源 -->
        <property name="dataSource" ref="dataSource"></property>
        <!-- 导入mybatis全局配置文件 -->
        <property name="configLocation" value="classpath:mybatis-config.xml"></property>
        <!-- 扫描entity包,使用别名 -->
        <property name="typeAliasesPackage" value="cn.im.domain"></property>
        <!-- 配置sql映射文件位置 -->
        <property name="mapperLocations" value="classpath:mapper/*.xml"></property>
    </bean>
    <!-- 3.注册dao接口,动态实现dao接口配置,注入到spring容器中 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <!-- 配置sqlSessionFactory -->
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
        <!-- 扫描mapper接口包,将里面的接口全部加入到IOC容器中 -->
        <property name="basePackage" value="cn.im.mapper"></property>
    </bean>
    <!-- 4.事务管理 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"></property>
    </bean>
    <!-- 5.开启基于注解的声明式事物 -->
    <tx:annotation-driven transaction-manager="transactionManager"/>
</beans>
5.在resources文件夹下创建db.properties文件用于保存数据库基础数据
#数据库基本配置
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://127.0.0.1:3306/mybatis_demo?useUnicode=true&characterEncoding=UTF-8&useSSL=false&allowMultiQueries=true
jdbc.username=root
jdbc.password=root
6.在resources文件夹下创建mybatis-config.xml配置文件,永不设置mybatis基本配置信息
<?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>
    <!-- mybatis的配置 -->

    
    <!-- 配置分页插件pageHelper -->
    <plugins>
        <plugin interceptor="com.github.pagehelper.PageInterceptor">
            <!--
                当 offsetAsPageNum=false 的时候,由于 PageNum 问题,
                RowBounds查询的时候 reasonable 会强制为 false。
                使用 PageHelper.startPage 方法不受影响
                所以我这里直接设置成true,防止造成reasonable属性失效
            -->
            <property name="offsetAsPageNum" value="true"></property>
            <!--

                参数设置的官网地址:https://github.com/pagehelper/Mybatis-PageHelper/blob/master/wikis/zh/HowToUse.md
                pageHelper提供了很多参数设置,可以根据自己的需求进行各种设置
                这里只设置了一个参数合理化设置的参数
                reasonable:当该参数设置为 true 时,pageNum<=0 时会查询第一页,
                            pageNum>pages(超过总数时),会查询最后一页。默认false 时,直接根据参数进行查询
            -->
            <property name="reasonable" value="true"></property>
            <!--
                为了支持startPage(Object params)方法,增加了该参数来配置参数映射,用于从对象中根据属性名取值,
                可以配置 pageNum,pageSize,count,pageSizeZero,reasonable,不配置映射的用默认值,
                默认值为pageNum=pageNum;pageSize=pageSize;
                count=countSql;reasonable=reasonable;pageSizeZero=pageSizeZero

                支持通过 Mapper 接口参数来传递分页参数,默认值false,分页插件会从查询方法的参数值中,
                自动根据上面 params 配置的字段中取值,查找到合适的值时就会自动分页

            -->
            <property name="supportMethodsArguments" value="true"></property>
            <property name="params" value="pageNum=pageNumKey;pageSize=pageSizeKey;"/>
        </plugin>
    </plugins>
</configuration>

第六节. 项目结构如图

image.png

 

*** 以上就是MyBatis的代码部分***

 

第七节. 测试代码如下UserMapperTest

package cn.im;

import cn.im.domain.User;
import cn.im.mapper.UserMapper;
import com.github.pagehelper.PageHelper;
import com.github.pagehelper.PageInfo;
import com.github.pagehelper.PageRowBounds;
import org.apache.ibatis.session.RowBounds;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

import java.util.List;

/**
 * Created by mybatis-demo
 * Author: hushuang
 * Date: 2017/11/10
 * Time: 上午9:38
 * Email: hd1611756908@163.com
 * Description : 分页插件的测试类
 */
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations = {"classpath:applicationContext.xml"})
public class UserMapperTest {

    /**
     * 日志slf4j
     */
    private static final Logger LOG = LoggerFactory.getLogger(UserMapperTest.class);
    @Autowired
    private UserMapper userMapper;

    /**
     * 方式一
     * Mapper接口方式的调用
     * 采用PageHelper.startPage(1, 10);方式调用
     * 使用方式如下
     */
    @Test
    public void testStartPage(){
        /*
            startPage方法的第一个参数为页码,第二个参数为每页显示数量
            查询语句必须紧跟着PageHelper.startPage(2, 1)后面,否则会报错
         */
        PageHelper.startPage(1, 2);
        List<User> pageUser = userMapper.findPageUser();
        for (User user : pageUser) {
            LOG.info("========={}",user);
        }
        LOG.info("查询数量为count={},pageUser={}",pageUser.size(),pageUser);

    }


    /**
     * 方式二
     * Mapper接口方式的调用
     * 采用PageHelper.offsetPage(1, 10);方式调用
     * 使用方式如下
     */
    @Test
    public void testOffsetPag(){
        /*
            offsetPage方法的第一个参数为页码,第二个参数为每页显示数量
            查询语句必须紧跟着PageHelper.offsetPage(2, 1)后面
            注意offsetPage 方法的第一页数据的当前页为0不是1,这点和startPage不同
         */
        PageHelper.offsetPage(0,1);
        List<User> pageUser = userMapper.findPageUser();
        for (User user : pageUser) {
            LOG.info("========={}",user);
        }
        LOG.info("查询数量为count={},pageUser={}",pageUser.size(),pageUser);

    }


    /**
     * 方式三 参数方法调用
     * Mapper接口中存在类似于
     * List<User> findPageByNumAndSize(@Param("pageNumKey") int pageNumKey, @Param("pageSizeKey") int pageSizeKey);
     * 的方法,只需要在xml配置文件中配置supportMethodsArguments=true即可,
     * 官网说还需要配置<property name="params" value="pageNum=pageNumKey;pageSize=pageSizeKey;"/>,
     * 但是我这里测试了一下,配置和不配置都是可以的,如果配置,注意参数的问题,要对应上
     * 使用方式如下
     */
    @Test
    public void testParmerPage(){

        List<User> pageUser = userMapper.findPageByNumAndSize(2,2);
        for (User user : pageUser) {
            LOG.info("========={}",user);
        }
        LOG.info("查询数量为count={},pageUser={}",pageUser.size(),pageUser);

    }

    /**
     * 方式四  RowBounds方式分页
     * 使用方式如下
     * 注意:RowBounds 这种接口查询方式返回数据中没有总记录数,
     * 官网说可以通过PageRowBounds对象获取,但是我这里没有获取到不知道是因为什么原因
     * 所以我这里不建议使用
     */
    @Test
    public void testRowNumPage(){

        PageRowBounds rowBounds = new PageRowBounds(1,2);
        List<User> pageUser = userMapper.findPageByRowNum(rowBounds);
        for (User user : pageUser) {
            LOG.info("========={}",user);
        }
        LOG.info("查询数量为count={},pageUser={}",pageUser.size(),pageUser);

    }


    /**
     * 方式四  PageInfo方式
     * 这种方式不属于分页,是一种封装分页的方式,
     * 就是说,将已经分页查询之后的数据进行再一次的封装,这样会获取到非常全面的分页属性
     * 使用方式如下
     */
    @Test
    public void testPageInfo(){

        List<User> pageUser = userMapper.findPageByNumAndSize(1,2);
        PageInfo page = new PageInfo(pageUser);

        LOG.info("PageNum={}",page.getPageNum());
        LOG.info("PageSize={}",page.getPageSize());
        LOG.info("Total={}",page.getTotal());
        LOG.info("Users={}",page.getList());
        //…………
    }
}

第八节. MyBatis基本总结

mybatis基本教程算是写完了没多少,mybatis框架不是很难,后面还会有一章来说一下mybatis的一些配置信息,主要用于实际项目中。写的不是很详细,如果有什么错误的地方欢迎大家指出,我这里会尽快作出修改,如果有什么不懂的地方,可以在下方评论,一起交流。

代码已经上传到github

git clone https://github.com/hd1611756908/mybatis-demo.git

下面的mybatis-demo3子项目

相关文章

网友评论

      本文标题:MyBatis入门之分页插件PageHelper

      本文链接:https://www.haomeiwen.com/subject/lifbmxtx.html