Mybatis 系列2

Posted 一只阿木木

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Mybatis 系列2相关的知识,希望对你有一定的参考价值。

 

上篇文章 写了一个Demo简单体现了一下Mybatis的流程。本次,将简单介绍一下Mybatis的配置文件:

上次例子中,我们以 SqlSessionFactoryBuilder 去创建 SqlSessionFactory,

那么,我们就先从SqlSessionFactoryBuilder入手, 咱们先看看源码是怎么实现的:

SqlSessionFactoryBuilder源码片段:

 1 public class SqlSessionFactoryBuilder {
 2  2 
 3  3   //Reader读取mybatis配置文件,传入构造方法
 4  4   //除了Reader外,其实还有对应的inputStream作为参数的构造方法,
 5  5   //这也体现了mybatis配置的灵活性
 6  6   public SqlSessionFactory build(Reader reader) {
 7  7     return build(reader, null, null);
 8  8   }
 9  9 
10 10   public SqlSessionFactory build(Reader reader, String environment) {
11 11     return build(reader, environment, null);
12 12   }
13 13   
14 14   //mybatis配置文件 + properties, 此时mybatis配置文件中可以不配置properties,也能使用${}形式
15 15   public SqlSessionFactory build(Reader reader, Properties properties) {
16 16     return build(reader, null, properties);
17 17   }
18 18   
19 19   //通过XMLConfigBuilder解析mybatis配置,然后创建SqlSessionFactory对象
20 20   public SqlSessionFactory build(Reader reader, String environment, Properties properties) {
21 21     try {
22 22       XMLConfigBuilder parser = new XMLConfigBuilder(reader, environment, properties);
23 23       //下面看看这个方法的源码
24 24       return build(parser.parse());
25 25     } catch (Exception e) {
26 26       throw ExceptionFactory.wrapException("Error building SqlSession.", e);
27 27     } finally {
28 28       ErrorContext.instance().reset();
29 29       try {
30 30         reader.close();
31 31       } catch (IOException e) {
32 32         // Intentionally ignore. Prefer previous error.
33 33       }
34 34     }
35 35   }
36 36 
37 37   public SqlSessionFactory build(Configuration config) {
38 38     return new DefaultSqlSessionFactory(config);
39 39   }
40 40 
41 41 }

 

通过源码,我们可以看到SqlSessionFactoryBuilder 通过XMLConfigBuilder 去解析我们传入的mybatis的配置文件, 下面就接着看看 XMLConfigBuilder 部分源码:

 

 1  /**
 2  2  * mybatis 配置文件解析
 3  3  */
 4  4 public class XMLConfigBuilder extends BaseBuilder {
 5  5   public XMLConfigBuilder(InputStream inputStream, String environment, Properties props) {
 6  6     this(new XPathParser(inputStream, true, props, new XMLMapperEntityResolver()), environment, props);
 7  7   }
 8  8 
 9  9   private XMLConfigBuilder(XPathParser parser, String environment, Properties props) {
10 10     super(new Configuration());
11 11     ErrorContext.instance().resource("SQL Mapper Configuration");
12 12     this.configuration.setVariables(props);
13 13     this.parsed = false;
14 14     this.environment = environment;
15 15     this.parser = parser;
16 16   }
17 17   
18 18   //外部调用此方法对mybatis配置文件进行解析
19 19   public Configuration parse() {
20 20     if (parsed) {
21 21       throw new BuilderException("Each XMLConfigBuilder can only be used once.");
22 22     }
23 23     parsed = true;
24 24     //从根节点configuration
25 25     parseConfiguration(parser.evalNode("/configuration"));
26 26     return configuration;
27 27   }
28 28 
29 29   //此方法就是解析configuration节点下的子节点
30 30   //由此也可看出,我们在configuration下面能配置的节点为以下10个节点
31 31   private void parseConfiguration(XNode root) {
32 32     try {
33 33       propertiesElement(root.evalNode("properties")); //issue #117 read properties first
34 34       typeAliasesElement(root.evalNode("typeAliases"));
35 35       pluginElement(root.evalNode("plugins"));
36 36       objectFactoryElement(root.evalNode("objectFactory"));
37 37       objectWrapperFactoryElement(root.evalNode("objectWrapperFactory"));
38 38       settingsElement(root.evalNode("settings"));
39 39       environmentsElement(root.evalNode("environments")); // read it after objectFactory and objectWrapperFactory issue #631
40 40       databaseIdProviderElement(root.evalNode("databaseIdProvider"));
41 41       typeHandlerElement(root.evalNode("typeHandlers"));
42 42       mapperElement(root.evalNode("mappers"));
43 43     } catch (Exception e) {
44 44       throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);
45 45     }
46 46   }
47 47 }

 

通过以上源码,我们就能看出,在mybatis的配置文件中:

  1. configuration节点为根节点。
  2. 在configuration节点之下,我们可以配置10个子节点, 分别为:properties、typeAliases、plugins、objectFactory、objectWrapperFactory、settings、environments、databaseIdProvider、typeHandlers、mappers。

本篇文章就先只介绍这些内容,接下来的文章将依次分析解析这个10个节点中比较重要的几个节点的源码,看看在解析这些节点的时候,到底做了些什么。

 

以上是关于Mybatis 系列2的主要内容,如果未能解决你的问题,请参考以下文章

mybatis基础系列——mybatis入门

MyBatis系列01之快速入门

markdown [mybatis参考]关于mybatis #mybatis的一些片段

MyBatis高级特性

Spring Boot demo系列:MyBatis Plus Generator代码生成

MyBatis系列目录--5. MyBatis一级缓存和二级缓存(redis实现)