使用MyBatis的分页插件PageHelper进行分页查询(PS:重新整理一份完整的SSM搭建过程以及各个基础配置文件)

说明:没有实际项目来练手,所以最近总是动看一点西学一点。。前几天学了一个分页插件,发现跟自己写分页逻辑比起来简直是简单的不行。然后现在想起来就顺便将其整理出来,并且完整的搭建一遍SSM框架的基础环境,这样以后如果需要搭建SSM的框架就直接来这里参考即可,就不用每次搭建都要重新拼凑了。。。。

===========================================

===========================================

1.首先使用的是maven工具,这里先将需要的依赖包添加进来,不够的后面再添加。。顺便一提的是找jar包到http://mvnrepository.com/

pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.lin</groupId>
  <artifactId>PageHelper</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>

  <!-- 引入依赖的jar包 -->
  <dependencies>
  	
  	<!-- Spring Begin -->
	<dependency>
	    <groupId>org.springframework</groupId>
	    <artifactId>spring-webmvc</artifactId>
	    <version>4.3.7.RELEASE</version>
	</dependency>
	<dependency>
	    <groupId>org.springframework</groupId>
	    <artifactId>spring-jdbc</artifactId>
	    <version>4.3.7.RELEASE</version>
	</dependency>
	<!-- Spring的面向切面编程 -->
	<dependency>
	    <groupId>org.springframework</groupId>
	    <artifactId>spring-aspects</artifactId>
	    <version>4.3.7.RELEASE</version>
	</dependency>
	<!-- Spring test模块 -->
	<dependency>
	    <groupId>org.springframework</groupId>
	    <artifactId>spring-test</artifactId>
	    <version>4.3.7.RELEASE</version>
	    <scope>test</scope>
	</dependency>	
	<!-- Spring End -->
	
	<!-- MyBatis Begin -->
	<dependency>
	    <groupId>org.mybatis</groupId>
	    <artifactId>mybatis</artifactId>
	    <version>3.4.5</version>
	</dependency>
	<!-- MyBati Generator逆向工程(代码生成器) -->
	<dependency>
	    <groupId>org.mybatis.generator</groupId>
	    <artifactId>mybatis-generator-core</artifactId>
	    <version>1.3.5</version>
	</dependency>
  	<!-- MyBatis整合Spring的适配包 -->
	<dependency>
	    <groupId>org.mybatis</groupId>
	    <artifactId>mybatis-spring</artifactId>
	    <version>1.3.1</version>
	</dependency>	
  	<!-- 引入MyBatis的pagehelper分页插件 
  		然后需要在mybatis全局配置文件中注册这个分页插件
  	-->
  	<dependency>
	    <groupId>com.github.pagehelper</groupId>
	    <artifactId>pagehelper</artifactId>
	    <version>5.0.0</version>
	</dependency>	
	<!-- MyBatis End -->
	
  	<!-- 数据库连接池 -->
	<dependency>
		<groupId>com.mchange</groupId>
		<artifactId>c3p0</artifactId>
		<version>0.9.5.2</version>
	</dependency>
  	
  	<!-- MySQL驱动包 -->
	<dependency>
	    <groupId>mysql</groupId>
	    <artifactId>mysql-connector-java</artifactId>
	    <version>5.1.41</version>
	</dependency>
  	
  	<!-- jstl、servlet-api、junit -->
	<dependency>
	    <groupId>javax.servlet</groupId>
	    <artifactId>jstl</artifactId>
	    <version>1.2</version>
	</dependency>
  	
	<dependency>
	    <groupId>javax.servlet</groupId>
	    <artifactId>javax.servlet-api</artifactId>
	    <version>4.0.1</version>
	    <scope>provided</scope>
	</dependency>

	<dependency>
	    <groupId>junit</groupId>
	    <artifactId>junit-dep</artifactId>
	    <version>4.10</version>
	    <scope>test</scope>
	</dependency>
	
  </dependencies> 
  
  
<!-- 添加项目jdk编译插件 -->  
  <build>  
    <!-- 设置编译版本为1.8 -->  
    <plugins>  
        <plugin>  
            <groupId>org.apache.maven.plugins</groupId>  
            <artifactId>maven-compiler-plugin</artifactId>  
            <configuration>  
                <source>1.8</source>  
                <target>1.8</target>  
                <encoding>UTF-8</encoding>  
            </configuration>  
        </plugin>   
    </plugins>  
  </build>  
</project>

---------------------------------------------------------------------------------

2.然后开始Spring和MyBatis的整合

1)先向数据库中插入几条数据

2)实体类User.java

package com.lin.domain;

public class User {

	private int id;
	private String name;
	private String address;
	
	public User() {
		super();
	}
	public User(int id, String name, String address) {
		super();
		this.id = id;
		this.name = name;
		this.address = address;
	}
	
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public String getAddress() {
		return address;
	}
	public void setAddress(String address) {
		this.address = address;
	}

}

 

3)实体类的映射文件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接口对应-->
<mapper namespace="com.lin.dao.UserMapper">    

	<!--注意id名,以及parameterType、resultType要与mapper接口对应,这样mybatis才能使用代理方式开发-->     
 	<select id="findAll" resultType="com.lin.domain.User">
        select * from table_user
    </select>

</mapper>

这里需要强调一下,若想让mybatis自动的用代理的方式开发,那就需要我们遵守一下编写的规范:

 

Mapper开发规范

想要Mybatis帮我们自动生成Mapper代理的话,我们需要遵循以下的规范:

1、mapper.xml中namespace指定为mapper接口的全限定名

此步骤目的:通过mapper.xml和mapper.java进行关联。

2、mapper.xml中statement的id就是mapper.java中方法名

3、mapper.xml中statement的parameterType和mapper.java中方法输入参数类型一致

4、mapper.xml中statement的resultType和mapper.java中方法返回值类型一致.

再次说明:statement就是我们在mapper.xml文件中命名空间+sql指定的id

4)mapper接口UserMapper.java

package com.lin.dao;

import java.util.List;
import com.lin.domain.User;

public interface UserMapper {

	public List<User> findAll();
	
}

5)用Spring整合mybatis。。applicationContext.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	   xmlns:mybatis="http://mybatis.org/schema/mybatis-spring"
	   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	   xmlns:p="http://www.springframework.org/schema/p"
	   xmlns:mvc="http://www.springframework.org/schema/mvc"
	   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/mvc
	   					   http://www.springframework.org/schema/mvc/spring-mvc.xsd
	   					   http://www.springframework.org/schema/context
	   					   http://www.springframework.org/schema/context/spring-context.xsd
	   					   http://www.springframework.org/schema/tx
	   					   http://www.springframework.org/schema/tx/spring-tx.xsd
	   					   http://mybatis.org/schema/mybatis-spring
	   					   http://mybatis.org/schema/mybatis-spring.xsd">
	
	<!-- 扫描com.lin包下面的java文件,有Spring的相关注解的类,则把这些类注册为Spring的bean -->
	<context:component-scan base-package="'com.lin"/>

	<!-- mybatis:scan会将com.lin.mapper包里面的所有接口当作mapper配置,之后可以自动引入mapper类 -->
	<mybatis:scan base-package="com.lin.dao"/>

	<!-- 加载数据源相关的配置文件 -->	
	<context:property-override location="classpath:db.properties"/>
	<!-- 配置C3P0数据源 -->
	<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
		<property name="driverClass" value="${dataSource.driverClass}"/>
		<property name="jdbcUrl" value="${dataSource.jdbcUrl}"/>
		<property name="user" value="${dataSource.user}"/>
		<property name="password" value="${dataSource.password}"/>
	</bean>

	<!-- 配置SQLSessionFactory,它是Mybatis社区开发用于整合Spring的bean -->
	<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean" 
		p:dataSource-ref="dataSource">
        <!-- 如果mapper映射文件和mapper接口不是放在同一个文件夹下,那么就需要写以下这段配置,用来查找mapper映射文件所在位置 -->
		<!--<property name="mapperLocations" value="classpath:mapping/*Mapper.xml">--></property>
<!-- 以下这个加载的是mybatis的全局配置文件,不要跟上面这句话搞混了 -->
		<!-- <property name="configLocation" value="classpath:sqlMapConfig.xml"></property> -->
    </bean>
		
	<!-- JDBC事务管理器 -->
	<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"
		p:dataSource-ref="dataSource"/>
	<!-- 启用支持annotation注解方式事务管理 -->
	<tx:annotation-driven transaction-manager="transactionManager" />

</beans>

6)数据库连接db.properties(注意,每一段后面都不要有多余的空格,否则会加载时会把空格也当成连接条件,导致数据库连不上)

dataSource.driverClass=com.mysql.jdbc.Driver
dataSource.jdbcUrl=jdbc:mysql://localhost:3306/maven
dataSource.user=root
dataSource.password=546784

7)最后写一个测试类,测试一下spring和mybatis是否整合通过

public class FindAllUserTest {

	@Test
	public void findAllTest(){
		ApplicationContext context = new ClassPathXmlApplicationContext("classpath:spring/applicationContext.xml");
		UserMapper userMapper = context.getBean(UserMapper.class);
		List<User> list = userMapper.findAll();
		
		for(User user:list){
			System.out.println(user.getName() +" " + user.getAddress());
		}
	}
}

8)结果:(测试通过。这表示spring和mybatis整合完成了。。接下来只需要添加spring的web模块就可以了)

9)题外话:在上面测试的时候我遇到一个问题,就是在配置数据源时遇到的

applicationContext.xml

db.properties

遇到的问题是,这个名字的问题,就是比如两边的dataSource.driverClass都换成jdbc.driverClass就会出现如下异常

正常应该是可以的,只是一个名字而已,又没有什么特殊含义。。但是后来经过排查发现了这个问题,虽然避开了这个问题后来改成dataSource就可以了,但是具体原因我还是暂未查到。。。

----------------------------------------------------------------------------------------

3.添加spring的web模块

1)首先就是在web.xml配置前端控制器

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">
  <display-name>PageHelper</display-name>

  <!-- 配置Spring核心监听器,如果不指定配置文件,则会默认从/WEB-INF/applicationContext.xml作为配置文件 -->
  <listener>
  	<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>
  <!-- contextConfigLocation -->
  <context-param>
  	<param-name>contextConfigLocation</param-name>
  	<param-value>classpath:spring/applicationContext.xml</param-value>
  </context-param>
  
  
  <!-- 定义Spring MVC的前端控制器 -->
  <servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>
        org.springframework.web.servlet.DispatcherServlet
    </servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring/springmvc-config.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  
  <!-- 让Spring MVC的前端控制器拦截所有请求 -->
  <servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
  
  <!-- 编码过滤器 -->
  <filter>
	<filter-name>characterEncodingFilter</filter-name>
	<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
	<init-param>
		<param-name>encoding</param-name>
		<param-value>UTF-8</param-value>
	</init-param>
   </filter>
   <filter-mapping>
		<filter-name>characterEncodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

</web-app>

2)springMVC的配置文件springmvc-config.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	   xmlns:mybatis="http://mybatis.org/schema/mybatis-spring"
	   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	   xmlns:p="http://www.springframework.org/schema/p"
	   xmlns:mvc="http://www.springframework.org/schema/mvc"
	   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/mvc
	   					   http://www.springframework.org/schema/mvc/spring-mvc.xsd
	   					   http://www.springframework.org/schema/context
	   					   http://www.springframework.org/schema/context/spring-context.xsd
	   					   http://www.springframework.org/schema/tx
	   					   http://www.springframework.org/schema/tx/spring-tx.xsd
	   					   http://mybatis.org/schema/mybatis-spring
	   					   http://mybatis.org/schema/mybatis-spring.xsd">


	<!-- 自动扫描该包,SpringMVC会将包下用@Controller注解的类注册为Spring的controller -->
	<context:component-scan base-package="com.lin"/>
	
	<!--两个标准配置  -->
	<!-- 将springmvc不能处理的请求交给tomcat -->
	<mvc:default-servlet-handler/>
	<!-- 能支持springmvc更高级的一些功能,JSR303校验,快捷的ajax...映射动态请求 -->
	<mvc:annotation-driven/>
	
	<!-- 视图解析器 -->
	<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<!-- 前缀 -->
		<property name="prefix">
			<value>/WEB-INF/content/</value>
		</property>
		<!-- 后缀 -->
		<property name="suffix">
			<value>.jsp</value>
		</property>
	</bean>
	

</beans>

3)springmvc的环境加载好之后就是编写service层来调用我们前面已经测试通过的dao层(ps:在实际项目开发中为了程序的扩展性以及维护性,一般都是写成接口的,但是我们在测试测试过程中为了方便,所以直接以类的方式编写了。)

UserService.java

package com.lin.service;

import java.util.List;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import com.lin.dao.UserMapper;
import com.lin.domain.User;

@Service
public class UserService {

	@Autowired
	UserMapper userMapper;
	
	public List<User> fingAllUser(){
		return userMapper.findAll();
	}
}

4)service完了以后就是控制器了UserController.java(PS:这里也体现了我们本案例的核心部分--使用mybatis的分页插件进行分页处理,看以下代码可以发现非常的简洁,而且功能完善!可以参照官网文档https://github.com/pagehelper/Mybatis-PageHelper/blob/master/wikis/zh/HowToUse.md。。本人在之前的文章中也有将使用springmvc方式记录过分页的逻辑实现,具体参照‘在SpringMVC中的分页查询’相比可以发现这个插件是真的好用。。)

package com.lin.controller;

import java.util.List;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

import com.github.pagehelper.PageHelper;
import com.github.pagehelper.PageInfo;
import com.lin.domain.User;
import com.lin.service.UserService;

@Controller
public class UserController {

	@Autowired
	UserService userService;
	
	@RequestMapping("/findusers")
	public String findusers(@RequestParam(value="pn",defaultValue="1")Integer pn,Model model){
		//引入PageHelper分页插件  
		//在查询之前只需要调用,传入页码以及每页的大小
		PageHelper.startPage(pn,3);
		//startPage后面紧跟着的这个查询就是一个分页查询
		List<User> users = userService.fingAllUser();
		//使用PageInfo来包装查询的后的结果,只需要将PageInfo交给页面就行了
//		//封装了详细的分页所需的各种信息,包括有我们查询出来的数据
//		PageInfo page = new PageInfo(users);
		//封装了详细的分页所需的各种信息,包括有我们查询出来的数据,传入连续显示的页数
		PageInfo page = new PageInfo(users,5);
		model.addAttribute("pageInfo", page);
		
		System.out.println(page.getPageNum()+""+page.getPages()+""+page.getTotal());
		
		return "list";
	}
	
}

5)然后就是测试这个分页插件的使用了,这里提供一个页面来显示做分页所需的几个基本字段即可,关于页面展示部分肯定是要交给前台美工人员的,这个我实在是做不到。

list.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>分页测试页面</title>
</head>
<body>
<table>
	<tr>
		<td>当前页码:</td>
		<td>${pageInfo.pageNum }</td>
	</tr>
	<tr>
		<td>总页码:</td>
		<td>${pageInfo.pages }</td>
	</tr>
	<tr>
		<td>总记录数:</td>
		<td>${pageInfo.total }</td>
	</tr>
	<c:forEach items="${pageInfo.list}" var="user">
		<tr>  
			<td>${user.name}</td>  
			<td>${user.address}</td>
		</tr>
	</c:forEach>
</table>
</body>
</html>

6)以上代码测试了好久,发现数据能传到前台,但是不知道为什么总是显示第一页数据,而且根本没有给我分页,不管我设置每一页显示多少内容。但是总数又是没有错的,所以我找了又找,最好终于发现问题,原来是我根本就没有去注册这个插件(此处手动哭泣),哇靠这个找了我好久。。今天大半天都花在调试这个案例以及记录了(边编码实现,边做笔记…)。。。。好了,废话不多说,这个注册我们放在mybatis的全局配置文件中配置:

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>
	<settings>
		<setting name="mapUnderscoreToCamelCase" value="true"/>
	</settings>
	
	<typeAliases>
		<package name="com.atguigu.crud.bean"/>
	</typeAliases>
	
	<!-- 注册pagehelper分页插件  -->
	<plugins>
		<plugin interceptor="com.github.pagehelper.PageInterceptor"/>
	</plugins>

</configuration>

7)配置了mybatis全局配置文件后,当然不要忘记在applicationContext.xml中配置加载mybatis的配置文件,在applicationContext.xml配置文件中的如下位置加入配置即可

----------------------------------------------------------------------------

----------------------------------------------------------------------------

4.部署测试

在测试之前我又往数据库中添加了几条记录

 

然后打开浏览器测试,要访问哪一页的数据,只要在链接后面换数字即可。下面获取到了当前页码、总页数、总记录数、以及访问的当前页的数据。。ok,虽然难看,但是分页功能已经实现。。。。

================================================

================================================

差点忘了,附上项目结构

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值