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中央仓库可以寻找自己需要的依赖。

 

<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.0modelVersion>

    <groupId>com.gdbgroupId>
    <artifactId>mybatis-codeartifactId>
    <version>1.0-SNAPSHOTversion>
     
    <packaging>jarpackaging>

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

    <dependencies>
        
        <dependency>
            <groupId>org.mybatisgroupId>
            <artifactId>mybatisartifactId>
            <version>3.5.13version>
        dependency>
        
        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>8.0.33version>
        dependency>
    dependencies>
project>

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

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

  
  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>
          
          <mapper resource=""/>
      mappers>
  configuration>
  

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

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

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>
        
        <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语句的配置文件。(一个表一个)

---