Mybatis学习笔记之五：Mybatis3.X与Spring4.X的整合

在开始项目前，先做好以下准备工作：

1、Mybatis3.X的jar包。

2、Spring4.X的jar包。

3、Sping与Mybatis的整合包。

4、创建数据库testdb以及表t_user

5、在STS中创建项目并将依赖添加到POM文件中（这儿为了方便使用maven来管理依赖）

项目总览：

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>org.yamikaze</groupId><artifactId>spring-mybatis</artifactId><version>0.0.1-SNAPSHOT</version><packaging>jar</packaging><name>spring-mybatis</name><url>http://maven.apache.org</url><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><spring.version>4.2.5.RELEASE</spring.version></properties><dependencies><!--junit测试包 --><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.10</version><scope>test</scope></dependency><!--数据库连接包  --><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.37</version></dependency><!--Mybatis的依赖 --><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.4.1</version></dependency><!--Mybatis与Spring的整合 --><dependency><groupId>org.mybatis</groupId><artifactId>mybatis-spring</artifactId><version>1.3.0</version></dependency><!--Spring --><dependency><groupId>org.springframework</groupId><artifactId>spring-aop</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-beans</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-orm</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-test</artifactId><version>${spring.version}</version><scope>test</scope></dependency><!--log4j  --><dependency><groupId>log4j</groupId><artifactId>log4j</artifactId><version>1.2.17</version></dependency><!--dbcp数据源  --><dependency><groupId>commons-dbcp</groupId><artifactId>commons-dbcp</artifactId><version>1.4</version></dependency></dependencies><build><pluginManagement><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.0</version><configuration><source>1.8</source><target>1.8</target></configuration></plugin></plugins></pluginManagement></build></project>

第一步：配置数据库连接文件jdbc.properties

jdbc.driverClassName=com.mysql.jdbc.Driverjdbc.url=jdbc:mysql://localhost:3306/testdbjdbc.username=rootjdbc.password=951001

第二步：配置beans.xml，Mybatis的配置全部集中到了该文件中

<!--打开Spring的注解 --><context:annotation-config /><!--Spring要扫描的包 --><context:component-scan base-package="org.yamikaze" /><!--配置数据源，这儿使用DBCP，如果想使用其他数据源，加入相应的依赖，并将class属性改为相应的实现类即可 --><bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"destroy-method="close"><property name="driverClassName" value="${jdbc.driverClassName}" /><property name="url" value="${jdbc.url}" /><property name="username" value="${jdbc.username}" /><property name="password" value="${jdbc.password}" /></bean><!--加载jdbc.properties --><context:property-placeholder location="classpath:jdbc.properties" /><!--为Mybatis配置sqlSessionFactory --><bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"><!--注入数据源  --><property name="dataSource" ref="dataSource" /><!--配置mapper文件位置  --><property name="mapperLocations" value="classpath:/org/yamikaze/model/*.xml"/><!--Mybatis的配置文件 ，mybatis的配置文件可以配置一些日志信息等--><property name="configLocation" value="classpath:mybatis-config.xml" /><!--配置别名，如果有多个包名，包名之间用逗号隔开 --><property name="typeAliasesPackage" value="org.yamikaze.model" /></bean><!--配置Mapper接口扫描器 --><bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"><!--mapper文件对应的接口所在位置  --><property name="basePackage" value="org.yamikaze.dao" /><!--该类中SqlSessionFactory属性名为sqlSessionFactory，但这儿注入的却是sqlSessionFactoryBeanName这是因为setSqlSessionFactory方法已过时，采用setSqlSessionFactoryBeanName方法注入 注意这儿是value而不是ref --><property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/></bean><!--配置事务管理，Spring使用JDBC的事务管理 --><bean id="transactionManager"class="org.springframework.jdbc.datasource.DataSourceTransactionManager"><property name="dataSource" ref="dataSource" /></bean>

第三步：配置文件配置完毕。开始编写代码。

User类

package org.yamikaze.model;import java.io.Serializable;public class User implements Serializable {private static final long serialVersionUID = -364692220372530436L;private Integer id;private String username;// 密码等敏感性信息 使用transient修饰，防止序列化private transient String password;private Integer sex;private String phone;public User() {}// omitting getter & setter method

IUserDao接口

package org.yamikaze.dao;import java.util.List;import org.yamikaze.model.User;public interface IUserDao {int save(User user);int update(User user);User load(Integer id);List<User> listAll();//根据名字精确查找，保证数据库用户名不能重复User loadByUsername(String username);//根据名字模糊查找List<User> listByUsername(String username);}

第四步：mapper配置文件（暂时先写两条sql语句）

<?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="org.yamikaze.dao.IUserDao"><insert id="save" parameterType="User" keyProperty="id" useGeneratedKeys="true">insert into t_user(username,password,sex,phone) value(#{username},#{password},#{sex},#{phone})</insert><select id="loadByUsername" resultType="User">select * from t_user where username = #{username}</select></mapper>

注意：命名空间要与接口相匹配，查询语句要加上resultType属性。配置文件的位置要填写正确

第五步：编写测试类

package org.yamikaze.test;import javax.annotation.Resource;import org.junit.Before;import org.junit.Test;import org.junit.runner.RunWith;import org.springframework.test.context.ContextConfiguration;import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;import org.yamikaze.dao.IUserDao;import org.yamikaze.model.User;/** * 测试 * @author yamikaze *  */@RunWith(SpringJUnit4ClassRunner.class)@ContextConfiguration("/beans.xml")public class TestMybatis {/** * 自动注入IUseDao */@Resourceprivate IUserDao userDao;private User baseUser;@Beforepublic void setUser() throws ClassNotFoundException {baseUser = new User();baseUser.setUsername("tom");baseUser.setPassword("123456789");baseUser.setSex(0);baseUser.setPhone("110");}@Testpublic void testSave() {//此时baseUser是没有id的，因为没有设置userDao.save(baseUser);//因为设置了keyProperty与useGeneratedKeys，//mybatis会获取数据自动递增的主键并将值放入baseUserSystem.out.println(baseUser.getId());}@Testpublic void testLoadByUsername() {User user = userDao.loadByUsername(baseUser.getUsername());System.out.println(user.getUsername() + "," +user.getPassword());}}

运行这两个测试

注意： 

1、测试方法testSave与testLoadByUsername并不是按照顺序执行的，如果testLoadByUsername方法先执行会出现NPE。

2、如果出现不能加载com.mysql.jdbc.Driver异常，这说明你没有导入Mysql驱动或者导入的Mysql驱动jar有问题，这种情况下换一个版本，但一定要注意与数据库版本对应。

3、出现java.lang.AbstractMethodError: org.mybatis.spring.transaction.SpringManagedTransaction.getTimeout()Ljava/lang/Integer;表示你的Mybatis-spring版本有问题，换成1.3.0即可。

上述方式是使用接口的形式整合Mybatis与Spring，这也是最常用的方式。如果在Spring使用Mybatis原生的session，Spring提供了SqlSessionTemplate模板类。

SqlSessionTemplate部分代码：

public class SqlSessionTemplate implements SqlSession, DisposableBean {  private final SqlSessionFactory sqlSessionFactory;  private final ExecutorType executorType;  private final SqlSession sqlSessionProxy;  private final PersistenceExceptionTranslator exceptionTranslator;  /**   * {@inheritDoc}   */  @Override  public <T> T selectOne(String statement) {    return this.sqlSessionProxy.<T> selectOne(statement);  }  /**   * {@inheritDoc}   */  @Override  public <T> T selectOne(String statement, Object parameter) {    return this.sqlSessionProxy.<T> selectOne(statement, parameter);  }

看到了熟悉了selectOne方法吧！使用这种方式只需在beans文件中配置注入SqlSessionFactory，然后Dao继承这个模板类就可以用类的形式使用了。如果不想使用这个类，你也可以自己写一个BaseDao，在BaseDao里面注入SqlSessionFactory。像这样：

package org.yamikaze.dao;import javax.annotation.Resource;import org.apache.ibatis.session.SqlSessionFactory;public class BaseDao<T> {private SqlSessionFactory sessionFactory;public SqlSessionFactory getSessionFactory() {return sessionFactory;}@Resourcepublic void setSessionFactory(SqlSessionFactory sessionFactory) {this.sessionFactory = sessionFactory;}//other method}

注意：如果出现org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): org.yamikaze.dao.IUserDao.loadByUsername

1、检查Mybatis的配置文件位置是否正确指定。

2、配置文件中的命名空间是否与相应接口匹配。

3、对应方法名的sql语句是否存在于配置文件

4、sql语句的id是否与调用的方法名匹配。

最后对mybatis学习笔记之三做一个补充：

在Mybatis的官方中文文档中 parameterMap被声明为过时。

但如果传入两个Integer类型的参数或者更多同类型的参数，mybatis怎么区分？

使用以下方式：

1、dao方法这样声明

int updatePassword(@Param("username") String username, @Param("password") String password);

2、然后userMapper配置文件中这样引用

<update id="updatePassword">update t_user set password = #{password} where username = #{username}</update>