该篇正式开始学习mybatis的源码，本篇主要学习mybatis是如何加载配置文件mybatis-config.xml的， 先从测试代码入手。
public class V1Test { public static void main(String[] args) { try (InputStream is = Resources.getResourceAsStream("mybatis-config.xml")) { SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is); SqlSession sqlSession = sqlSessionFactory.openSession(true); FemaleMapper femaleMapper = sqlSession.getMapper(FemaleMapper.class); Female female = femaleMapper.getFemaleById(1); System.out.println(female); } catch (Exception e) { e.printStackTrace(); } } }
1. 加载mybatis配置文件mybatis-config.xml
InputStream is = Resources.getResourceAsStream("mybatis-config.xml")
很显然， 这句代码就是在加载mybatis-config.xml文件，mybatis框架封装了一个Resources类，通过它将xml文件解析成了BufferedInputStream流。
2. 生成SqlSessionFactory 实例
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
看代码就知道 ，创建了一个SqlSessionFactoryBuilder实例，然后通过这个实例去构建一个SqlSessionFactory实例
SqlSessionFactoryBuilder实注解上面有这样一句“Builds {@link SqlSession} instances.” ，说明它与SqlSession是有个关系的。当然，我们主要是看它的build()方法，很容易看到下面这段代码。
public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) { try { XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties); // 解析mybatis-config.xml文件 return build(parser.parse()); } catch (Exception e) { throw ExceptionFactory.wrapException("Error building SqlSession.", e); } finally { ErrorContext.instance().reset(); try { inputStream.close(); } catch (IOException e) { // Intentionally ignore. Prefer previous error. } } }
接着parser.parse() 干的事
public Configuration parse() { if (parsed) { throw new BuilderException("Each XMLConfigBuilder can only be used once."); } parsed = true; parseConfiguration(parser.evalNode("/configuration")); return configuration; }
（1） parser.evalNode("/configuration") 解析获取到 mybatis-config.xml文件中configuration节点（底层其实是用的Xpath解析的）。
（2）parseConfiguration（configuration） 解析configuration节点里面的内容 ，源码代码如下
private void parseConfiguration(XNode root) { try { //issue #117 read properties first propertiesElement(root.evalNode("properties")); Properties settings = settingsAsProperties(root.evalNode("settings")); loadCustomVfs(settings); loadCustomLogImpl(settings); typeAliasesElement(root.evalNode("typeAliases")); pluginElement(root.evalNode("plugins")); objectFactoryElement(root.evalNode("objectFactory")); objectWrapperFactoryElement(root.evalNode("objectWrapperFactory")); reflectorFactoryElement(root.evalNode("reflectorFactory")); settingsElement(settings); // read it after objectFactory and objectWrapperFactory issue #631 environmentsElement(root.evalNode("environments")); databaseIdProviderElement(root.evalNode("databaseIdProvider")); typeHandlerElement(root.evalNode("typeHandlers")); mapperElement(root.evalNode("mappers")); } catch (Exception e) { throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e); } }
再对比一下项目中的mybatis-config.xml文件，就很容易理解parseConfiguration(XNode configration) 方法中每行代码的意思了。
下面，我们重点分析 mapperElement(root.evalNode("mappers")) 这句代码，很明显它就是解析configuration节点下面的mappers节点的内容，下图的红框节点。
进入XMLConfigBuilder#mapperElement(), 咱们可以debug看一下具体情况，
哈哈，是不是跟上面加载mybatis-config.xml一样一样的，通过类加载器去加载xml文件，然后又构造了一个XMLMapperBuilder对象去解析这个xml文件流。
不过， 与前面解析mybatis-config.xml文件不同， 前面解析mybatis-config.xml文件是为了获取configuration节点下面的子节点; 而此处解析mapper节点，又干啥了呢，咱们接着往下看代码， 进入mapperParser.parse()即可。
public void parse() { if (!configuration.isResourceLoaded(resource)) { configurationElement(parser.evalNode("/mapper")); configuration.addLoadedResource(resource); bindMapperForNamespace(); } parsePendingResultMaps(); parsePendingCacheRefs(); parsePendingStatements(); }
parse()方法就是解析具体mapper.xml文件，里面的每一个方法都很重要。
（1） configurationElement(parser.evalNode("/mapper"))
解析mapper节点内容 ， 源码如下
private void configurationElement(XNode context) { try { String namespace = context.getStringAttribute("namespace"); if (namespace == null || namespace.equals("")) { throw new BuilderException("Mapper's namespace cannot be empty"); } builderAssistant.setCurrentNamespace(namespace); cacheRefElement(context.evalNode("cache-ref")); cacheElement(context.evalNode("cache")); parameterMapElement(context.evalNodes("/mapper/parameterMap")); resultMapElements(context.evalNodes("/mapper/resultMap")); sqlElement(context.evalNodes("/mapper/sql")); buildStatementFromContext(context.evalNodes("select|insert|update|delete")); } catch (Exception e) { throw new BuilderException("Error parsing Mapper XML. The XML location is '" + resource + "'. Cause: " + e, e); } }
上面的代码很容易理解，就是对具体的节点进行解析，处理。
我们主要看 buildStatementFromContext(context.evalNodes("select|insert|update|delete"))， 这行代码就是对 CRUD的解析。
debug走起。。。。。。
因为我们的FemaleMapper.xml只有select操作，所以这里的list也只有一个元素。
接下来就是对select语句的具体操作了，具体可见XMLStatementBuilder#parseStatementNode() 方法
这段解析操作超级复杂，比如解析sql的入参类型，返回值类型，构造该sql的id（namespace+id），还有诸如是否使用cache，sql拼接等。。。
不过，这所有的一切都会封装在一个MappedStatement对象中，而这个MappedStatement 缓存在Configuration类上的名为mappedStatements的Map<String, MappedStatement>中，该mappedStatements的key就是namespace+id, value就是MappedStatement对象。
下面debug看一下
请注意， 这个mappedStatements仅仅只是Configuration的一个属性呀！
至此，XMLMapperBuilder#parse()方法内的 configurationElement(parser.evalNode("/mapper"))就说完了， 它主要是解析mapper.xml的文件中的mapper节点及其子节点内容，
并且将解析完的内容封装到一个MappedStatement对象上。
（2）configuration.addLoadedResource(resource)
这句代码简单，就是将FemaleMapper.xml缓存到Configuration类中的loadedResources属性中， loadedResources是一个HashSet
(3) bindMapperForNamespace()
该方法中主要完成了两件事，第1是通过namespace找到对应的mapper接口类，第2是将找到的mapper接口缓存到Configuration上。
我们主要是看看addMapper(boundType)方法， 这里mybatis并不是像常规缓存那样，直接用个Map去存储起来。在这儿，mybatis又引入了一个MapperRegistry类,Configuration持有一个MapperRegistry实例，而mapper接口是缓存在MapperRegistry类中一个名为knownMappers的HashMap中，而且，缓存的也不是Mapper接口对象，而是该Mapper接口类对应的代理工厂类。
代码如下：
这个MapperProxyFactory类很重写，我们在调用FemaleMapper#getFemaleById(id)方法时，就是靠这个类生成代理对象，不然，FemaleMapper单单一个接口，毛用没有！
上面这一波操作完之后，我们就再次回来下面这段代码了，parser.parse()的全部逻辑就跑完了，返回一个Configuration实例。
public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) { try { XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties); // 解析mybatis-config.xml文件 return build(parser.parse()); } catch (Exception e) { throw ExceptionFactory.wrapException("Error building SqlSession.", e); } finally { ErrorContext.instance().reset(); try { inputStream.close(); } catch (IOException e) { // Intentionally ignore. Prefer previous error. } } }
build(parser.parse()) 就相当于 build(configuration)返回 SqlSessionFactory， 源码如下：
public SqlSessionFactory build(Configuration config) { return new DefaultSqlSessionFactory(config); }
而DefaultSqlSessionFactory主要就是与数据库打交道了， 咱们下次再说。
最后，总结一下：
1. MyBatis 通过 Resources类去读取xml配置文件，底层是是通classLoader来实现的
2. 具体解析xml文件是通过 XMLConfigBuilder类，底层是通过Xpath来实现的
3. 通过XMLMapperBuilder类来解析XxxMapper.xml配置文件中mapper节点及其子节点
4. 通过MappedStatement封装mapper节点及其子节点的内容，同时将MappedStatement对象缓存到Configuration对象中
5. 通过MapperRegistry缓存mapper接口对应的MapperProxyFactory
6. 总之，Mybatis将xml内容解析出来，通过Configuration类进行了封装
7. 最后SqlSessionFactory通过解析出来的Configuration来创建SqlSession对象 ，最终操作数据库。
8. 大体流程如下图
