Mybatis系列Spring & Mybatis整合
Posted 禹爸爸
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Mybatis系列Spring & Mybatis整合相关的知识，希望对你有一定的参考价值。
Mybatis系列之Spring & Mybatis整合
引言
前面用了八篇博客简单的向大家介绍了Mybatis的基础知识及简单用例。了解了这些知识后，还差最后一招，我们就可以修炼好独孤九剑，进入到更高一层的武艺境界 －－SSM（Spring + Spring MVC + Mybatis）开发阶段了。
关于Spring及Spring MVC的基础概念这里就不再赘述了。不了解的，大家可以通过度娘谷哥自行脑补。
开发环境
IDE: STS（Spring Tools Suite）官网网址：http://spring.io/tools/sts
Spring Framework: 3.1.1.RELEASE
Mybatis Version: 3.3.0
Mybatis-Spring: 1.2.3
创建Spring MVC项目
强烈推荐大家使用STS进行Spring项目的开发，她对Spring及Maven集存的非常好，轻松两步就可以创建一个Spring MVC项目：
- 点击新建按钮，在新建向导中选择Spring Project，点击下一步
- 选择Spring MVC Project，输入项目名称，点击完成
是不是很easy呀！项目创建好之后，还要完成一个动作，就是右击项目名称，选择Run As..菜单下的Maven Install，这样就可以把项目依赖的Jar包下载到本地了。新创建的项目目录结构如下图所示（请忽略src/main/java目录下的包及文件，这是最终完成后的项目结构）。
引入Jar包
在Maven的项目管理文件pom.xml中加入以下依赖即可。
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>3.1.1 RELEASE</version>
<exclusions>
<!-- Exclude Commons Logging in favor of SLF4j -->
<exclusion>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>3.1.1 RELEASE</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.36</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>4.2.1.RELEASE</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId>
<version>1.2.3</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.3.0</version>
</dependency>
Spring与Mybatis整合
将所需Jar包导入之后，就可以着手将Spring与Mybatis进行整合（请注意，这里是将Spring与Mybatis进行整合，现在还没有涉及到Spring MVC）。这里我们使用了JUnit，每做一次整合，我们都需要进行测试，以确保向前走的每一小步都是正确的。
我们在src/main/resources目录下创建一个名为spring-mybatis.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-3.1.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.1.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">
<context:component-scan base-package="com.emerson.suzhou" />
<bean id="dataSource"
class="org.springframework.jdbc.datasource.DriverManagerDataSource" >
<property name="driverClassName" value="com.mysql.jdbc.Driver" />
<property name="url" value="jdbc:mysql://127.0.0.1:3306/your_database" />
<property name="username" value="your_username" />
<property name="password" value="your_password" />
</bean>
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
<!-- 自动扫描mapping.xml文件 -->
<property name="mapperLocations" value="classpath:com/emerson/suzhou/mapping/*.xml"></property>
<propertyname="configLocation"value="classpath:mybatis-config.xml"></property>
</bean>
<!-- DAO接口所在包名，Spring会自动查找其下的类 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.emerson.suzhou.dao" />
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
</bean>
<!-- (事务管理)transaction manager, use JtaTransactionManager for global tx -->
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>
</beans> 在这个配置文件中，我们指定了：
- 数据源：用于连接目标数据库
- Spring扫描路径：会扫描指定路径下的所有Component，为后面的依赖注入做准备。如果我们需要对Mybatis进行一些特别设置，可以在这里指定配置文件的路径
- 映射文件路径：Mybatis会在指定路径加下加载数据表是映射文件
- Dao接口包名称：对应着每个数据表的映射文件，我们都会为其编写一个接口（请参见《Mybatis系列（六）接口式编程》）
ok，这个文件编写好之后，千万不要忘记在web.xml中指定spring-mybatis配置文件的位置！！这一步至关重要。否则在运行程序时会报出“creat bean error.....”的错误信息。
<!-- spring-mybatis configuration file location -->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring-mybatis.xml</param-value>
</context-param>
补充一句，STS自动生成的web.xml文件已经指定了root-context.xml文件位置，我们也可以把spring-mybatis.xml文件的内容全部搬到root-context.xml文件中，这样就不用添加下面这段代码了。
之后，我们就可以测试一下Spring与Mybatis是否可以正确的整合在一起。我继续使用在《Mybatis系列之简单示例》中使用的数据库进行测试。
在scr/main/java创建如下包：
com.emerson.suzhou.controller：存放控制器（后面测试Spring MVC时使用）
com.emerson.suzhou.dao：存放与映射文件相对应的接口文件
com.emerson.suzhou.mapping：存放数据表映射文件
com.emerson.suzhou.pojo：存放数据表实体类
com.emerson.suzhou.service：用在Controller与Dao之间的Service接口文件
com.emerson.suzou.service.impl：Service接口实现
数据表实体类文件内容如下。
package com.emerson.suzhou.pojo;
import java.sql.Timestamp;
public class User
/**
*
*/
private int userId;
/**
*
*/
private String userPassword;
/**
*
*/
private String userName;
/**
*
*/
private String nickName;
/**
*
*/
private String email;
/**
*
*/
private int isValid;
/**
*
*/
private Timestamp createdTime;
/**
*
*/
private Timestamp updateTime;
//setter , getter ...
<?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="com.emerson.suzhou.dao.IUserDao"> <sql id="columns">user_id, user_name, user_password, nick_name, email, is_valid, created_time, update_time </sql> <resultMap id="userResult" type="com.emerson.suzhou.pojo.User"> <id property="userId" column="user_id" /> <result property="userName" column="user_name" /> <result property="userPassword" column="user_password" /> <result property="nickName" column="nick_name" /> <result property="email" column="email" /> <result property="isValid" column="is_valid" /> <result property="createdTime" column="created_time" /> <result property="updateTime" column="update_time" /> </resultMap> <!-- 根据传入的Id值，到数据库中查询记录 --> <select id="getById" parameterType="int" resultMap="userResult"> SELECT <include refid="columns"></include> FROM sys_user WHERE user_id = #id </select> </mapper>接口文件。请注意，接口中定义的方法名称及参数，需要与映射文件中相应元素的id值相同。
package com.emerson.suzhou.dao;
import com.emerson.suzhou.pojo.User;
public interface IUserDao
public User getById(int id);
package com.emerson.suzhou.service;
import com.emerson.suzhou.pojo.User;
public interface IUserService
public User getById(int id);
服务接口实现文件如下。这里一定要使用Service注解标注。
package com.emerson.suzhou.service.impl;
import javax.annotation.Resource;
import org.springframework.stereotype.Service;
import com.emerson.suzhou.dao.IUserDao;
import com.emerson.suzhou.pojo.User;
import com.emerson.suzhou.service.IUserService;
@Service("userService")
public class UserSerivceImpl implements IUserService
@Resource
private IUserDao dao;
@Override
public User getById(int id)
return this.dao.getById(id);
这些准备工作完成之后，我们就可以开始编写测试代码了。在scr/test/java/下创建测试文件，内容如下。
package com.emerson.suzhou;
import static org.junit.Assert.*;
import javax.annotation.Resource;
import org.apache.log4j.Logger;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import com.emerson.suzhou.pojo.User;
import com.emerson.suzhou.service.IUserService;
public class TestMybatis
private static Logger logger = Logger.getLogger(TestMybatis.class);
@Resource
private IUserService userService = null;
@Before
public void setUp() throws Exception
@After
public void tearDown() throws Exception
@Test
public void test()
assertNotNull(userService);
User user = userService.getById(1);
logger.info(user);
如果在控制台看到数据表中查询到的内容输出，表示我们的配置是正确的。
目前，我们已经将Spring与Mybatis成功的整合在一起了，下面开始将Spring MVC也加入进来。
Spring MVC，来吧
STS在为我们创建Spring MVC项目时，已经自动生成了关于Spring MVC的配置文件，存放在src/main/webapp/WEB-INF/spring目录下，一个是root-context.xml，另一个是在其子目录appServlet下的servlet-context.xml。这两个配置文件的作用级别不同，一个是作用在事个项目上的，另一个则是仅作用在appServer上的（这个是由Spring MVC自动创建的一个Servlet，用于请求转发的，这一点从web.xml文件中就可以看出端倪）。
对于这两个文件，我们无需修改，可以直接使用。这就是我强烈推荐使用STS的原因之一。
接下来，我们要做的就是编写一个Controller测试一下。
package com.emerson.suzhou.controller;
import java.text.DateFormat;
import java.util.Date;
import java.util.Locale;
import javax.annotation.Resource;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import com.emerson.suzhou.pojo.User;
import com.emerson.suzhou.service.IUserService;
/**
* Handles requests for the application home page.
*/
@Controller
public class HomeController
private static final Logger logger = LoggerFactory.getLogger(HomeController.class);
@Resource
private IUserService userService;
@RequestMapping(value = "showUser/id")
public String showUser(@PathVariable int id, Model model)
User user = this.userService.getById(id);
model.addAttribute("user", user);
return "showUser";
JSP文件如下。
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>测试</title> </head> <body> $user.toString() </body> </html>
将项目发布到服务器上运行，地浏览器地址栏中输入http://localhost:8080/suzhou/showUser/1，如果页面中可以显示出从数据库中查询到的数据即为正确。
至此，SSM的框架已全部整合完毕。独孤九剑已融入到小伙伴的血液中了，余下的就看个人修炼了〜〜〜我只能帮你到这里了〜〜〜〜
附录
以上是关于Mybatis系列Spring & Mybatis整合的主要内容，如果未能解决你的问题，请参考以下文章