Mybatis学习笔记之五：Mybatis3.X与Spring4.X的整合_mybatis plus 3.x版本对应spring 4.3.30-CSDN博客

本文链接：https://blog.csdn.net/qq_34212276/article/details/75081756

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

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.Driver
jdbc.url=jdbc:mysql://localhost:3306/testdb
jdbc.username=root
jdbc.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
	 */
	@Resource
	private IUserDao userDao;
	
	private User baseUser;
	
	@Before
	public void setUser() throws ClassNotFoundException {
		baseUser = new User();
		baseUser.setUsername("tom");
		baseUser.setPassword("123456789");
		baseUser.setSex(0);
		baseUser.setPhone("110");
	}
	
	@Test
	public void testSave() {
		//此时baseUser是没有id的，因为没有设置
		userDao.save(baseUser);
		//因为设置了keyProperty与useGeneratedKeys，
		//mybatis会获取数据自动递增的主键并将值放入baseUser
		System.out.println(baseUser.getId());
	}
	
	@Test
	public 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;
	}
	
	@Resource
	public 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>