MyBatis概述与MyBatis入门程序

一、MyBatis概述
二、入门程序
三、MyBatis事务管理深度剖析
四、总结

框架其实就是对通⽤代码的封装，提前写好了⼀堆接⼝和类，我们可以在做项⽬的时候直接引⼊这些
接⼝和类（引⼊框架），基于这些现有的接⼝和类进⾏开发，可以⼤⼤提⾼开发效率。

一、MyBatis概述

MyBatis本质上就是对JDBC的封装，通过MyBatis完成CRUD。
MyBatis在三层架构中负责持久层的，属于持久层框架。
MyBatis属于半⾃动化ORM框架，需要自己编写SQL语句。
Hibernate属于全⾃动化的ORM框架，不需要自己编写SQL语句。
ORM：对象关系映射
- O（Object）：Java虚拟机中的Java对象
- R（Relational）：关系型数据库
- M（Mapping）：将Java虚拟机中的Java对象映射到数据库表中⼀⾏记录，或是将数据库表中的⼀⾏记录映射成Java虚拟机中的⼀个Java对象。

二、入门程序

1.准备开发环境

（1）准备数据库

# schema.sql 文件
DROP TABLE IF EXISTS `article`;
CREATE TABLE `article`
(
    `id`          int                                                           NOT NULL AUTO_INCREMENT COMMENT '主键',
    `user_id`     int                                                           NOT NULL COMMENT '作者 ID',
    `title`       varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '文章标题',
    `summary`     varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '文章概要',
    `read_count`  int(11) UNSIGNED ZEROFILL                                     NOT NULL COMMENT '阅读读数',
    `create_time` datetime                                                      NOT NULL COMMENT '创建时间',
    `update_time` datetime                                                      NOT NULL COMMENT '最后修改时间',
    PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB
  AUTO_INCREMENT = 1
  CHARACTER SET = utf8mb4
  COLLATE = UTF8MB4_0900_AI_CI
  ROW_FORMAT = Dynamic;


DROP TABLE IF EXISTS `article_detail`;
CREATE TABLE `article_detail`
(
    `id`         int                                                   NOT NULL AUTO_INCREMENT COMMENT '注解',
    `article_id` int                                                   NOT NULL COMMENT '文章 ID',
    `content`    text CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '文章内容',
    PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB
  AUTO_INCREMENT = 1
  CHARACTER SET = utf8mb4
  COLLATE = utf8mb4_0900_ai_ci
  ROW_FORMAT = Dynamic;

# data.sql 文件
-- ----------------------------
-- Records of article
-- ----------------------------
INSERT INTO `article`
VALUES (1, 2021, 'MyBatis概述', 'MyBatis是半自动的ORM框架', 654897, '2024-01-26 03:11:12',
        '2024-02-25 12:11:19');
INSERT INTO `article`
VALUES (2, 2324, 'Spring容器', 'IOC、AOP', 345, '2025-01-19 15:15:57', '2025-02-16 4:19:30');

-- ----------------------------
-- Records of article_detail
-- ----------------------------
INSERT INTO `article_detail`
VALUES (1, 1, 'MyBatis是非常优秀的持久层框架');

（2）创建一个maven项目

可以参考我的博客 ====> IDEA 构建开发环境中的构建一个普通的Maven模块

2.编写代码

（1）打包方式和引入依赖

Maven中央仓库可以寻找自己需要的依赖。

 <!--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.gdb</groupId>
    <artifactId>mybatis-code</artifactId>
    <version>1.0-SNAPSHOT</version>
     <!--打包方式-->
    <packaging>jar</packaging>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!--mybatis核⼼依赖-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.13</version>
        </dependency>
        <!--mysql驱动依赖-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.33</version>
        </dependency>
    </dependencies>
</project>

（2）新建mybatis-config.xml配置⽂件

在resources根⽬录下新建mybatis-config.xml配置⽂件（可以参考mybatis⼿册拷⻉）。

<?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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/使用的数据库名"/>
                <property name="username" value="root"/>
                <property name="password" value="自己的数据库密码!"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <!--sql映射⽂件创建好之后，需要将该⽂件路径配置到这⾥-->
        <mapper resource=""/>
    </mappers>
</configuration>

（3）新建XXXMapper.xml配置⽂件

在resources根⽬录下新建XXXMapper.xml配置⽂件（可以参考mybatis⼿册拷⻉）。

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="article">
    <insert id="insertArticle">
       insert into article values
           (null, 9874, 'JavaWeb', 'Filter', 645133, '2026-05-16 12:15:27', '2026-08-16 4:15:30');
    </insert>
</mapper>

将CarMapper.xml⽂件路径配置到mybatis-config.xml 中

    <mappers>
        <!--sql映射⽂件创建好之后，需要将该⽂件路径配置到这⾥-->
        <mapper resource="articleMapper.xml"/>
    </mappers>

（4）编写测试代码

public class TestMyBatis {
   
    public static void main(String[] args) throws Exception{
   
        //获取 SqlSessionBuilder 对象
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        //获取 SqlSessionFactory 对象，Resources.getResourceAsReader（）默认从类的根路径下加载文件。
        //Resources是MyBatis提供的工具类，源码是 ClassLoder.getSystemClassLoader().getResourceAsStream("类路径下的文件路径");
        SqlSessionFactory sqlSessionFactory = builder.build(Resources.getResourceAsReader("mybatis-config.xml"));
        //获取 SqlSession 对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //执行 SQL 语句
        int count = sqlSession.insert("insertArticle");
        System.out.println("插入的记录条数：====> " + count);
        //MyBatis默认关闭的自动提交机制的
        sqlSession.commit();
        //释放资源
        sqlSession.close();
    }
}

在这里插入图片描述

（5）引入日志

关于mybatis集成日志组件。让我们调试起来更加的方便。
- mybatis常见的集成的日志组件有那些呢？
  - SLF4J(沙拉风)：沙拉风是一个日志标准，其中有一个框架叫做logback，它实现了沙拉风规范。
  - LOG4J
  - LOG4J2
  - STDOUT_LOGGING
  - …
  - 注意：log4j log4j2 logback 都是同一个作者开发的。
- 中STDOUT_LOGGING是标准日志，mybatis已经实现了这种标准日志。mybatis框架本身已经实现了这种标准。只要开启即可。在mybatis-config.xml文件中使用settings标签进行配置开启。这个标签在编写的时候要注意，它应该出现在environments标签之前。注意顺序。
```
    <settings>
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>
```

在这里插入图片描述

（6）MyBatis第⼀个⽐较完整的代码写法

public class TestMyBatis {
   
    public static void main(String[] args) {
   
        SqlSession sqlSession = null;
        try {
   
            // 1.创建SqlSessionFactoryBuilder对象
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
            // 2.创建SqlSessionFactory对象
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder
                    .build(Resources.getResourceAsStream("mybatis-config.xml"));
            // 3.创建SqlSession对象
            sqlSession = sqlSessionFactory.openSession();
            // 4.执⾏SQL
            int count = sqlSession.insert("insertArticle");
            System.out.println("插入了⼏条记录：" + count);
            // 5.提交
            sqlSession.commit();
        } catch (Exception e) {
   
            // 回滚
            if (sqlSession != null) {
   
                sqlSession.rollback();
            }
            e.printStackTrace();
        } finally {
   
            // 6.关闭
            if (sqlSession != null) {
   
                sqlSession.close();
            }
        }
    }
}

（7）MyBatis⼯具类SqlSessionUtil的封装

public class MybatisUtils {
   
	private static SqlSessionFactory sqlSessionFactory;
 	/**
 	* 类加载时初始化sqlSessionFactory对象
 	*/
 	static {
   
 		try {
   
 			SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
 			sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"));
 		} catch (Exception e) {
   
 			e.printStackTrace();
 		}
 	}
 	/**
 	* 每调⽤⼀次openSession()可获取⼀个新的会话，该会话⽀持⾃动提交。
 	*/
 	public static SqlSession openSession() {
   
 		return sqlSessionFactory.openSession(true);
 	}
}

public class TestMyBatis {
   
    public static void main(String[] args) {
   
        SqlSession sqlSession = null;
        try {
   
            sqlSession = MybatisUtils.openSession();
            // 4.执⾏SQL
            int count = sqlSession.insert("insertArticle");
            System.out.println("插入了⼏条记录：" + count);
            // 5.提交
            sqlSession.commit();
        } catch (Exception e) {
   
            // 回滚
            if (sqlSession != null) {
   
                sqlSession.rollback();
            }
            e.printStackTrace();
        } finally {
   
            // 6.关闭
            if (sqlSession != null) {
   
                sqlSession.close();
            }
        }
    }
}

三、MyBatis事务管理深度剖析

在MyBatis-config.xml文件中，可以通过以下的配置进行MyBatis的事务管理。
```
<transactionManager type="JDBC"/>
```
type属性的值有两个（不区分大小写）：
- JDBC(jdbc)：JDBC事务管理器。由MyBatis框架自己管理事务，自己采用原生的JDBC代码去管理事务。默认是开启事务的，需要自己手动的提交。可以通过以下的方式关闭事务：
```
SqlSession sqlSession = sqlSessionFactory.openSession(true);  //关闭事务(自动提交)
```
- MANAGED(manged) ：MANFGED事务管理器。mybatis不再负责事务的管理了。事务交给其他容器来负责。例如：spring.
  - 对于我们当前单纯只有mybatis的情况下，如果设置为MANAGED那么事务这块就没人管了。没有人管理的事务压根就没有开启。

四、总结

Maven中央仓库
MyBatis中文手册
Resources 目录：放在整个目录当中的，一般都是资源文件，配置文件。直接放到Resources 目录下的资源，等同于放到类的根路径下。
以后凡是遇到resource这个单词，大部分情况下，这种加载资源的方式就是从类的根路径下开始加载（开始查找）
MyBatis中的主要对象：
- 在Mybatis当中，负责执行SQL语句的那个对象 ===> SqlSession
  - SqlSession是专门用来执行SQL语句的，是一个Java程序和数据库之间的一次会话。
- 想要获取SqlSession对象，需要先获取SqlSessionFactory对象，通过SqlSessionFactory工厂来生产SqlSession对象。
- 获取SqlSessionFactory对象，需要首先获取SqlSessionFactoryBuilder对象。通过SqlSessionFactoryBuilder对象的build方法，来获取一个SqlSessionFactory对象。
```
SqlSessionFactoryBuilder --> SqlSessionFactory --> SqlSession
```
mybatis中的两个主要的配置文件：
- 其中一个是：mybatis-config.xml，这是核心配置文件，主要配置连接数据库的信息等。(一个)
- 另一个是：XxxxMapper.xml,这个是专门来编写SQL语句的配置文件。(一个表一个)