mybatis源码学习-创建SqlSessionFactory_学习

mybatis源码学习-创建SqlSessionFactory

创始人

2024-06-02 05:18:00

mybatis中文文档

https://mybatis.org/mybatis-3/zh/getting-started.html

在入门目录中，可以看到使用mybatis的简单步骤，据此我写了一个demo，从最基本的操作开始，以debug的方式看下源码，本篇先来关注创建SqlSessionFactory的流程

我画了一下从解析配置文件到创建SqlSessionFactory的简略流程，先把脉络捋清了再扣细节

在这里插入图片描述

一、获取mybatis-config.xml配置文件，Resources.getResourceAsStream()返回bufferedInputStream对象，获取配置文件字节流

在这里插入图片描述

二、进行解析配置文件前的准备工作

创建SqlSessionFactoryBuilder对象

此对象用来解析xml文件

调用build方法

在这里插入图片描述

创建XmIConfigBuilder对象

debug进入XmIConfiaBuilder，依次执行，下面逐步debug进入看一下

在这里插入图片描述

创建XmIMapperEntityResolver

可以看到定义了一些dtd（Document Type Definition）文件，与之相同作用的还有xsd（XML Schema Definition），他们的共同作用是定义文档类型。其实很好理解，大家在写xml或其他文档的时候肯定要写标签，不同标签有不同作用，比如mapper-config.xml中的用于定义数据源，用来定义mapper文件，这些标签和文档结构就是在dtd和之后出现的xsd中定义的

一般情况下dtd和xsd是联网获取的，也就是xml头部的那些链接，但如果是没有联网的情况，mybatis也是支持本地读取的

在这里插入图片描述

创建XPathParser对象

commonConstructor方法里创建了xpath对象，该对象用来解析具体的xml文件

在这里插入图片描述

createDocument生成document对象，个人理解就是把xml文件转成父子节点的实体对象，后面解析的时候就可以把属性值和属性名称获取到了，这块详细过程个人认为不需要了解

在这里插入图片描述

this调用本类构造方法

首先调用父类构造方法，初始化Configuration，这个对象很重要，它保存了所有mybatis的配置信息

同样的，debug执行Configuration构造方法

在这里插入图片描述

进入Configuration类，在看构造方法之前，我们先来看一下该类定义了哪些属性和方法

在这里插入图片描述

这里面有些我们很熟悉的，比如Environment对象，xml中会配置该对象，事务工厂，数据源等等都是environment的属性

在这里插入图片描述

再比如xml setting节点下的一些配置，这些属性含义mybatis官网都有非常详细的解释

在这里插入图片描述

再往下还有几个比较重要的实体类也需要了解一下

在这里插入图片描述

1、mapperRegistry，字面意思叫映射注册器，看这个名字云里雾里，但我们进入这个类看看他的方法，都是getMapper和addMapper，那大概就可以猜测出这个类是对mapper接口进行注册和获取的

在这里插入图片描述

2、interceptorChain，拦截器链，该类内部就是一个拦截器的List

在这里插入图片描述

MyBatis允许我们在已映射语句执行过程中的某一点进行拦截调用，MyBatis允许使用插件来拦截的方法调用包括：

Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed) 拦截执行器的方法
ParameterHandler (getParameterObject, setParameters) 拦截参数的处理
ResultSetHandler (handleResultSets, handleOutputParameters) 拦截结果集的处理
StatementHandler (prepare, parameterize, batch, update, query) 拦截Sql语法构建的处理

在configuration类中分别有四个对应方法调用拦截器链里的拦截器对上述类型进行匹配，比如我们自定义了一个拦截器，指定了type = Executor.class，那就会在newExecutor()中匹配到

在这里插入图片描述

3、typeHandlerRegistry，类型处理器注册类。mybatis会根据java类型和jdbc类型来查找对应的TypeHandler实例，Mybatis的类型转换都需要在这个类进行注册才能实现类型转换

在这里插入图片描述

4、typeAliasRegistry，类型别名注册类，它默认注册了一些基本的类型基本类和包装类，我们可以调用registerAliases来注册其他类的别名

在这里插入图片描述

configuration中的属性还有很多，看完之后我们大概有个印象，后面如果出现configuration.getXXX()，我们能够知道是在哪里声明的

看完configuration中的属性，回到debug线上来，还是this调用configuration构造方法

这里面都是一些在xml中基本的配置项，为了简化xml的配置内容，为这些配置类设置了别名

在这里插入图片描述

举个栗子，配置文件中的JDBC对应的就是上图中的JdbcTransactionFactory

在这里插入图片描述

configuration构造方法走完，回到外层，执行父类构造方法

在这里插入图片描述

这里就看到上面说的configuration的一些get方法了

在这里插入图片描述

继续走完，下面就是一些赋值操作

在这里插入图片描述

到此我们的XMLConfigBuilder就创建完成了，总结一下，XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);这行代码主要做了xml解析前的一些准备工作，包括将配置文件加载到内存中并生成一个document对象，同时初始化Configuration对象