首页 > 代码库 > SpringMVC学习(四)——Spring、MyBatis和SpringMVC的整合

SpringMVC学习(四)——Spring、MyBatis和SpringMVC的整合

之前我整合了Spring和MyBatis这两个框架,不会的可以看我的文章MyBatis框架的学习(六)——MyBatis整合Spring。本文我再来讲SpringMVC和MyBatis整合开发的方法,这样的话,Spring、MyBatis和SpringMVC三大框架的整合开发我们就学会了。这里我使用的Spring是Spring4.1.3这个版本(SpringMVC自然也是这个版本),MyBatis是MyBatis3.2.7这个版本。 
为了更好的学习SpringMVC和MyBatis整合开发的方法,需要将SpringMVC和MyBatis进行整合。整合目标:控制层采用SpringMVC、持久层使用MyBatis实现。

需求

实现商品查询列表,从MySQL数据库表中查询商品信息。 
为了实现这个需求,我们需要新建一个数据库,例如springmvc,然后将以下sql脚本文件导入springmvc数据库中:

  • springmvc.sql:

    /*Navicat MySQL Data TransferSource Server         : localhost_3306Source Server Version : 50611Source Host           : localhost:3306Source Database       : springmvcTarget Server Type    : MYSQLTarget Server Version : 50611File Encoding         : 65001Date: 2016-05-09 19:45:13*/SET FOREIGN_KEY_CHECKS=0;-- ------------------------------ Table structure for items-- ----------------------------DROP TABLE IF EXISTS `items`;CREATE TABLE `items` (  `id` int(11) NOT NULL AUTO_INCREMENT,  `name` varchar(32) NOT NULL COMMENT ‘商品名称‘,  `price` float(10,1) NOT NULL COMMENT ‘商品定价‘,  `detail` text COMMENT ‘商品描述‘,  `pic` varchar(64) DEFAULT NULL COMMENT ‘商品图片‘,  `createtime` datetime NOT NULL COMMENT ‘生产日期‘,  PRIMARY KEY (`id`)) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8;-- ------------------------------ Records of items-- ----------------------------INSERT INTO `items` VALUES (‘1‘, ‘台式机‘, ‘3000.0‘, ‘该电脑质量非常好!!!!‘, null, ‘2016-02-03 13:22:53‘);INSERT INTO `items` VALUES (‘2‘, ‘笔记本‘, ‘6000.0‘, ‘笔记本性能好,质量好!!!!!‘, null, ‘2015-02-09 13:22:57‘);INSERT INTO `items` VALUES (‘3‘, ‘背包‘, ‘200.0‘, ‘名牌背包,容量大质量好!!!!‘, null, ‘2015-02-06 13:23:02‘);-- ------------------------------ Table structure for user-- ----------------------------DROP TABLE IF EXISTS `user`;CREATE TABLE `user` (  `id` int(11) NOT NULL AUTO_INCREMENT,  `username` varchar(32) NOT NULL COMMENT ‘用户名称‘,  `birthday` date DEFAULT NULL COMMENT ‘生日‘,  `sex` char(1) DEFAULT NULL COMMENT ‘性别‘,  `address` varchar(256) DEFAULT NULL COMMENT ‘地址‘,  PRIMARY KEY (`id`)) ENGINE=InnoDB AUTO_INCREMENT=27 DEFAULT CHARSET=utf8;-- ------------------------------ Records of user-- ----------------------------INSERT INTO `user` VALUES (‘1‘, ‘王五‘, null, ‘2‘, null);INSERT INTO `user` VALUES (‘10‘, ‘张三‘, ‘2014-07-10‘, ‘1‘, ‘北京市‘);INSERT INTO `user` VALUES (‘16‘, ‘张小明‘, null, ‘1‘, ‘河南郑州‘);INSERT INTO `user` VALUES (‘22‘, ‘陈小明‘, null, ‘1‘, ‘河南郑州‘);INSERT INTO `user` VALUES (‘24‘, ‘张三丰‘, null, ‘1‘, ‘河南郑州‘);INSERT INTO `user` VALUES (‘25‘, ‘陈小明‘, null, ‘1‘, ‘河南郑州‘);INSERT INTO `user` VALUES (‘26‘, ‘王五‘, null, null, null);

如此一来items表就是这样的: 
技术分享
由于需求决定,我们只对items表进行操作。

jar包管理

我之前有写过一篇Spring、Hibernate和Struts2整合的文章——hibernate-5.0.7+struts-2.3.24+spring-4.2.4三大框架整合,在整合的时候,我个人不喜欢乱,不喜欢啪叽一下将所有jar包往lib中一扔,因为那样没有条理,所以在整合SSM的时候,我还是遵循jar包分类的原则,首先看一下SSM整合都用到了哪些jar包:

  1. Spring(包括SpringMVC)所需jar包
  2. MyBatis所需jar包
  3. mybatis-spring整合包
  4. 数据库驱动包
  5. 第三方数据库连接池

这样一共需要31个jar包,我整理出来如下: 
技术分享
这里我用的是dbcp数据库连接池,当然也可以用c3p0等其他连接池,归归类后jar包就很有条理。

整合思路

关于SSM的架构可以简单看一下下面的草图: 
技术分享
可以看出,Spring在进行管理时,是很有条理的,每个层都由Spring管理,然后不同的层可以调用其它层,Handler调用service,service调用mapper等。根据这个架构,我们来总结一下整合的思路,根据这个调用关系,我们可以从下往上一步步整合。

  • Dao层 
    1. SqlMapConfig.xml,空文件即可。
    2. applicationContext-dao.xml 
      • a) 数据库连接池
      • b) SqlSessionFactory对象,需要Spring和MyBatis的整合包。
      • c) 配置mapper文件扫描器。
  • Service层 
    1. applicationContext-service.xml文件中配置包扫描器,扫描带@service注解的类。
    2. applicationContext-trans.xml文件中配置事务。
  • 表现层 
    1. 包扫描器,扫描带@Controller注解的类。
    2. 配置注解驱动。
    3. 配置视图解析器
  • web.xml 
    在web.xml文件中配置前端控制器。

现在思路清晰了,接下来就开始整合了。在整合前先看一下我整合完的工程结构: 
技术分享

整合Dao层

整合Dao层也就是整合持久层,那么需要Spring的核心包,持久层包,MyBatis包,数据库以及连接池的包。

MyBatis全局配置文件

在classpath下创建mybatis/sqlMapConfig.xml这样的MyBatis全局配置文件,如下:

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration></configuration>

可以看出,整合的时候,这个全局配置文件已经很清爽了,根本就没啥东东了,因为数据源啊、mapper啊啥的都交给Spring去管理了。

配置Spring配置文件

配置完MyBatis的全局配置文件后,接下来就要配置Spring的配置文件了,Spring的配置文件我将分类写在不同的文件中,都放在config/spring/目录下了,这里是对Dao的整合,所以起名applicationContext-dao.xml。

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"    xmlns:context="http://www.springframework.org/schema/context"     xmlns:p="http://www.springframework.org/schema/p"    xmlns:aop="http://www.springframework.org/schema/aop"     xmlns:tx="http://www.springframework.org/schema/tx"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd    http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-4.0.xsd">    <!-- 加载配置文件 -->    <context:property-placeholder location="classpath:db.properties" />    <!-- 数据库连接池 -->    <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"        destroy-method="close">        <property name="driverClassName" value=http://www.mamicode.com/"${jdbc.driver}" />        <property name="url" value=http://www.mamicode.com/"${jdbc.url}" />        <property name="username" value=http://www.mamicode.com/"${jdbc.username}" />        <property name="password" value=http://www.mamicode.com/"${jdbc.password}" />        <property name="maxActive" value=http://www.mamicode.com/"10" />        <property name="maxIdle" value=http://www.mamicode.com/"5" />    </bean>    <!-- mapper配置 -->    <!-- 让spring管理sqlsessionfactory 使用mybatis和spring整合包中的 -->    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">        <!-- 数据库连接池 -->        <property name="dataSource" ref="dataSource" />        <!-- 加载mybatis的全局配置文件,虽然这个全局配置文件是空的,但是这个全局配置文件是必不可少的 -->        <property name="configLocation" value=http://www.mamicode.com/"classpath:mybatis/SqlMapConfig.xml" />    </bean>    <!-- 配置Mapper扫描器 -->    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">        <property name="basePackage" value=http://www.mamicode.com/"com.itheima.springmvc.mapper"/>    </bean></beans>

注意:一定记得加载mybatis的全局配置文件,虽然这个全局配置文件是空的,但是这个全局配置文件是必不可少的。 
可以看出,整合Dao层的时候主要配置了一下数据源、sqlSessionFactory和mapper扫描器, 这样的话,数据源,sqlSessionFactory和mapper在tomcat启动时就被Spring实例化到了容器中。 
这儿db.properties该属性配置文件的内容为:

jdbc.driver=com.mysql.jdbc.Driverjdbc.url=jdbc:mysql://localhost:3306/springmvc?characterEncoding=utf-8jdbc.username=rootjdbc.password=yezi

整合Service层

先把jar包导了再说,整合Service层需要配置事务了。

配置applicationContext-service.xml

这里是第二个Spring的配置文件了,还是在config/spring文件夹下面,主要是用来配置所有的service的,如下:

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"    xmlns:context="http://www.springframework.org/schema/context"     xmlns:p="http://www.springframework.org/schema/p"    xmlns:aop="http://www.springframework.org/schema/aop"     xmlns:tx="http://www.springframework.org/schema/tx"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd    http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-4.0.xsd">    <!-- 配置包扫描器,扫描带@Service注解的类 -->    <context:component-scan base-package="com.itheima.springmvc.service"></context:component-scan></beans>

这儿只须配置包扫描器,专门扫描带@Service注解的类。

配置applicationContext-trans.xml

这里是第三个Spring的配置文件了,还是在config/spring文件夹下面,主要是用来配置Spring事务管理的,如下:

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"    xmlns:context="http://www.springframework.org/schema/context"     xmlns:p="http://www.springframework.org/schema/p"    xmlns:aop="http://www.springframework.org/schema/aop"     xmlns:tx="http://www.springframework.org/schema/tx"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd    http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-4.0.xsd">    <!-- 事务管理器,用的是Spring JDBC的事务管理器 -->    <bean id="transactionManager"        class="org.springframework.jdbc.datasource.DataSourceTransactionManager">        <!-- 数据源 -->        <property name="dataSource" ref="dataSource" />    </bean>    <!-- 通知 -->    <tx:advice id="txAdvice" transaction-manager="transactionManager">        <tx:attributes>            <!-- 传播行为 -->            <tx:method name="save*" propagation="REQUIRED" />            <tx:method name="insert*" propagation="REQUIRED" />            <tx:method name="delete*" propagation="REQUIRED" />            <tx:method name="update*" propagation="REQUIRED" />            <tx:method name="find*" propagation="SUPPORTS" read-only="true" />            <tx:method name="get*" propagation="SUPPORTS" read-only="true" />        </tx:attributes>    </tx:advice>    <!-- 切面 -->    <aop:config>        <aop:advisor advice-ref="txAdvice"            pointcut="execution(* com.itheima.springmvc.service.*.*(..))" />    </aop:config></beans>

有关Spring中事务的传播行为,我也不是特别了解。也只是听说过一嘴,先记录如下:

  • propagation=”REQUIRED”:如果当前方法执行的时候,没有事务要开启事务,如果有事务,就在当前事务中执行。也可理解为当前方法被调用的时候没有事务传递进来,就自己开启事务
  • propagation=”SUPPORTS”:如果当前方法执行的时候,如果有事务,就在当前事务中执行,如果没有事务就不开启事务。也可理解为当前方法被调用的时候没有事务传递进来,自己不开启事务

整合表现层

上面提到过,SpringMVC是Spring的一个模块,所以不需要整合,我们只需要加入SpringMVC所需的jar包即可。

配置处理器映射器、处理器适配器和视图解析器

这里使用注解的方式配置,因为注解的方式比较简单。如此一来SpringMVC配置文件——springmvc.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:p="http://www.springframework.org/schema/p"    xmlns:context="http://www.springframework.org/schema/context"    xmlns:mvc="http://www.springframework.org/schema/mvc"    xsi:schemaLocation="        http://www.springframework.org/schema/beans         http://www.springframework.org/schema/beans/spring-beans-4.0.xsd        http://www.springframework.org/schema/mvc         http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd        http://www.springframework.org/schema/context         http://www.springframework.org/schema/context/spring-context-4.0.xsd">    <context:component-scan base-package="com.itheima.springmvc.controller"/>    <!-- 配置一个注解驱动,如果配置此标签,那么就可以不用配置处理器映射器和处理器适配器 -->    <mvc:annotation-driven />    <!-- 配置视图解析器 -->    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">        <property name="prefix" value=http://www.mamicode.com/"/WEB-INF/jsp/"></property>        <property name="suffix" value=http://www.mamicode.com/".jsp"></property>    </bean></beans>

该配置文件依然在config/spring文件夹下面。

配置前端控制器

前端控制器要配置在WEB-INF/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"    id="WebApp_ID" version="2.5">    <display-name>springmvc-web</display-name>    <welcome-file-list>        <welcome-file>index.html</welcome-file>        <welcome-file>index.htm</welcome-file>        <welcome-file>index.jsp</welcome-file>        <welcome-file>default.html</welcome-file>        <welcome-file>default.htm</welcome-file>        <welcome-file>default.jsp</welcome-file>    </welcome-file-list>    <!-- 配置前端控制器 -->    <servlet>        <servlet-name>springmvc</servlet-name>        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>        <init-param>            <!-- 指定springmvc配置文件的路径。如果不指定,默认为:/WEB-INF/${servlet-name}-servlet.xml -->            <param-name>contextConfigLocation</param-name>            <param-value>classpath:spring/springmvc.xml</param-value>        </init-param>    </servlet>    <servlet-mapping>        <servlet-name>springmvc</servlet-name>        <url-pattern>*.action</url-pattern>    </servlet-mapping></web-app>

加载Spring容器

注意千万不要忘记了在web.xml中添加Spring容器监听器,加载Spring容器:

<!-- 初始化Spring容器 --><context-param>    <param-name>contextConfigLocation</param-name>    <param-value>classpath:spring/applicationContext-*.xml</param-value></context-param><listener>    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class></listener>

到此为止,Spring、MyBatis和SpringMVC三大框架就整合完了。整合完之后,接着就来实现我们的需求——商品列表的展示。

商品列表的展示

Dao层代码的编写,借助逆向工程生成po类及mapper

关于如何使用MyBatis的逆向工程我就不再赘述了,如果不太清楚的童鞋请看一下我的这篇文章——MyBatis框架的学习(七)——MyBatis逆向工程自动生成代码!将生成的代码拷贝到我们自己的工程中即可,如下: 
技术分享

Service层代码的编写

之前提到过,service是用来调用mapper的,mapper是用来操作数据库的,所以在Service层,我们首先要获取mapper接口的代理对象,只不过在这里我们通过Spring注入进来,然后通过这个代理对象去操作数据库。 
【第一步】,首先在com.itheima.springmvc.service包下编写一个ItemService接口,如下:

public interface ItemService {    List<Items> getItemList();}

可以看出,这个接口和上面那个mapper接口其实是一样的,当然并不是说一定一样,只不过这里要实现的逻辑都一样而已。 
【第二步】,在com.itheima.springmvc.service.impl包下编写ItemService接口的实现类——ItemServiceImpl.java,如下:

@Servicepublic class ItemServiceImpl implements ItemService {    @Autowired    private ItemsMapper itemsMapper;    @Override    public List<Items> getItemList() {        ItemsExample example = new ItemsExample();        List<Items> list = itemsMapper.selectByExampleWithBLOBs(example);        return list;    }}

注意:selectByExampleWithBLOBs指代带大文本那一列(即detail列)的方法。从items这个数据库表的建表语句中可看出detail这列的数据类型是text,如下: 
技术分享

Web层代码的编写

在com.itheima.springmvc.controller包下编写一个Controller类,如下:

@Controllerpublic class ItemController {    @Autowired    private ItemService itemService;    @RequestMapping("/itemList")    public ModelAndView getItemsList() {        // 查询商品列表        List<Items> itemList = itemService.getItemList();        // 把查询结果传递给页面        ModelAndView modelAndView = new ModelAndView();        modelAndView.addObject("itemList", itemList); // addObject方法相当于放到request域上        // 设置逻辑视图        modelAndView.setViewName("itemList");         // 返回结果        return modelAndView;    }}

前台itemList.jsp页面还是第一篇博文中写的那个,没有变,就不写了。

测试

最后在浏览器地址栏中输入url地址——http://localhost:8080/springmvc-web/itemList.action,回车,即可看到如下效果: 
技术分享
这已然充分说明Spring、MyBatis和SpringMVC这三大框架就整合成功了!!!事实雄于一切。读者如需源码,可点击SpringMVC学习(四)——Spring、MyBatis和SpringMVC的整合进行下载!

SpringMVC学习(四)——Spring、MyBatis和SpringMVC的整合