一文搞定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">

        <!--DataSource由Spring管理数据源-->
        <bean id="datasource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
            <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
            <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
            <property name="username" value="root"/>
            <property name="password" value="123456"/>
        </bean>

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

</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<User> 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">

    <import resource="spring.xml"/>

    <bean id="userMapper" class="com.javayz.mapper.UserMapperImpl">
        <property name="sqlSessionTemplate" ref="sqlSessionTemplate"/>
    </bean>

</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">

        <!--DataSource由Spring管理数据源-->
        <bean id="datasource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
            <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
            <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
            <property name="username" value="root"/>
            <property name="password" value="123456"/>
        </bean>
        <!--配置SqlSessionFactory-->
        <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
            <property name="dataSource" ref="datasource"/>
            <!--绑定Mybatis配置文件-->
            <property name="configLocation" value="classpath:mybatis-config.xml"/>
        </bean>
</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