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
// 思考以下循环中的所有代码是否可以使用反射进行自动化封装。
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依赖
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">
第二步:在 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 文件中用,
而在
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语句的映射文件创建好,将该文件所在位置的路径,填入到
注意: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 语句(这里是
同时需要:
执行 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 进行导入。
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">
第二步:如logback所必须的 xml 配置文件
注意:这个配置文件的名字必须叫做:logback.xml 或者 logback-test.xml 不能是其他的名字
并且这个配置文件必须放到类的根路径下,不能是其他位置。
配置好以后,我们运行看看。
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 日志框架。导入的依赖
如logback所必须的 xml 配置文件**
注意:这个配置文件的名字必须叫做:logback.xml 或者 logback-test.xml 不能是其他的名字
并且这个配置文件必须放到类的根路径下,不能是其他位置。
10. 最后:
“在这个最后的篇章中,我要表达我对每一位读者的感激之情。你们的关注和回复是我创作的动力源泉,我从你们身上吸取了无尽的灵感与勇气。我会将你们的鼓励留在心底,继续在其他的领域奋斗。感谢你们,我们总会在某个时刻再次相遇。”