mybatis中文文档
https://mybatis.org/mybatis-3/zh/getting-started.html
在入门目录中,可以看到使用mybatis的简单步骤,据此我写了一个demo,从最基本的操作开始,以debug的方式看下源码,本篇先来关注创建SqlSessionFactory的流程
我画了一下从解析配置文件到创建SqlSessionFactory的简略流程,先把脉络捋清了再扣细节
此对象用来解析xml文件
调用build方法
debug进入XmIConfiaBuilder,依次执行,下面逐步debug进入看一下
可以看到定义了一些dtd(Document Type Definition)文件,与之相同作用的还有xsd(XML Schema Definition),他们的共同作用是定义文档类型。其实很好理解,大家在写xml或其他文档的时候肯定要写标签,不同标签有不同作用,比如mapper-config.xml中的用于定义数据源,用来定义mapper文件,这些标签和文档结构就是在dtd和之后出现的xsd中定义的
一般情况下dtd和xsd是联网获取的,也就是xml头部的那些链接,但如果是没有联网的情况,mybatis也是支持本地读取的
commonConstructor方法里创建了xpath对象,该对象用来解析具体的xml文件
createDocument生成document对象,个人理解就是把xml文件转成父子节点的实体对象,后面解析的时候就可以把属性值和属性名称获取到了,这块详细过程个人认为不需要了解
首先调用父类构造方法,初始化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对象
创建SqlSessionFactoryBuilder的第二步,就是解析配置文件
debug进入configuration的parse方法
判断是否被解析过,并设置解析标志位后,进入关键方法parseConfiguration,在mybatis-config.xml配置文件中查找节点,并开始解析
parseConfiguration会对下的所有element进行解析,并找到dao和mapper文件,记录sql语句,详细过程就不细讲了
该过程走完后,SqlSessionFactory就创建完成了,下一步就要开始处理数据库操作了,包括进行数据源的配置,数据源的管理等