初始MyBatis ,详细步骤运行第一个MyBatis程序,同时对应步骤MyBatis底层剖析

1. 初始MyBatis ,详细步骤运行第一个MyBatis程序,同时对应步骤MyBatis底层剖析

@

目录1. 初始MyBatis ,详细步骤运行第一个MyBatis程序,同时对应步骤MyBatis底层剖析每博一文案2. 前沿知识2.1 框架(framework)2.2 三层架构2.3 分析 JDBC 的缺点3. 初始了解MyBatis4. MyBatis第一个入门程序4.1 MyBatis下载4.2 MyBatis入门程序开发步骤4.3 MyBatis 的第一个入门程序的细节问题5. 关于MyBatis核心配置文件的名字和路径详解6. 关于 mybatis 的事务管理机制(深度剖析)7. MyBatis第一个比较完整的代码写法8. MyBatis 引入日志框架8.1 使用 MyBatis 自带的日志框架8.2 引入 logback 日志框架9. 总结:10. 最后:

每博一文案

才华果然比金钱更耀眼

2. 前沿知识

2.1 框架(framework)

Java当中常见的框架:

SSM三大框架:Spring + SpringMVC + MyBatis

SpringBoot

SpringCloud

......

框架其实就是对通用代码的封装,被提前写好的一大堆接口和类(供你使用),我们可以在做项目的时候直接引入这些接口和类(引入框架),基于这些现有的接口和类进行开发,可以大大提高开发效率。

框架一般都是以jar 包的形式存在。(jar 包中有 class 文件以及各种配置文件等。)

SSM三大框架的学习顺序:MyBatis,Spring,SpringMVC 。因为 MyBatis 框架和后面两个 Spring,SpringMVC 比较的独立开来了,可以先学。

关于Spring 框架的内容,大家感兴趣的可以移步至:✏️✏️✏️ Spring_ChinaRainbowSea的博客-CSDN博客

2.2 三层架构

表示层(直接跟前端进行交互的,一是接受前端 AJAX 请求,二是返回 JSON 数据给前端)

业务逻辑层:一是处理表现层转发过来的前端请求(也就是具体的业务),二是将从持久层获取的数据返回到表示层。

数据访问层:直接操作数据库完成CRUD,并获得数据返回到上一层(也就是业务逻辑层)

Java持久层框架:

关于持久层的框架有如下这些:

MyBatis

Hibernate(实现了JPA规范)

jOOQ

Guzz

Spring Data(实现了JPA 规范)

ActiveJDBC

......

更多关于三层架构的内容,大家可以移步至:✏️✏️✏️ MVC 三层架构案例详细讲解_mvc三层架构-CSDN博客

2.3 分析 JDBC 的缺点

我们先观察,分析如下代码的

示例1:

// ......

// sql语句写死在java程序中

String sql = "insert into t_user(id,idCard,username,password,birth,gender,email,city,street,zipcode,phone,grade) values(?,?,?,?,?,?,?,?,?,?,?,?)";

PreparedStatement ps = conn.prepareStatement(sql);

// 繁琐的赋值:思考一下,这种有规律的代码能不能通过反射机制来做自动化。

ps.setString(1, "1");

ps.setString(2, "123456789");

ps.setString(3, "zhangsan");

ps.setString(4, "123456");

ps.setString(5, "1980-10-11");

ps.setString(6, "男");

ps.setString(7, "zhangsan@126.com");

ps.setString(8, "北京");

ps.setString(9, "大兴区凉水河二街");

ps.setString(10, "1000000");

ps.setString(11, "16398574152");

ps.setString(12, "A");

// 执行SQL

int count = ps.executeUpdate();

// ......

示例2:

// ......

// sql语句写死在java程序中

String sql = "select id,idCard,username,password,birth,gender,email,city,street,zipcode,phone,grade from t_user";

PreparedStatement ps = conn.prepareStatement(sql);

ResultSet rs = ps.executeQuery();

List userList = new ArrayList<>();

// 思考以下循环中的所有代码是否可以使用反射进行自动化封装。

while(rs.next()){

// 获取数据

String id = rs.getString("id");

String idCard = rs.getString("idCard");

String username = rs.getString("username");

String password = rs.getString("password");

String birth = rs.getString("birth");

String gender = rs.getString("gender");

String email = rs.getString("email");

String city = rs.getString("city");

String street = rs.getString("street");

String zipcode = rs.getString("zipcode");

String phone = rs.getString("phone");

String grade = rs.getString("grade");

// 创建对象

User user = new User();

// 给对象属性赋值

user.setId(id);

user.setIdCard(idCard);

user.setUsername(username);

user.setPassword(password);

user.setBirth(birth);

user.setGender(gender);

user.setEmail(email);

user.setCity(city);

user.setStreet(street);

user.setZipcode(zipcode);

user.setPhone(phone);

user.setGrade(grade);

// 添加到集合

userList.add(user);

}

// ......

JDBC的不足点:

SQL语句写牢在了Java程序当中了,不灵活,改SQL的话,就要改Java代码,违背了开闭原则OCP。

给 ? 占位符传值是繁琐的,不能自动化

将结果集封装成Java对象也是比较繁琐的,不能自动化

关于这些自动化的问题,以及OCP开闭原则,运用下面我们正在学习的MyBatis 可以得到一个很好的解决方案。

关于JDBC的更多详细内容,大家可以移步至:✏️✏️✏️ JDBC_ChinaRainbowSea的博客-CSDN博客

3. 初始了解MyBatis

MyBatis 本质上就是对JDBC的封装,通过MyBatis完成CRUD。

MyBatis 在三层架构中负责持久层,属于持久层框架。

MyBatis的发展历程:这里【引用百度百科】

MyBatis本是apache的一个开源项目iBatis,2010年这个项目由apache software foundation迁移到了[google code](https://baike.baidu.com/item/google code/2346604?fromModule=lemma_inlink),并且改名为MyBatis。2013年11月迁移到Github。

iBATIS一词来源于“internet”和“abatis”的组合,是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects(DAOs)。

当前,最新版本是MyBatis 3.5.13,其发布时间是2023年03月11日。

打开MyBatis 代码可以看到它的包结构中包含:ibatis

ORM :对象关系映射。

O (object) :Java虚拟机中的Java对象。

R(Relational):关系型数据库

M(Mapping):将Java虚拟机中的Java对象映射到数据库表中一行记录,或是将数据库表中一行记录映射成Java虚拟机中的一个Java对象。

ORM示图:

MyBatis 框架就是一个ORM框架。

MyBatis可以干啥?

java 对象 < ------ > 数据库表中的一条记录

像User 这样在图中,有特殊的称呼:

有的人把它叫做:pojo(普通Java类)

有的叫做: JavaBean (咖啡豆)

有的叫做: domain(领域模型)

MyBatis 是一个半自动化的ORM,因为MyBatis 框架中SQL语句是需要程序员自己写的。

Hibernate 框架是一个全自动化的ORM 使用Hibenrnate 框架的时候,不需要程序员手动编写SQL语句,SQL语句可以自动生成,所以Hibernate 是一个完全的全自动化的ORM框架。

这里我们的主题是 MyBatis 。

MyBatis 框架特点:

支持定制化SQL,存储过程,基本映射以及高级映射

避免了几乎所有的 JDBC代码中手动设置参数以及获取结果集。

支持XML 开发,也支持注解开发。【为了保证 SQL 语句的灵活,所有MyBatis 大部分采用 XML方式开发。】

将接口和 Java 的 POJOs(Plain Ordinary Java Object ,简单普通的Java对象)映射成数据库中的记录

体积小,好学,两个jar 包,两个 XML 配置文件

完全做到 SQL 解耦合

提供了基本映射标签

提供了高级映射标签

提供了XML标签,支持动态SQL的编写。

4. MyBatis第一个入门程序

4.1 MyBatis下载

从github上下载,地址:https://github.com/mybatis/mybatis-3

将框架以及框架的源码都下载下来,下载框架后解压,打开mybatis目录

通过以上解压可以看到,框架一般都是以jar包的形式存在。我们的mybatis课程使用 maven,所以这个jar我们不需要。

官方手册需要。但是,这个官方文档是英文的,对应英文不好的朋友,大家可以来的这个网站:https://mybatis.net.cn/ 是一个 mybatis 的中文网站。

4.2 MyBatis入门程序开发步骤

首先我们先准备好数据库信息

准备数据库表:汽车表t_car,字段包括:

id:主键(自增)【bigint】

car_num:汽车编号【varchar】

brand:品牌【varchar】

guide_price:厂家指导价【decimal类型,专门为财务数据准备的类型】

produce_time:生产时间【char,年月日即可,10个长度,'2022-10-11'】

car_type:汽车类型(燃油车、电车、氢能源)【varchar】

DROP TABLE IF EXISTS `t_car`;

CREATE TABLE `t_car` (

`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键,和业务没有关系,自增',

`car_num` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '汽车编号',

`brand` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '汽车品牌',

`guide_price` decimal(10, 2) NULL DEFAULT NULL COMMENT '厂商指导价格',

`produce_time` char(10) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '生产日期',

`car_type` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '汽车类型,燃油车,氢能源',

PRIMARY KEY (`id`) USING BTREE

) ENGINE = InnoDB AUTO_INCREMENT = 33 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci ROW_FORMAT = Dynamic;

INSERT INTO `t_car` VALUES (1, '1001', '宝马520Li', 10.00, '2020-10-11', '燃油车');

INSERT INTO `t_car` VALUES (2, '1002', '奔驰E300L', 55.00, '2020-11-11', '新能源');

INSERT INTO `t_car` VALUES (5, '1003', '丰田霸道', 30.00, '2000-10-11', '燃油车');

创建Project:建议创建Empty Project,设置Java版本以及编译版本等。

创建Module:普通的Maven Java模块

第一步:通过maven 在 pom.xml 文件当中引入相关依赖。

mybatis依赖 ,mysql依赖

org.mybatis

mybatis

3.5.10

mysql

mysql-connector-java

8.0.30

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">

4.0.0

com.ranbowsea

mybatis-001-introduction

1.0-SNAPSHOT

jar

17

17

org.mybatis

mybatis

3.5.10

mysql

mysql-connector-java

8.0.30

第二步:在 resources 根(类)目录下新建 mybatis-config.xml(文件名随意)配置文件(可以参考mybatis手册拷贝 (https://mybatis.net.cn/getting-started.html))

注意:

第一,这个文件名不是必须叫 mybatis-config.xml,可以用其他的名字,只是大家都采用这个名字。

这个文件存放的位置也不是固定的,可以随意,但一般情况下,会放到类的根路径下

关于这两点的注意事项,该文章的后面,会详细说明。请继续看下去。

PUBLIC "-//mybatis.org//DTD Config 3.0//EN"

"http://mybatis.org/dtd/mybatis-3-config.dtd">

第三步:编写XxxMapper.xml 文件

在这个配置文件当编写SQL语句。

这个文件名也不是固定的,放的位置也不是固定的,我们这里给它起个名字,叫做:CarMapper.xml (mapper 英文单词是“映射”的意思),把它暂时放到类的根路径下。

在resources根目录下新建CarMapper.xml配置文件(可以参考mybatis手册拷贝)

同时我们在其中编写一条SQL语句,一条insert 插入的SQL语句。

注意编写的是 insert 插入的SQL语句所以,在该 xml 文件中用, 标签进行定义编写。如下:

而在 标签当中,需要定义一个 id 属性的值,该

insert语句,id是这个条SQL语句的唯一标识,这个id就代表了这条SQL语句

insert into t_car(id,car_num,brand,guide_price,produce_time,car_type)

values (null,'1003','丰田霸道',30.0,'2000-10-11','燃油车')

// 因为我们的 id 是主键,自增的,所以可以不赋值。为 null ,让其进行一个自增的效果。

因为我们的 id 是主键,自增的,所以可以不赋值。为 null ,让其进行一个自增的效果。

注意1:sql语句最后结尾可以不写“;”

注意2:CarMapper.xml文件的名字不是固定的。可以使用其它名字。

注意3:CarMapper.xml文件的位置也是随意的。这里选择放在resources根下,相当于放到了类的根路径下。

注意4:将CarMapper.xml文件路径配置到mybatis-config.xml:

PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"

"http://mybatis.org/dtd/mybatis-3-mapper.dtd">

insert into t_car(id,car_num,brand,guide_price,produce_time,car_type)

values (null,'1003','丰田霸道',30.0,'2000-10-11','燃油车')

第四步: 在mybatis-config.xml 文件中指定XxxMapper.xml 文件的路径

就是将我们上面配置的 XxxMapper.xml(这里是 CarMapper.xml) 的SQL语句的映射文件创建好,将该文件所在位置的路径,填入到 当中,让MyBatis 框架可以顺利的找到它,并执行其中的SQL语句。注意:resource 属性会自动从类的根路径下开始查找资源。

注意:resource 属性会自动从类的根路径下开始查找资源。

PUBLIC "-//mybatis.org//DTD Config 3.0//EN"

"http://mybatis.org/dtd/mybatis-3-config.dtd">

第五步: 编写MyBatis 测试程序(使用MyBatis的类库,编写myBatis 程序,该数据库,做增删改查就行了)

首先我们需要知道,在MyBatis 当中,负责执行SQL语句的是哪个对象,同时又该如何获取到该对象。

负责执行 SQL语句的对象是: SqlSession

SqlSession 是专门来执行 SQL语句的,是一个Java程序和数据库之间的一次会话

想要获取到 SqlSession 对象,就需要先获取SqlSessionFactory 对象,通过SqlSessionFactory 工厂的openSession( ) 方法,来生产 SqlSession 对象。

那怎么湖获取SqlSessionFactory 对象

通过SqlSessionFactoryBuilder 对象的 build( ) 方法,来获取一个SqlSessionFactory 对象。

总结:

MyBatis的核心对象包括:

SqlSessionFactoryBuilder

SqlSessionFactory

SqlSession

SqlSessionFactoryBuilder-->SqlSessionFactory-->SqlSession

注意事项:

int count = sqlSession.insert("insertCar"); // 这个"insertCar"必须是sql的id

该insert(id) 就是,我们上面 CarMapper.xml SQL映射文件当中编写的 SQL 语句(这里是 标签当中的 id 的属性值,保持一致)

同时需要:

执行 sqlSession.commit(); 提交数据给数据库(和JDBC是一样的); 提交(mybatis默认采用的事务管理器是JDBC,默认是不提交的,需要手动提交。)

以及执行: sqlSession.close(); 关闭资源,注意:仅仅是关闭资源,并不会提交数据的。

// 5. 提交(mybatis默认采用的事务管理器是JDBC,默认是不提交的,需要手动提交。)

sqlSession.commit();

// 6. 关闭资源(只关闭是不会提交的)

sqlSession.close();

完整执行代码:

import org.apache.ibatis.io.Resources;

import org.apache.ibatis.session.SqlSession;

import org.apache.ibatis.session.SqlSessionFactory;

import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.FileInputStream;

import java.io.IOException;

import java.io.InputStream;

public class MyBatisIntroductionTest {

public static void main(String[] args) {

// 1. 创建SqlSessionFactoryBuilder对象

SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();

// 2. 创建SqlSessionFactory对象

InputStream is = Thread.currentThread().getContextClassLoader().getResourceAsStream("mybatis-config.xml");

SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);

// 3. 创建SqlSession对象

SqlSession sqlSession = sqlSessionFactory.openSession();

// 4. 执行sql

int count = sqlSession.insert("insertCar"); // 这个"insertCar"必须是sql的id

System.out.println("插入几条数据:" + count);

// 5. 提交(mybatis默认采用的事务管理器是JDBC,默认是不提交的,需要手动提交。)

sqlSession.commit();

// 6. 关闭资源(只关闭是不会提交的)

sqlSession.close();

}

}

运行结果:

MyBatis 第一个入门程序小总结:

第一: 在MyBatis中一定是有一个很重要的对象,这个对象是:SqlSessionFactory对象

第二: SqlSessionFactory 对象的创建需要 xml

xml 是什么?它是一个配置文件

MyBatis中有两个主要的配置文件:

mybatis-config.xml ,这是核心配置文件,主要配置连接数据库的信息等(一般是第一个数据库一个),同样的与之对应的通过mybatis-config.xml 的配置文件创建的对象 SqlSessionFactoryBuilder,SqlSessionFactory 也是一个数据库一个对象 。

XxxMapper.xml ,这个是专门用来编写SQL语句的配置文件(一个数据表一个)。

t_user 表,一般会对应一个UserMapper.xml

t_student 表,一般会对应一个StudentMapper.xml

4.3 MyBatis 的第一个入门程序的细节问题

在MyBatis 中的SQ语句的结尾“;” 可以省略的。

在 MyBatis 当中的 SQL语句错误的,异常信息是:java.sql.SQLSyntaxErrorException 该异常表示是你的SQL语句写的不对,SQL语法可能存在问题。

在MyBatis 当中的工具类: Resource.getResourceAsStream( ) 方法。

小技巧:以后凡是遇到 resource 这个单词,大部分情况下,这种加载资源的方式就是从(resource)类路径下开始检索加载的。

例如: 下面三种获取 IO流文件的,检索方式都是从类路径下开始的。

InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

InputStream is = Thread.currentThread().getContextClassLoader().getResourceAsStream("mybatis-config.xml");

InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("mybatis-config.xml"); // 使用类加载器

采用从 (resource)类路径 加载文件的优点:

采用这种方式,从类的路径当种加载资源,项目的移植性很强,项目从Windwos移植到Linux,没有路径上的问题

而下面这个是:从系统的绝对路径开始加载的

InputStream stream = new FileInputStream("E:\\mybatis-config.xml");

采用系统的绝对路径加载文件资源的缺点:

可移植性差,程序不够健壮,可能移植到其他的操作系统当中,导致以上路径无效,比如Linux,因为Linux系统是没有所谓的D盘,C盘之类的说法。所以想要移植到Linux当中运行的话,还需要修改Java代码才行。这样就违背了OCP原则了。

5. 关于MyBatis核心配置文件的名字和路径详解

MyBatis 的核心配置文件就是,我们上述的名为 mybatis-config.xml 的配置文件。

已经验证过了,mybatis 核心配置文件的名字,不一定是:mybatis-config.xml 。mybatis 核心配置文件存放的路径,也不一定是类的根路径,可以放到其他的位置,但是为了项目的移植性。健壮性,最好将这个配置文件放到类路径下面。

同理的对应的 SQL 映射文件 XxxMapper.xml 文件的路径也可以不放在根(类)路径下,不过如果 SQL 映射文件 XxxMapper.xml 文件是根据 系统的绝对路径 来的话,需要用 标签。如下:

重点:注意的是,无论是 MyBatis 的核心配置文件,还是对应的 SQL 映射文件 XxxMapper.xml 文件,如果文件含义目录的话,一定要带上目录才行如下:

源码解析:MyBatis 工具类的:InputStream is = Resources.getResourceAsStream("mybatis-config.xml") 的底层调用的机制。

> InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("mybatis-config.xml")

> ClassLoader.getSystemClassLoader() 获取系统的类加载器。

> 系统类加载器有一个方法叫做:getResourceAsSteam

> 它就是从类路径当中加载资源的

> 通过源代码分析发现:

> InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

> 底层的源代码其实现就是:

> InputStream is = ClasLoader.getSystemClassLoader().getResourceAsStream("mybatis-config.xml");

>

6. 关于 mybatis 的事务管理机制(深度剖析)

关于 mybatis 的事务管理机制:

在mybatis-config.xml 文件中,可以通过以下的配置进行 mybatis 的事务处理。

通过:** ** 标签进行设置即可。

type 的属性值包括两个:

JDBC (jdbc)

MANGED(managed)

type 后面的值,只有以上两个值可以选择,不区分大小写。

在mybatis 中提供了两种事务管理机制。

第一种 JDBC事务管理器

MyBatis 框架自己管理事务,自己采用原生的JDBC 代码去管理事务

> conn.setAutoCommit(false);开启事务,false 是默认的,可以不用写

> ...业务处理...

> conn.commit(); 手动提交事务

使用JDBC事务管理器的话,底层创建的事务管理器对象,jdbcTransaction对象。

如果你编写的代码是下面的代码:

SqlSession sqlSession = sqlSessionFactory.openSession(true);

表示没有开启事务,因为这种方式压根不会执行,com.setAutoCommit(false)

在JDBC事务中,没有执行com.setAutoCommit(false);那么autoCommit就是true.

如果autoCommit 是 true ,就表示没有开启事务,只要执行任意一条DML语句就提交了一次

我们可以进行一个 Debug 调试,进行一个检查

这里我们用默认的 false ,也可以不填,都是 false

SqlSession sqlSession = sqlSessionFactory.openSession();

SqlSession sqlSession = sqlSessionFactory.openSession(false);

下面我们设置为:true

在 JDBC事务管理器 下,SqlSession sqlSession = sqlSessionFactory.openSession( 不填,或者 false); 表示开启事务了(需要自己手动提交,sqlSession.commit()😉,填 true 表示关闭了事务,自动就会提交了

第二种 MANAGED 是事务管理器

在 mybatis 不再负责事务的管理了,事务管理交给其他容器来负责,例如:Spring

MyBatis 说,我不管事务了(会自动提交数据给数据库),你来负责吧(Spring)

如果对于我们当前的单纯的只有 MyBatis 的情况下,如果配置为:MANAGED ,那么事务这块是没人管的,没有人管理事务标识,事务压根没有开启,后面我们可以配合使用Spring 进行事务上的管理。

关于 MyBatis 配合Spring 开启事务的详细内容,大家可以移步至:✏️✏️✏️ Spring6 对 集成MyBatis 开发运用(附有详细的操作步骤)-CSDN博客

7. MyBatis第一个比较完整的代码写法

resources 的配置文件下的信息。

CarMapper.xml SQL 语句的映射文件

PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"

"http://mybatis.org/dtd/mybatis-3-mapper.dtd">

insert into t_car(id,car_num,brand,guide_price,produce_time,car_type)

values (null,'1003','丰田霸道',30.0,'2000-10-11','燃油车');

mybatis-config.xml 的MyBatis 的核心配置文件。

PUBLIC "-//mybatis.org//DTD Config 3.0//EN"

"http://mybatis.org/dtd/mybatis-3-config.dtd">

运行测试程序:

package com.rainbowsea.mybatis.test;

import com.ranbowsea.mybatis.utils.SqlSessionUtil;

import org.apache.ibatis.io.Resources;

import org.apache.ibatis.session.SqlSession;

import org.apache.ibatis.session.SqlSessionFactory;

import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import org.junit.Test;

import java.io.IOException;

public class MyBatisCompleteTest {

public static void main(String[] args) {

// 获取到SqlSessionFactoryBuilder 对象

SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();

SqlSession sqlSession = null;

try {

// 获取到SqlSessionFactoryBuilder 一个数据库对应一个 SqlSessionFactoryBuilder

SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsReader("mybatis-config.xml"));

// 获取到SqlSession对象

sqlSession = sqlSessionFactory.openSession();

sqlSession.insert("insertCar");// 对应 执行SQL语句对应的数据表的 XxxMapper.xml当中,对应SQL语句的id

// 执行到这里,提交事务,终止事务

sqlSession.commit();

} catch (IOException e) {

if(sqlSession != null) { // 上面可能 sqlSession 还是为空

// 回滚事务

sqlSession.rollback();

}

throw new RuntimeException(e);

} finally {

if(sqlSession != null) {

// 关闭会话

sqlSession.close();

}

}

}

}

8. MyBatis 引入日志框架

8.1 使用 MyBatis 自带的日志框架

引入日志框架的目的:是为了看清楚MyBatis执行的具体的 SQL语句,以及赋值内容。

启动MyBatis 自带的标准日志组件,只需要在mybatis-config.xml MyBatis 的核心配置文件中添加配置文件【可参考mybatis 手册https://mybatis.net.cn/logging.html】

关于mybatis 集成日志组件,让我们调试起来更加方便。

mybatis常见的集成的日志组件有哪些呢?

SLF4J(沙拉风)

LOG4J

LOG$J2

STDOUT_LOGGING

...

注意:log4j log4j2 logback都是同一个作者开发的。

其中STDOUT_LOGGING 是标准日志,mybatis已经实现了这种标准日志,mybatis框架本身已经实现了这种

标准。只要开启即可,怎么开启呢?在mybatis-config.xml文件中使用settings标签进行配置开启。

注意:

这个标签在编写的时候要注意,它必须在 environments 标签之前(不然会报错的),注意顺序,当然,不需要记忆这个顺序。

因为有dtd文件进行约束呢。我们只要参考did约束即可

PUBLIC "-//mybatis.org//DTD Config 3.0//EN"

"http://mybatis.org/dtd/mybatis-3-config.dtd">

运行测试:

8.2 引入 logback 日志框架

上述的MyBatis 自带的日志框架,这种实现也是可以的,可以看到一些信息,比如:连接对象什么时候创建,什么时候关闭,sql语句是怎样的

但是没有详细的日期,线程名字,等,如果你想使用更加丰富的配置,可以集成第三方Log组件。

同时配置也不够灵活,我们可以集成其他的日志组件,例如:log4j,logback等。

logback是目前日志框架中性能较好的,较流行的,所以我们选它。

引入logback的步骤:

logback 日志框架实现了slf4j标准(沙拉风,日志门面,日志标准)

第一步: 引入logback的依赖

我们需要在项目的 pom.xml 配置文件当中,引入 logbakc 的依赖,通过 maven 进行导入。

ch.qos.logback

logback-classic

1.2.11

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">

4.0.0

com.ranbowsea

mybatis-001-introduction

1.0-SNAPSHOT

jar

17

17

org.mybatis

mybatis

3.5.10

mysql

mysql-connector-java

8.0.30

junit

junit

4.13.2

test

ch.qos.logback

logback-classic

1.2.11

第二步:如logback所必须的 xml 配置文件

注意:这个配置文件的名字必须叫做:logback.xml 或者 logback-test.xml 不能是其他的名字

并且这个配置文件必须放到类的根路径下,不能是其他位置。

%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n

${LOG_HOME}/TestWeb.log.%d{yyyy-MM-dd}.log

30

%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n

100MB

%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n

配置好以后,我们运行看看。

package com.rainbowsea.mybatis.test;

import com.ranbowsea.mybatis.utils.SqlSessionUtil;

import org.apache.ibatis.io.Resources;

import org.apache.ibatis.session.SqlSession;

import org.apache.ibatis.session.SqlSessionFactory;

import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import org.junit.Test;

import java.io.IOException;

public class MyBatisCompleteTest {

public static void main(String[] args) {

// 获取到SqlSessionFactoryBuilder 对象

SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();

SqlSession sqlSession = null;

try {

// 获取到SqlSessionFactoryBuilder 一个数据库对应一个 SqlSessionFactoryBuilder

SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsReader("mybatis-config.xml"));

// 获取到SqlSession对象

sqlSession = sqlSessionFactory.openSession();

sqlSession.insert("insertCar");// 对应 执行SQL语句对应的数据表的 XxxMapper.xml当中,对应SQL语句的id

// 执行到这里,提交事务,终止事务

sqlSession.commit();

} catch (IOException e) {

if(sqlSession != null) { // 上面可能 sqlSession 还是为空

// 回滚事务

sqlSession.rollback();

}

throw new RuntimeException(e);

} finally {

if(sqlSession != null) {

// 关闭会话

sqlSession.close();

}

}

}

}

9. 总结:

MyBatis 本质上就是对JDBC的封装,通过MyBatis完成CRUD。MyBatis 在三层架构中负责持久层,属于持久层框架。

MyBatis 的包目录,路径是 ibatis 。不是 mybatis 。这一点需要注意清楚明白。

mybatis 核心配置文件的名字,不一定是:mybatis-config.xml 。mybatis 核心配置文件存放的路径,也不一定是类的根路径,可以放到其他的位置,但是为了项目的移植性。健壮性,最好将这个配置文件放到类路径下面。

MyBatis 的SQL 映射文件XxxMapper.xml 和MyBatis 的核心配置文件, mybatis-config.xml 都尽量放到类(resources) 根路径下 ,为了项目的移植性。健壮性,最好将这个配置文件放到类路径下面。

小技巧:以后凡是遇到 resource 这个单词,大部分情况下,这种加载资源的方式就是从(resource)类路径下开始检索加载的。

例如: 下面三种获取 IO流文件的,检索方式都是从类路径下开始的。

InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

InputStream is = Thread.currentThread().getContextClassLoader().getResourceAsStream("mybatis-config.xml");

InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("mybatis-config.xml"); // 使用类加载器

在mybatis 中提供了两种事务管理机制

第一种 JDBC事务管理器

MyBatis 框架自己管理事务,自己采用原生的JDBC 代码去管理事务

> conn.setAutoCommit(false);开启事务,false 是默认的,可以不用写

> ...业务处理...

> conn.commit(); 手动提交事务

使用JDBC事务管理器的话,底层创建的事务管理器对象,jdbcTransaction对象。

在 JDBC事务管理器 下,SqlSession sqlSession = sqlSessionFactory.openSession( 不填,或者 false); 表示开启事务了(需要自己手动提交,sqlSession.commit()😉,填 true 表示关闭了事务,自动就会提交了

第二种 MANAGED 是事务管理器

在 mybatis 不再负责事务的管理了,事务管理交给其他容器来负责,例如:Spring 。

如果对于我们当前的单纯的只有 MyBatis 的情况下,如果配置为:MANAGED ,那么事务这块是没人管的,没有人管理事务标识,事务压根没有开启,后面我们可以配合使用Spring 进行事务上的管理。

引入日志框架的目的:是为了看清楚MyBatis执行的具体的 SQL语句,以及赋值内容。

启动MyBatis 自带的标准日志组件,只需要在mybatis-config.xml MyBatis 的核心配置文件中添加配置文件

setting 这个标签在编写的时候要注意,它必须在 environments 标签之前(不然会报错的),注意顺序,当然,不需要记忆这个顺序。

引入 logback 日志框架。导入的依赖

ch.qos.logback

logback-classic

1.2.11

如logback所必须的 xml 配置文件**

注意:这个配置文件的名字必须叫做:logback.xml 或者 logback-test.xml 不能是其他的名字

并且这个配置文件必须放到类的根路径下,不能是其他位置。

10. 最后:

“在这个最后的篇章中,我要表达我对每一位读者的感激之情。你们的关注和回复是我创作的动力源泉,我从你们身上吸取了无尽的灵感与勇气。我会将你们的鼓励留在心底,继续在其他的领域奋斗。感谢你们,我们总会在某个时刻再次相遇。”