SSM开发书评网5：项目准备与SSM整合三：Spring与Mybatis整合；（引依赖，配置数据源，配置SqlSessionFactory，配置Mapper接口扫描器，创建mybatis配置文件）

本文详细介绍了Spring与Mybatis的整合过程，包括为何需要整合、整合步骤以及具体配置。首先，解释了单独使用Mybatis时需要通过工具类初始化SqlSessionFactory对象的不便，指出整合能享受Spring的管理优势。接着，列举了整合所需的依赖，如mybatis-spring、druid等，并展示了如何在applicationContext.xml中配置数据源、SqlSessionFactoryBean和Mapper扫描器。最后，提到了创建mybatis-config.xml配置文件。整合完成后，为进一步增强功能，下篇博客将介绍声明式事务、日志模块和单元测试框架的整合。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

说明：

（1）如果需要，可以回顾下以前的内容；（这些内容要回顾一遍，可能需要花费一点时间）

● 如果对Mybatis生疏了，可以看一遍【（9）JDBC入门】，【（10）框架前置：maven，工厂模式，反射，Lambda；】，【（11）Mybatis】中的内容；

● 对于以前接触的，项目的构建以及开发套路，可以适当参考【（12）慕课OA系统（Mybatis项目案例，比较重要！）】；（同时在【OA系统十二：设置默认首页顶部导航栏的用户名；（【基于Xml配置下，使用Mapper接口】的方式！！！！！）】也第一次引入了Mybatis更普遍的开发方式：【基于Xml配置下，使用Mapper接口】，即Dao层都是接口，不是类了；）

（2）本篇博客内容：本篇博客仅仅介绍Spring与Mybatis整合；至于【声明式事务】、【日志模块】、【单元测试框架】等模块的整合，在下篇博客中介绍；

一：整合简述；

1.为什么需要整合；（以Mybatis为例）；

2.Spring与Mybatis整合配置的步骤；

二：Spring与Mybatis整合；

1.第一步：引入所需依赖：【Spring JDBC模块：spring-jdbc】，【Mybatis：mybatis】，【Mybatis和Spring整合的组件：mybatis-spring】，【JDBC：mysql-connector-java】，【阿里连接池：druid】；

2.第二步：在applicationContext.xml中，配置数据源与druid连接池；

3.第三步：在applicationContext.xml中，配置SqlSessionFactoryBean对象：这个对象可以帮我们创建SqlSessionFactory对象；

4.第四步：在applicationContext.xml中，配置Mapper扫描器；

5.第五步：创建mybatis-config.xml配置文件；

一：整合简述；

1.为什么需要整合；（以Mybatis为例）；

说明：

（1）单独使用Mybatis时：情况描述；

● 单独使用Mybatis时：我们开发了一个MyBatisUtils工具类；然后，这个工具类主要作用是：通过代码方式来实例化Mybatis最核心的对象SqlSessionFactory对象；（可以参考【MyBatis入门五：MyBatis基本使用三：MyBatisUtils工具类；以查询为例，演示mybatis的一个工作流程；】）（这儿想表达的意思是：在以前使用Mybatis框架时，我们是通过代码方式来实例化SqlSessionFactory对象的）

● SqlSessionFactory对象是Mybatis中最核心的对象，用于解析Mybatis的配置文件、完成一系列初始化工作；同时，Mybatis中操作数据库增删改查的SqlSession对象，也是通过SqlSessionFactory对象来获取的；（这儿想表达的意思是：SqlSessionFactory对象很重要）

● 即，我们在单独使用Mybatis的时候，需要单独开发一个工具类MyBatisUtils，来封装初始化代码；

（2）问题：单独使用Mybatis时，Mybatis无法享受到Spring带来的好处；

● 在单独使用Mybatis的时候，是通过代码的方式来实例化SqlSessionFactory对象的：【sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader)】：即，这个SqlSessionFactory对象是通过代码创建的，其和Spring没有任何关系；同时，SqlSessionFactory对象因为是自己编代码创建的，Spring不会有效的管理这个对象；

● Spring管理对象带来的好处：Spring底层提供的IoC、AOP这些技术，可以在原始程序之外，扩展很多新的功能，比如日志管理、任务调度、声明式事务等；

● 因为Mybatis的SqlSessionFactory对象并没有被Spring管理，所以Mybatis无法享受到Spring带来的那些福利；

由此，就引出了【整合】的概念；

以Mybatis为例：Mybatis提供了一个可以让Mybatis和Spring整合的组件：mybatis-spring；

● mybatis-spring组件的主要作用是：我们不用自己去手动编写代码来初始化SqlSessionFactory对象；而是在Spring IoC容器中进行配置，然后Spring IoC容器在初始化时，就能自动的创建SqlSessionFactory对象；自然，SqlSessionFactory对象也会内IoC容器管理；这样一来，基于Spring AOP的很多扩展功能也可以应用到Mybatis组件之上了；

● 同时，也把程序创建的权利交个了Spring IoC容器，这样一来，整个系统中分散的技术，形成了一个整体，程序也更容易维护和管理；

……………………………………………………

即，一般情况下，我们提到整合，基本上就是指其他组件和框架整合到Spring上；然后，整合的核心目的就是，通过Spring去管理其他组件或者框架的核心对象，让这些组件形成一个整体；

2.Spring与Mybatis整合配置的步骤；

说明：

（1）依赖mybatis-sprig及其驱动：首先，需要引入【mybatis】，【mybatis-spring】，【JDBC驱动】等依赖；

（2）配置数据源与连接池：说明我们要连接哪个数据库；

（3）配置SqlSessionFactory：通过配置的方式，让IoC容器实例化SqlSessionFactory对象；即，让Spring帮我们去实例化这个对象；

（4）配置Mapper扫描器：Mapper扫描器的作用就是自动的根据定义的Mapper接口，让Mybatis创建其实现类；

（5）创建mybatis-config.xml：创建Mybatis的配置文件；

二：Spring与Mybatis整合；

前期准备：Spring与Mybatis整合的过程中，我们要测试，既然要测试，肯定需要用到数据库，所以为此我们先创建逻辑空间imooc_reader，然后创建了一个测试用的表test表；

1.第一步：引入所需依赖：【Spring JDBC模块：spring-jdbc】，【Mybatis：mybatis】，【Mybatis和Spring整合的组件：mybatis-spring】，【JDBC：mysql-connector-java】，【阿里连接池：druid】；

pom.xml：

<?xml version="1.0" encoding="UTF-8"?>
<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>com.imooc</groupId>
    <artifactId>imooc-reader</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!--0.Maven国内阿里云镜像-->
    <repositories>
        <repository>
            <id>aliyun</id>
            <name>aliyun</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </repository>
    </repositories>

    <dependencies>
        <!--1.引入Spring-webmvc依赖-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.2.6.RELEASE</version>
        </dependency>
        <!--2.引入FreeMarker依赖-->
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.30</version>
        </dependency>
        <!--2.1.引入Spring对FreeMarker的支持包-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>5.2.6.RELEASE</version>
        </dependency>
        <!--3.引入JSON序列化工具包jackson-->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-core</artifactId>
            <version>2.11.0</version>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.11.0</version>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-annotations</artifactId>
            <version>2.11.0</version>
        </dependency>

        <!--Mybatis与Spring整合步骤：1.引入依赖-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>5.2.6.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.4</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
            <version>2.0.3</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.23</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.1.14</version>
        </dependency>
    </dependencies>

</project>

说明：

（1）可以看到，我们在引入【mybatis依赖】，【jdbc依赖】的同时，也引入了【spring-jdbc依赖】；

● 只是用JDBC时，我们只需要引入【JDBC的依赖：mysql-connector-java】即可；

● 只是用Mybatis时，需要引入【mybatis的依赖：mybatis】和【JDBC的依赖：mysql-connector-java】；因为Mybatis底层是基于JDBC的MySQL驱动，所以需要MySQL的依赖；

● 只是用Spring JDBC时，需要引入【spring-jdbc的依赖：spring-jdbc】和【JDBC的依赖：mysql-connector-java】；【Mybatis】，【Spring JDBC】这些操作数据库的框架都是基于jdbc的封装；所以，这儿也需要在pom中引入jdbc依赖；

（2）然后，我们不打算使用mybatis提供的连接池，而是使用阿里的druid连接池，所以引入了druid连接池；

（3）然后jdbc依赖，需要和本地的MySQL版本保持一致；

2.第二步：在applicationContext.xml中，配置数据源与druid连接池；

预先说明：

● 第一次接触Druid连接池是在【JDBC入门十四：连接池（2）：Druid连接池的配置和使用；（在实际中使用尚有疑问？后续明确了，需要再回头改）（包含读取配置文件，及路径格式的处理）】；

● 第一次在Mybatis中配置连接池是在【MyBatis进阶七：MyBatis整合C3P0连接池；】；

● 然后，之前在Spring JDBC中，没有接触连接池；而是使用的spring-jdbc自己的数据源；

其实，连接池可以提供数据库连接，那么自然配置连接池，也可以说是配置数据源；

在applicationContext.xml中配置以下内容：
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">
        <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/imooc_reader?useSSL=false&amp;useUnicode=true&amp;characterEncoding=UTF-8&amp;serverTimezone=Asia/Shanghai&amp;allowPublicKeyRetrieval=true"/>
        <property name="username" value="root"/>
        <property name="password" value="12345"/>
        <property name="initialSize" value="10"/>
        <property name="maxActive" value="20"/>
    </bean>
说明：

（1）明显可以感觉到，在【SSM项目中配置数据库连接池】和【以前在JDBC中，或者在Mybatis中，配置数据库连接池】的具体操作是由差异的；（但是，其背后的基本常识是一样的）（SSM项目中配置更简单，能够体会到SSM框架背后帮了我们很多，也能感受到越是高级的框架，我们越省心）；

（2）配置项简单说明：

通过这个步骤，能够看出：applicationContext.xml文件是Spring的，然后数据源对象在这个Spring的配置文件中配置，能够感受到Mybatis为了和Spring整合，而所做的配合和努力。

3.第三步：在applicationContext.xml中，配置SqlSessionFactoryBean对象：这个对象可以帮我们创建SqlSessionFactory对象；

通过IoC容器，在初始化时自动的实例化SqlSessionFactory对象；

在applicationContext.xml中配置以下内容：
    <bean id="sessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="mapperLocations" value="classpath:mappers/*.xml"/>
        <property name="configLocation" value="classpath:mybatis-config.xml"/>
    </bean>
说明：

（1）配置内容说明；

通过这个步骤，能够看出：applicationContext.xml文件是Spring的，然后SqlSessionFactory对象在这个Spring的配置文件中配置，能够感受到Mybatis为了和Spring整合，而所做的配合和努力。

4.第四步：在applicationContext.xml中，配置Mapper扫描器；

Mapper扫描器：

● 我们知道在【OA系统十二：设置默认首页顶部导航栏的用户名；（【基于Xml配置下，使用Mapper接口】的方式！！！！！）】也第一次引入了Mybatis更普遍的开发方式：【基于Xml配置下，使用Mapper接口】，即Dao层都是接口，不是类了；这些

● 这些Mybatis中的，Dao层的，用于增删改查的接口就是：Mapper接口；

● 自然，系统中的接口有很多，并不是所有接口都是Mapper接口；

● 为了将这些Mapper接口和系统中其他接口区分开，就需要配置Mapper扫描器；

● 在Spring初始化Mybatis的过程中，将要配置的Mapper扫描器，就是去扫描这些Mybatis中Dao层的接口的；

在applicationContext.xml中配置以下内容：
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.imooc.reader.mapper"/>
    </bean>
说明：

（1）配置说明；

通过这个步骤，能够看出：applicationContext.xml文件是Spring的；然后，我们在Spring的配置文件中配置一个bean，然后利用这个bean去扫描Mybatis的Mapper接口；能够感受到Mybatis为了和Spring整合，而所做的配合和努力。

5.第五步：创建mybatis-config.xml配置文件；
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    
    <settings>
        <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>

</configuration>
说明：

（1）第一次接触mybatis-config.xml是在【MyBatis入门三：MyBatis基本使用一：MyBatis环境配置；（包括，pom引入Mybatis依赖；IDEA配置数据库；引入演示用SQL；mybatis-config.xml配置文件编写；）】，如有需要可以快速参考；

（2）第一次接触Mybatis驼峰命名转换是在【MyBatis入门五：MyBatis基本使用三：MyBatisUtils工具类；以查询为例，演示mybatis的一个工作流程；】，如有需要可以快速参考；