【Spring教程12】Spring框架实战：Spring整合Mybatis全面深入详解

目录

欢迎大家回到《
Java教程之Spring30天快速入门》，本教程所有示例均基于Maven实现，如果您对Maven还很陌生，请移步本人的博文《
如何在windows11下安装Maven并配置以及 IDEA配置Maven环境》，本文的上一篇为《
IOC/DI注解开发管理第三方bean》

学习到这里，已经对Spring有一个简单的认识了，Spring有一个容器，叫做IoC容器，里面保存bean。在进行企业级开发的时候，其实除了将自己写的类让Spring管理之外，还有一部分重要的工作就是使用第三方的技术。前面已经讲了如何管理第三方bean了，下面结合IoC和DI，整合Mybatis，进一步加深对Spring的使用理解。

1 Spring整合Mybatis思路分析

1.1 环境准备

在准备环境的过程中，我们也来回顾下Mybatis开发的相关内容:

1.1.1 步骤1:准备数据库表

Mybatis是来操作数据库表，所以先创建一个数据库及表

createdatabase spring_db characterset utf8;use spring_db;createtable tbl_account(
    id intprimarykeyauto_increment,
    name varchar(35),
    money double);

1.1.2 步骤2:创建项目导入jar包

项目的pom.xml添加相关依赖

<dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>5.2.10.RELEASE</version></dependency><dependency><groupId>com.alibaba</groupId><artifactId>druid</artifactId><version>1.1.16</version></dependency><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.6</version></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.47</version></dependency></dependencies>

1.1.3 步骤3:根据表创建模型类

publicclassAccountimplementsSerializable{privateInteger id;privateString name;privateDouble money;//setter...getter...toString...方法略}

1.1.4 步骤4:创建Dao接口

publicinterfaceAccountDao{@Insert("insert into tbl_account(name,money)values(#{name},#{money})")voidsave(Account account);@Delete("delete from tbl_account where id = #{id} ")voiddelete(Integer id);@Update("update tbl_account set name = #{name}, money = #{money} where
    id = #{id} ")voidupdate(Account account);@Select("select * from tbl_account")List<Account>findAll();@Select("select * from tbl_account where id = #{id} ")AccountfindById(Integer id);}

1.1.5 步骤5:创建Service接口和实现类

publicinterfaceAccountService{voidsave(Account account);voiddelete(Integer id);voidupdate(Account account);List<Account>findAll();AccountfindById(Integer id);}@ServicepublicclassAccountServiceImplimplementsAccountService{@AutowiredprivateAccountDao accountDao;publicvoidsave(Account account){
        accountDao.save(account);}publicvoidupdate(Account account){
        accountDao.update(account);}publicvoiddelete(Integer id){
        accountDao.delete(id);}publicAccountfindById(Integer id){return accountDao.findById(id);}publicList<Account>findAll(){return accountDao.findAll();}}

1.1.6 步骤6:添加jdbc.properties文件

resources目录下添加，用于配置数据库连接四要素

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/spring_db?useSSL=false
jdbc.username=root
jdbc.password=root

useSSL:关闭MySQL的SSL连接

1.1.7 步骤7:添加Mybatis核心配置文件

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPEconfigurationPUBLIC"-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration><!--读取外部properties配置文件--><propertiesresource="jdbc.properties"></properties><!--别名扫描的包路径--><typeAliases><packagename="com.itheima.domain"/></typeAliases><!--数据源--><environmentsdefault="mysql"><environmentid="mysql"><transactionManagertype="JDBC"></transactionManager><dataSourcetype="POOLED"><propertyname="driver"value="${jdbc.driver}"></property><propertyname="url"value="${jdbc.url}"></property><propertyname="username"value="${jdbc.username}"></property><propertyname="password"value="${jdbc.password}"></property></dataSource></environment></environments><!--映射文件扫描包路径--><mappers><packagename="com.itheima.dao"></package></mappers></configuration>

1.1.8 步骤8:编写应用程序

publicclassApp{publicstaticvoidmain(String[] args)throwsIOException{// 1. 创建SqlSessionFactoryBuilder对象SqlSessionFactoryBuilder sqlSessionFactoryBuilder =newSqlSessionFactoryBuilder();// 2. 加载SqlMapConfig.xml配置文件InputStream inputStream =Resources.getResourceAsStream("SqlMapConfig.xml.bak");// 3. 创建SqlSessionFactory对象SqlSessionFactory sqlSessionFactory =
        sqlSessionFactoryBuilder.build(inputStream);// 4. 获取SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 5. 执行SqlSession对象执行查询，获取结果UserAccountDao accountDao = sqlSession.getMapper(AccountDao.class);Account ac = accountDao.findById(1);System.out.println(ac);// 6. 释放资源
        sqlSession.close();}}

1.1.9 步骤9:运行程序

1.2 整合思路分析

Mybatis的基础环境我们已经准备好了，接下来就得分析下在上述的内容中，哪些对象可以交给Spring来管理?

• Mybatis程序核心对象分析 从图中可以获取到，真正需要交给Spring管理的是SqlSessionFactory
• 整合Mybatis，就是将Mybatis用到的内容交给Spring管理，分析下配置文件说明:- 第一行读取外部properties配置文件，Spring有提供具体的解决方案@PropertySource ,需要交给Spring- 第二行起别名包扫描，为SqlSessionFactory服务的，需要交给Spring 第三行主要用于做连接池，Spring之前我们已经整合了Druid连接池，这块也需要交给Spring- 前面三行一起都是为了创建SqlSession对象用的，那么用Spring管理SqlSession对象吗?回忆下SqlSession是由SqlSessionFactory创建出来的，所以只需要将SqlSessionFactory交给Spring管理即可。- 第四行是Mapper接口和映射文件[如果使用注解就没有该映射文件]，这个是在获取到SqlSession以后执行具体操作的时候用，所以它和SqlSessionFactory创建的时机都不在同一个时间，可能需要单独管理。

2 Spring整合Mybatis

前面我们已经分析了Spring与Mybatis的整合，大体需要做两件事，
第一件事是:Spring要管理MyBatis中的SqlSessionFactory
第二件事是:Spring要管理Mapper接口的扫描
具体该如何实现，具体的步骤为:

2.1 步骤1:项目中导入整合需要的jar包

<dependency><!--Spring操作数据库需要该jar包--><groupId>org.springframework</groupId><artifactId>spring-jdbc</artifactId><version>5.2.10.RELEASE</version></dependency><dependency><!--
    Spring与Mybatis整合的jar包
    这个jar包mybatis在前面，是Mybatis提供的
    --><groupId>org.mybatis</groupId><artifactId>mybatis-spring</artifactId><version>1.3.0</version></dependency>

2.2 步骤2:创建Spring的主配置类

//配置类注解@Configuration//包扫描，主要扫描的是项目中的AccountServiceImpl类@ComponentScan("com.itheima")publicclassSpringConfig{}

2.3 步骤3:创建数据源的配置类

在配置类中完成数据源的创建

publicclassJdbcConfig{@Value("${jdbc.driver}")privateString driver;@Value("${jdbc.url}")privateString url;@Value("${jdbc.username}")privateString userName;@Value("${jdbc.password}")privateString password;@BeanpublicDataSourcedataSource(){DruidDataSource ds =newDruidDataSource();
        ds.setDriverClassName(driver);
        ds.setUrl(url);
        ds.setUsername(userName);
        ds.setPassword(password);return ds;}}

2.4 步骤4:主配置类中读properties并引入数据源配置类

@Configuration@ComponentScan("com.itheima")@PropertySource("classpath:jdbc.properties")@Import(JdbcConfig.class)publicclassSpringConfig{}

2.5 步骤5:创建Mybatis配置类并配置SqlSessionFactory

publicclassMybatisConfig{//定义bean，SqlSessionFactoryBean，用于产生SqlSessionFactory对象@BeanpublicSqlSessionFactoryBeansqlSessionFactory(DataSource dataSource){SqlSessionFactoryBean ssfb =newSqlSessionFactoryBean();//设置模型类的别名扫描
        ssfb.setTypeAliasesPackage("com.itheima.domain");//设置数据源
        ssfb.setDataSource(dataSource);return ssfb;}//定义bean，返回MapperScannerConfigurer对象@BeanpublicMapperScannerConfigurermapperScannerConfigurer(){MapperScannerConfigurer msc =newMapperScannerConfigurer();
        msc.setBasePackage("com.itheima.dao");return msc;}}

说明:

• 使用SqlSessionFactoryBean封装SqlSessionFactory需要的环境信息- SqlSessionFactoryBean是前面我们讲解FactoryBean的一个子类，在该类中将SqlSessionFactory的创建进行了封装，简化对象的创建，我们只需要将其需要的内容设置即可。- 方法中有一个参数为dataSource,当前Spring容器中已经创建了Druid数据源，类型刚好是DataSource类型，此时在初始化SqlSessionFactoryBean这个对象的时候，发现需要使用DataSource对象，而容器中刚好有这么一个对象，就自动加载了DruidDataSource对象。
• 使用MapperScannerConfigurer加载Dao接口，创建代理对象保存到IOC容器中- 这个MapperScannerConfigurer对象也是MyBatis提供的专用于整合的jar包中的类，用来处理原始配置文件中的mappers相关配置，加载数据层的Mapper接口类- MapperScannerConfigurer有一个核心属性basePackage，就是用来设置所扫描的包路径### 2.6 步骤6:主配置类中引入Mybatis配置类

@Configuration@ComponentScan("com.itheima")@PropertySource("classpath:jdbc.properties")@Import({JdbcConfig.class,MybatisConfig.class})publicclassSpringConfig{}

2.7 步骤7:编写运行类

在运行类中，从IOC容器中获取Service对象，调用方法获取结果

publicclassApp2{publicstaticvoidmain(String[] args){ApplicationContext ctx =newAnnotationConfigApplicationContext(SpringConfig.class);AccountService accountService = ctx.getBean(AccountService.class);Account ac = accountService.findById(1);System.out.println(ac);}}

2.8 步骤8:运行程序

支持Spring与Mybatis的整合就已经完成了，其中主要用到的两个类分别是:

• SqlSessionFactoryBean
• MapperScannerConfigurer