1、MyBatis的优势

众所周知，MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。通过xml映射到接口，使开发者使用接口的方式就能够轻松的映射、解析、执行xml中的SQL。MyBatis 消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。这样做的目的在于降低代码耦合度，大大简化了数据库操作中的常用操作,修改SQL更加容易，代码也更清晰易维护。

简单了解下MyBatis的优点，以便了解为什么会将其集成到Spring中：

1） 灵活性高

MyBatis允许直接编写原生的SQL语句，提供了很高的灵活性。我们可以根据需要编写任何复杂的SQL，从而满足各种业务需求。

2）易于使用

MyBatis通过XML配置文件和注解，让你可以轻松将SQL语句与Java代码分离，使得代码结构更清晰、易维护。

3）映射简单

MyBatis提供了简单的映射方式，可以将数据库表中的字段自动映射到Java对象的属性上，降低了数据转换的复杂性。

4）扩展性良好

MyBatis提供了丰富的插件接口，你可以通过编写自定义插件来扩展MyBatis的功能，以满足特定需求。（这部分内容在MyBatis课程部分会讲解）

5）易于集成

MyBatis可以与Spring、Spring Boot等流行框架无缝集成，提供更加完整的解决方案。

6）社区活跃

MyBatis有一个活跃的开发者社区，为使用者提供了丰富的文档、教程和支持。这有助于在遇到问题时快速找到解决方案。

2、SpringBoot对MyBatis的支持

官网地址：https://mybatis.org/mybatis-3/

官方参照表：http://mybatis.org/spring/

中文官网：https://mybatis.org/mybatis-3/zh/

mybatis项目源码地址：https://github.com/mybatis/mybatis-3/

我们知道，在官方文档中明确说明，Spring 2.0 只支持 iBatis 2.0。那么，我们就想将 MyBatis3 的支持添加到 Spring 3.0 中。不幸的是，Spring 3.0 的开发在 MyBatis 3.0 官方发布前就结束了。由于 Spring 开发团队不想发布一个基于未发布版的 MyBatis 的整合支持，如果要获得 Spring 官方的支持，只能等待下一次的发布了。基于在 Spring 中对 MyBatis 提供支持的兴趣，MyBatis 社区认为，应该开始召集有兴趣参与其中的贡献者们，将对 Spring 的集成作为 MyBatis 的一个社区子项目。于是，MyBatis自己动手搞了一个Spring的扩展实现，精神可敬。另外这也得益于Spring非常优秀的扩展能力。基于这样两方面的因素，从而加快了MyBatis与Spring集成的速度。

Spring和MyBatis版本对应关系

在实际开发中，单独引入Mybatis包时，大家可以参照这个表即可。

3、SpringBoot集成MyBatis实战

说明：本次实战依然是基于前面的SpringBootCase工程之上进行集成MyBatis。

3.1 案例思路

通过SpringBoot +MyBatis实现对供应链中商品表的查询操作。

3.2 实现步骤

步骤1：准备数据库

这里讲的是windows环境（linux环境类似）。首先启动本地mysql数据库，启动好后通过mysql客户端工具（Navicat等）连接本地Mysql,并创建新的数据库xintu，指定数据库字符编码为utf-8。

新建商品表并向表中插入数据。

1） 新建表

DROP TABLE IF EXISTS `t_product`;
CREATE TABLE `t_product` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键',
  `category_id` int(10) DEFAULT NULL COMMENT '类目ID',
  `item_type` varchar(50) DEFAULT NULL COMMENT '商品类型',
  `title` varchar(500) DEFAULT NULL COMMENT '商品标题',
  `sell_point` varchar(50) DEFAULT NULL COMMENT '销售站点',
  `price` varchar(50) DEFAULT NULL COMMENT '销售价格',
  `num` int(11) DEFAULT NULL COMMENT '库存数量',
  `image` varchar(500) DEFAULT NULL COMMENT '商品图片',
  `status` int(11) DEFAULT NULL COMMENT '商品状态'
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

2）插入数据

INSERT INTO `t_product` VALUES ('1', '23', '12', 'Redmi K50Pro 天玑9000 AMOLED 2K柔性直屏 OIS光学防抖  120W快充 幻镜  8GB+256GB 5G智能手机 小米红米', '仅上海，广州，沈阳仓有货！预购从速', '1469.00', '10', '../images/portal/02COMIXC5902A5122blue/miaosha_1.jpg', '1', '1', null, null, null, null);
INSERT INTO `t_product` VALUES ('2', '23', '12', 'Redmi K50Pro 天玑9000 AMOLED 2K柔性直屏 OIS光学防抖  120W快充 幻镜  8GB+256GB 5G智能手机 小米红米', '仅上海，广州，沈阳仓有货！预购从速', '2619.00', '10', '../images/portal/02COMIXC5902A5122blue/miaosha_2.jpg', '1', '2', null, null, null, null);
I

步骤2：SpringBoot集成MyBatis插件

在pom.xml中添加相关jar依赖。

<!--引入mybatis jar-->
<dependency>
	<groupId>org.mybatis.spring.boot</groupId>
	<artifactId>mybatis-spring-boot-starter</artifactId>
	<version>2.1.4</version>
</dependency>
<!--引入mysql jar-->
<dependency>
	<groupId>mysql</groupId>
	<artifactId>mysql-connector-java</artifactId>
	<version>8.0.25</version>
</dependency>

步骤3：application.yml中配置数据源

spring:
  datasource: # mysql相关配置
    url: jdbc:mysql://localhost:3306/xintu?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
    username: root
    password: xxx

步骤4：反向工程配置

引入反向工程mybatis maven插件。由于在生成Java POJO时，需要连接数据库，所以也需要引入mysql驱动包。

<!--==========mybatis代码生成插件配置==========-->
<plugin>
	<!--插件坐标-->
	<groupId>org.mybatis.generator</groupId>
	<artifactId>mybatis-generator-maven-plugin</artifactId>
	<version>1.3.5</version>
	<!--插件依赖数据库驱动-->
	<dependencies>
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>8.0.25</version>
		</dependency>
	</dependencies>
	<!--插件配置-->
	<configuration>
		<!--指定配置文件位置-->
		<configurationFile>src/main/resources/generatorConfig.xml</configurationFile>
		<verbose>true</verbose>
		<overwrite>true</overwrite>
	</configuration>
</plugin>

引入反向工程配置文件generatorConfig.xml，

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
        PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
        "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">

<generatorConfiguration>
    <context id="testTables" targetRuntime="MyBatis3">
        <commentGenerator>
            <!-- 是否去除自动生成的注释 true：是 ：false:否 -->
            <property name="suppressAllComments" value="true" />
        </commentGenerator>
        <!--==================数据库连接的信息：驱动类、连接地址、用户名、密码 =====================-->
        <jdbcConnection driverClass="com.mysql.jdbc.Driver"
                        connectionURL="jdbc:mysql://localhost:3306/xintu" userId="root"
                        password="xxx">
        </jdbcConnection>
        <!-- 默认false，把JDBC DECIMAL 和 NUMERIC 类型解析为 Integer，为 true时把JDBC DECIMAL 和
            NUMERIC 类型解析为java.math.BigDecimal -->
        <javaTypeResolver>
            <property name="forceBigDecimals" value="false" />
        </javaTypeResolver>

        <!-- ================targetProject:生成PO类的位置 ================-->
        <javaModelGenerator targetPackage="com.xintu.demo.entity"
                            targetProject=".\src\main\java">
            <!-- enableSubPackages:是否让schema作为包的后缀 -->
            <property name="enableSubPackages" value="false" />
            <!-- 从数据库返回的值被清理前后的空格 -->
            <property name="trimStrings" value="true" />
        </javaModelGenerator>
        <!--================= targetProject:mapper映射文件生成的位置=============== -->
        <sqlMapGenerator targetPackage="mapper"
                         targetProject=".\src\main\resources">
            <!-- enableSubPackages:是否让schema作为包的后缀 -->
            <property name="enableSubPackages" value="false" />
        </sqlMapGenerator>
        <!-- ==================targetPackage：mapper接口生成的位置 ==================-->
        <javaClientGenerator type="XMLMAPPER"
                             targetPackage="com.xintu.demo.mapper"
                             targetProject=".\src\main\java">
            <!-- enableSubPackages:是否让schema作为包的后缀 -->
            <property name="enableSubPackages" value="false" />
        </javaClientGenerator>
        <!--=============== 指定数据库表 ==================-->
        <table schema="xintu" tableName="t_product"></table>
    </context>
</generatorConfiguration>

步骤5：反向代码生成

使用Mybatis反向工程生成接口、映射文件以及实体Bean。

 步骤6：创建 TProductService并编写代码

package com.xintu.demo.service;

import com.xintu.demo.entity.TProduct;
import com.xintu.demo.entity.TProductExample;
import com.xintu.demo.mapper.TProductMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

/**
 * @author XinTu
 * @classname TProductService
 * @description TODO
 * @date 2023年04月29日 21:19
 */
@Service
public class TProductService {
    @Autowired
    private TProductMapper mapper;

    /**
     * 查询测试
     * @return
     */
    public List<TProduct> queryList(){
        TProductExample example = new TProductExample();
        TProductExample.Criteria criteria = example.createCriteria();
        criteria.andCategoryIdEqualTo(1);
        return mapper.selectByExample(example);
    }
}

步骤7：创建 TProductController 并编写代码

package com.xintu.demo.controller;

import com.xintu.demo.entity.TProduct;
import com.xintu.demo.mapper.TProductMapper;
import com.xintu.demo.service.TProductService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

/**
 * @author XinTu
 * @classname TProductController
 * @description TODO
 * @date 2023年04月29日 21:12
 */


@RestController
public class TProductController {

    @Autowired
    private TProductService service;

    /**
     * 查询测试
     * @return
     */
    @GetMapping(value = "/queryList")
    public List<TProduct> queryList() {
        return service.queryList();
    }

}

在 MyBatis 反向工程生成的 TProductMapper 后，有两种注入方式：

① 接口上加一个Mapper注解

② SpringbootApplication 启动类加@MapperScan("com.xintu.demo.mapper")注解

* 以上两个的作用：MyBatis自动扫描数据持久层的映射文件及DAO接口的关系

package com.xintu.demo.mapper;

import com.xintu.demo.entity.TProduct;
import com.xintu.demo.entity.TProductExample;
import java.util.List;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

@Mapper //方式一：添加@Mapper注解，等同于主类上加@MapperScan("com.bjpowernode.springboot.mapper")
public interface TProductMapper {
    long countByExample(TProductExample example);

    int deleteByExample(TProductExample example);

    int deleteByPrimaryKey(Integer id);

    int insert(TProduct record);

    int insertSelective(TProduct record);

    List<TProduct> selectByExample(TProductExample example);

    TProduct selectByPrimaryKey(Integer id);

    int updateByExampleSelective(@Param("record") TProduct record, @Param("example") TProductExample example);

    int updateByExample(@Param("record") TProduct record, @Param("example") TProductExample example);

    int updateByPrimaryKeySelective(TProduct record);

    int updateByPrimaryKey(TProduct record);
}

步骤8：指定mybatis xml路径

#在application.yml配置文件中指定映射文件的位置，这个配置只有接口和映射文件不在同一个包的情况下，才需要指定
mybatis:
  mapper-locations: classpath:mapper/*.xml

步骤9：测试验证

以上这部分作为入门级内容,  主要分析了MyBatis的特点以及与SpringBoot集成实战过程。我们发现MyBatis征服SpringBoot（或者说Spring）主要靠3点：

1）MyBatis作为持久层本身的诸多优势（低耦合、易读易维护等）

2）MyBatis社区不遗余力的推进

3）SpringBoot自身强大的扩展能力

以上三点，共同铸就了MyBatis与SpringBoot的完美集成。那关于的MyBatis更多细节部分，比如实现原理，自定义扩展，将会在后面的MyBatis专栏部分进行逐一讲解。