一文搞定Spring整合Mybatis-工具盒子

# （一）概述 {#一-概述}

有个专门的项目可以用来整合Spring和Mybatis，这里还是先放上官网：

http://mybatis.org/spring/zh/index.html

MyBatis-Spring 会帮助你将 MyBatis 代码无缝地整合到 Spring 中，首先需要确定版本：

在这里会用最新的版本去做这个整合。

# （二）Spring整合Mybatis操作 {#二-spring整合mybatis操作}

# 2.1 引入依赖 {#_2-1-引入依赖}

在这里我会用spring-jdbc代替mybatis的数据源，因此额外引入了一个spring-jdbc的依赖，其余就是Spring相关依赖和Mybatis相关依赖以及最重要的mybatis-spring

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.4</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.46</version>
</dependency>
<dependency>
    <groupId>org.aspectj</groupId>
    <artifactId>aspectjweaver</artifactId>
    <version>1.9.4</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.2.9.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>5.2.9.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>2.0.6</version>
</dependency>

# 2.2 项目准备 {#_2-2-项目准备}

我这里只搭建一个最简单的项目框架，包含一个用户的实体类，以及一个UserMapper接口和UserMapper.xml文件：

public class User {
    private int id;
    private String name;
    //省略构造方法、get、set、toString
}

UserMapper

public interface UserMapper {
    List<User> getUserList();
}

UserMapper.xml

<?xml version="1.0" encoding="UTF8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.javayz.mapper.UserMapper">
    <select id="getUserList" resultType="com.javayz.pojo.User">
        select * from user;
    </select>
</mapper>

# 2.3 配置mybatis-config.xml {#_2-3-配置mybatis-config-xml}

由于Spring和Mybatis整合后，mybatis-config甚至可以被spring的配置文件所代替，但是为了演示，我依旧会创建这个配置文件：

<?xml version="1.0" encoding="UTF8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!--每个mapper.xml都需要在mybatis配置文件中进行配置-->
    <mappers>
        <mapper resource="com/javayz/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

# 2.4 配置Spring-mybatis配置文件 {#_2-4-配置spring-mybatis配置文件}

这个文件是spring-mybatis的核心配置文件spring.xml

<?xml version="1.0" encoding="UTF8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd">
    &lt;!--DataSource由Spring管理数据源--&gt;
    &lt;bean id=&quot;datasource&quot; class=&quot;org.springframework.jdbc.datasource.DriverManagerDataSource&quot;&gt;
        &lt;property name=&quot;driverClassName&quot; value=&quot;com.mysql.jdbc.Driver&quot;/&gt;
        &lt;property name=&quot;url&quot; value=&quot;jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;amp;useUnicode=true&amp;amp;characterEncoding=UTF-8&quot;/&gt;
        &lt;property name=&quot;username&quot; value=&quot;root&quot;/&gt;
        &lt;property name=&quot;password&quot; value=&quot;123456&quot;/&gt;
    &lt;/bean&gt;

    &lt;!--配置SqlSessionFactory--&gt;
    &lt;bean id=&quot;sqlSessionFactory&quot; class=&quot;org.mybatis.spring.SqlSessionFactoryBean&quot;&gt;
        &lt;property name=&quot;dataSource&quot; ref=&quot;datasource&quot;/&gt;
        &lt;!--绑定Mybatis配置文件--&gt;
        &lt;property name=&quot;configLocation&quot; value=&quot;classpath:mybatis-config.xml&quot;/&gt;
    &lt;/bean&gt;
    &lt;!--配置sqlSessionTemplate--&gt;
    &lt;bean id=&quot;sqlSessionTemplate&quot; class=&quot;org.mybatis.spring.SqlSessionTemplate&quot;&gt;
        &lt;constructor-arg index=&quot;0&quot; ref=&quot;sqlSessionFactory&quot;/&gt;
    &lt;/bean&gt;

</beans>

这个配置文件中主要会配置三个东西：DataSource数据源、SqlSessionFactory、SqlSessionTemplate

DataSource数据源就不用多讲了，和Mybatis一样。

在 MyBatis-Spring 中，可使用 SqlSessionFactoryBean来创建 SqlSessionFactory，并给他配置数据源、绑定Mybatis配置文件等。

SqlSessionTemplate是sqlSesson的一个实现，他可以完全代替我们前面所使用的sqlSesson。SqlSessionTemplate 是线程安全的，可以被多个 DAO 或映射器所共享使用。

# 2.5 使用SqlSessionTemplate {#_2-5-使用sqlsessiontemplate}

我们创建一个UserMapper的实现类UserMapperImpl：

public class UserMapperImpl implements UserMapper {
private SqlSessionTemplate sqlSessionTemplate;

public void setSqlSessionTemplate(SqlSessionTemplate sqlSessionTemplate) {
    this.sqlSessionTemplate = sqlSessionTemplate;
}

public List&lt;User&gt; getUserList() {
    UserMapper mapper = sqlSessionTemplate.getMapper(UserMapper.class);
    return mapper.getUserList();

}

}

只需要在代码中引入SqlSessionTemplate，就可像SqlSession一样使用它。

创建完成之后记得注入到Spring中，为了把配置和其他的Bean注入分开，我们创建一个applicationContext.xml来统一管理配置文件：

<?xml version="1.0" encoding="UTF8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd">
&lt;import resource=&quot;spring.xml&quot;/&gt;

&lt;bean id=&quot;userMapper&quot; class=&quot;com.javayz.mapper.UserMapperImpl&quot;&gt;
    &lt;property name=&quot;sqlSessionTemplate&quot; ref=&quot;sqlSessionTemplate&quot;/&gt;
&lt;/bean&gt;

</beans>

# 2.6 测试 {#_2-6-测试}

 @org.junit.Test
 public void test(){
        ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
        UserMapper userMapper = (UserMapper) context.getBean("userMapper");
        System.out.println(userMapper.getUserList());
}

直接调用mapper即可，不用再像Mybatis一样先创建SqlSessionFactory，再创建SqlSession。

# (三)使用SqlSessionDaoSupport再简化 {#三-使用sqlsessiondaosupport再简化}

有没有觉得前面使用SqlSessionTemplate还是有些麻烦，官方给我们提供了更加简单的方式。

使用SqlSessionDaoSupport的话spring-mybatis这个配置文件就不需要再配置SqlSessionTemplate了

<?xml version="1.0" encoding="UTF8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd">
    &lt;!--DataSource由Spring管理数据源--&gt;
    &lt;bean id=&quot;datasource&quot; class=&quot;org.springframework.jdbc.datasource.DriverManagerDataSource&quot;&gt;
        &lt;property name=&quot;driverClassName&quot; value=&quot;com.mysql.jdbc.Driver&quot;/&gt;
        &lt;property name=&quot;url&quot; value=&quot;jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;amp;useUnicode=true&amp;amp;characterEncoding=UTF-8&quot;/&gt;
        &lt;property name=&quot;username&quot; value=&quot;root&quot;/&gt;
        &lt;property name=&quot;password&quot; value=&quot;123456&quot;/&gt;
    &lt;/bean&gt;
    &lt;!--配置SqlSessionFactory--&gt;
    &lt;bean id=&quot;sqlSessionFactory&quot; class=&quot;org.mybatis.spring.SqlSessionFactoryBean&quot;&gt;
        &lt;property name=&quot;dataSource&quot; ref=&quot;datasource&quot;/&gt;
        &lt;!--绑定Mybatis配置文件--&gt;
        &lt;property name=&quot;configLocation&quot; value=&quot;classpath:mybatis-config.xml&quot;/&gt;
    &lt;/bean&gt;

</beans>

然后我们新建一个UserMapperImpl2，它需要继承SqlSessionDaoSupport ，然后直接用getSqlSession()获取到SqlSession即可。

public class UserMapperImpl2 extends SqlSessionDaoSupport implements UserMapper {
    public List<User> getUserList() {
        return getSqlSession().getMapper(UserMapper.class).getUserList();
    }
}

最后注入Bean，需要注入sqlSessionFactory属性：

<bean id="userMapper2" class="com.javayz.mapper.UserMapperImpl2">
    <property name="sqlSessionFactory" ref="sqlSessionFactory"/>
</bean>

最后测试后获得同样的结果。

# （四）总结 {#四-总结}

到这里差不多把Spring的基本使用都讲完了，后续会讲一些面试中常考的比较难的知识点，有兴趣可以关注一下。

51工具盒子

一文搞定Spring整合Mybatis